Skip to content

Features

Nametags and TAB

Show each player's rank above the head and in the TAB list, sorted by rank, using scoreboard teams without entities or NMS.

The nametags module draws the rank prefix, suffix and name color above each player's head and in the TAB list, and sorts the TAB by rank. It only uses scoreboard teams: no invisible entities, armor stands or NMS packets.

Configuration

The module has no commands: its appearance comes from the ranks module.

What you seeWhere it comes from
Prefix/access rank set <rank> prefix <text>
Suffix/access rank set <rank> suffix <text>
Name color/access rank set <rank> color <color> or the personal /color
TAB positionRank weight and STAFF type

Settings (sort-tab, hide-vanished, separators, refresh-seconds) are under modules.nametags in config.yml. See Module switches.

How it works

  • A scoreboard of its own is assigned to players on the main scoreboard, so vanilla /team and other plugins' teams are untouched.
  • Players that look the same share one team; empty teams are removed.
  • TAB order: staff first, then higher weight, then name.
  • Rank changes on other servers arrive through the ranks module events; updates are batched every 2 ticks.

Versions

VersionPrefix/suffixName color
1.8 – 1.12Up to 16 characters eachAppended to the prefix
1.13 – 26.xUp to 64 charactersTeam color

The team color only supports the 16 classic colors: an RGB rank color is approximated in the name, while prefix and suffix keep RGB on 1.16+.

Vanish and staff mode

With hide-vanished: true the nametag is hidden while vanished; staff mode also hides it. Other plugins can hide it with NametagService.hide(uuid, reason).