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 see | Where 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 position | Rank 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
/teamand 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
| Version | Prefix/suffix | Name color |
|---|---|---|
| 1.8 – 1.12 | Up to 16 characters each | Appended to the prefix |
| 1.13 – 26.x | Up to 64 characters | Team 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).