Getting started
On this page6 sections
1. Install
| Server | Paper, Purpur or Folia 1.21.11+ (Java 21; 26.x needs Java 25). Spigot is not supported |
| Required | PacketEvents (opens in a new tab) 2.14+ |
| Optional | LuckPerms (templates by group, instant updates), PlaceholderAPI, MiniPlaceholders, Floodgate |
Drop AdvancedNametags.jar and PacketEvents into plugins/ and start the server. Every player
now has a modern nametag: their name, floating, without the grey box. The console confirms it with
Enabled with N template(s), storage: YAML, hooks: ...; any configuration problem is listed right
below that line.
2. The files
plugins/AdvancedNametags/
├── config.yml global look, animations, menu, visibility, performance, storage
├── nametags.yml your templates (designs)
├── templates/
│ ├── ranks.yml 40 ready-made rank templates (by LuckPerms group)
│ └── showcase.yml 20 complete designs to copy from (top-*)
├── badges.yml 44 badges (OWNER, MVP++, YOUTUBE...) and your own
├── animations.yml your motions, reactions, transitions and colour presets
├── badges/ PNGs for image badges (create it when you need it)
├── lang/ messages (en and es; the language you choose is copied here)
├── data/ player customisations (players/), badge texture cache
└── guide/ this guide, for the installed versionEvery change applies with /nametag reload. Problems are reported in chat and the console with
the file and the exact path.
3. Give your ranks their look
The rank presets in templates/ranks.yml apply to LuckPerms groups with the usual names
(owner, admin, mod, helper, vip, vipplus, mvp, youtube...). If your groups have
those names, you are already done. Otherwise edit groups::
vip:
priority: 80
groups: [vip, donator] # your group names
lines:
- "<badge:vip> <#55FF55>{player}"Give the badge to the group too, so <badge> also works in your default template and in TAB:
/lp group vip permission set advancednametags.badge.vip4. Look at it
Your own nametag shows in third person: press F5 to look at it.
/nametag try top-founder a showcase design on you for 10 seconds
/nametag gallery every template as a button
/nametag self off hide your own nametag (on to show it again)/nametag opens the player menu: badge, style, movement and visibility.
5. Make your own
Start from the closest design in templates/showcase.yml, copy it into nametags.yml with a new
id, then change it:
- Templates — who gets what, every line and style option
- Text, placeholders and icons — what you can write in a line
- Animations — movement and colour effects, step by step
- Badges — design your own rank badges
Or design it in game: /nametag edit <you>, then Copy as YAML.
6. Before going live
- Keep
display.see-through: falseand considervisibility.through-walls: hideon PvP servers (nametags do not reveal players behind walls). - Check
/nametag debugwith players online: packets and bandwidth per player (performance tuning). - Networks:
storage.type: mysqlshares player customisations between servers (MySQL and MariaDB). - Coming from UnlimitedNametags:
/nametag import unt. - Every option is listed in the configuration reference; if something looks wrong, see troubleshooting.