Menus, commands and permissions
On this page5 sections
The player menu — /nametag
On Minecraft 1.21.6+ /nametag opens a native menu (a dialog: no inventory GUI, no resource
pack). Older clients and Bedrock players get the clickable help instead; everything in the menu
also exists as a command.
| In the menu | Who sees it |
|---|---|
| Your nametag, as other players see it | everyone |
| Badge: one of the badges you own, automatic or none | players who own a badge |
| Style: one of the templates you qualify for, or automatic | menu.styles: true and 2+ templates available |
| Movement: a motion for your nametag, template default or still | motions of menu.motions you have advancednametags.motion.<name> for |
| See your own nametag (F5) / see other players' nametags | advancednametags.self / .others |
| Try styles... — the gallery | players with 2+ styles, admins |
| Edit a player, Badges, Reload | admins |
Save applies the changes; an action-bar tick and a click sound confirm it. The menu only accepts the options it offered, so a modified client cannot pick a badge or style it does not own.
The gallery (/nametag gallery) lists templates as buttons; clicking one shows it on your
own nametag for 10 seconds, visible in third person (F5) while it lasts. Players see the templates
they qualify for in their world; admins see every template, including the top-* showcase.
Configuring what players can change — config.yml
menu:
styles: true
motions: [gentle, float, breathe, sway, levitate, heartbeat]Each motion also needs its permission, so you can sell them as perks:
/lp group vip permission set advancednametags.motion.float
/lp group mvp permission set advancednametags.motion.*The editor — /nametag edit <player> (admins)
For an online player: template selector (automatic or a forced template), a text box with the lines (one per row, MiniMessage), sliders for scale (0.25–3) and height (-1 to 2 blocks), a background field, the badge and a hide toggle. Save stores the changes for that player only. Lines left exactly as the template has them keep following the template (its frames, conditions and effects); edited lines replace it.
Copy as YAML puts the player's current design in chat as a template named <player>-design;
click the message to copy it, then paste it under templates: in nametags.yml and set its
priority and groups. It copies the texts (and frames, item and block rows), the nametag's motion
and the player's own offset, scale and background; line options such as show-if, refresh-ticks
or line styles are not included.
Reset removes every customisation of that player (with a confirmation).
Commands
The command is /nametag, with the aliases /nt and /nametags. Arguments have suggestions
(badge suggestions draw the badge). <player> is an exact name: online, or for info, set,
unset, reset and react also a player the server has seen before.
Everyone
| Command | Does |
|---|---|
/nametag or /nametag menu | the menu (the help on clients older than 1.21.6) |
/nametag help | clickable help; admins also get the admin commands |
/nametag badge <id|auto|none> | choose the badge <badge> shows; only badges you own |
/nametag badges | the badge menu (a list in chat on old clients and the console) |
/nametag style <template|auto> | choose one of the templates you qualify for (needs menu.styles: true) |
/nametag motion <name|auto|none> | your nametag's movement: one of menu.motions you have the permission for, auto (the template's) or none (still) |
/nametag gallery | try templates on yourself (needs a 1.21.6+ client) |
/nametag try <template> | show a template on yourself for 10 seconds; templates you qualify for (admins: any) |
/nametag self [on|off] | see your own nametag in third person; without an argument it toggles. Alias: /nametag toggle. Needs advancednametags.self |
/nametag others [on|off] | see other players' nametags; toggles without an argument. Needs advancednametags.others |
Admins (advancednametags.admin)
| Command | Does |
|---|---|
/nametag edit <player> | the editor (online player; your client needs 1.21.6+) |
/nametag menu <player> | open the player menu for someone (from NPCs, other plugins or the console) |
/nametag info <player> | applied template (or the forced one if offline), visible/hidden, each line and every customisation |
/nametag set <player> template <id|auto> | force a template, ignoring permissions and worlds; auto gives the choice back to the priorities |
/nametag set <player> line <n> <text> | replace line n (1–32) with a text; n = number of lines + 1 adds a line (up to performance.max-lines). The first edit starts from the lines shown now. A custom line replaces the template's text and show-if, keeps its look, and turns an item row into text |
/nametag set <player> offset <-8..8> | extra height in blocks, added to the template's offset |
/nametag set <player> scale <0.05..16> | size of every line |
/nametag set <player> background <value> | any background, e.g. #A0201030 |
/nametag set <player> animation <spec> | the text effect of bare <anim> tags for this player (warns if no line has one) |
/nametag set <player> badge <id|auto|none> | the badge <badge> shows; a badge they do not own is skipped |
/nametag set <player> hidden true|false | hide their nametag (saved) |
/nametag unset <player> template|lines|offset|scale|background|animation|hidden|badge | undo one customisation |
/nametag unset <player> line <n> | remove line n from their custom lines (the last line cannot be removed: use unset lines) |
/nametag reset <player> | undo every customisation above; the player's own style, movement and view choices are kept |
/nametag react <player> <reaction> | play a reaction now, e.g. celebrate or bounce:ticks=20 |
/nametag badges generate [id] | upload missing badge textures to MineSkin (all badges, or one) |
/nametag badges preview <id> | show a badge on your nametag for 10 seconds |
/nametag templates | every template by priority, with its line count and who gets it |
/nametag animations [spec] | list effect types and presets; with a spec, show it on your name for 10 seconds (/nametag animations wave speed=2 #ff5f6d #ffc371) |
/nametag import unt [confirm] | migrate from UnlimitedNametags: preview, then import |
/nametag import yaml [confirm] | copy YAML player data into MySQL/MariaDB after switching storage |
/nametag debug | live counters: nametags, viewers, packets, bandwidth (read them) |
/nametag debug report | writes debug-report.txt (versions, plugins, client versions, settings, recent errors; no passwords or keys); click the message to copy it |
/nametag reload | reload every file and list the problems found |
Everything a command changes is saved in the player's profile (YAML or database) and survives restarts, except previews.
Permissions
| Permission | Default | Grants |
|---|---|---|
advancednametags.self | everyone | /nametag self and the menu toggle |
advancednametags.others | op | /nametag others and the menu toggle: hiding other players' nametags is a permission, so by default everyone sees them |
advancednametags.admin | op | every admin command, all templates in the gallery, admin menu buttons, update notices on join |
advancednametags.template.<id> | nobody | qualifies for a template (unless it sets its own permission) |
advancednametags.badge.<id> | nobody | owns a badge (unless it sets its own permission) |
advancednametags.motion.<name> / advancednametags.motion.* | op | may pick that movement |
Template permissions, badge permissions and the group.<name> nodes used by template groups are
declared default: false: operators do not get every template and badge, so an op still looks like
their real rank. Give them explicitly if you want.
Messages
Every message is in lang/<language>.yml (bundled: en, es, de, fr, pt_br, ru, zh_cn),
MiniMessage with clickable and hover text. Set language in config.yml; the chosen file is
copied to lang/ so you can edit it, and messages you do not define fall back to the bundled text.
An empty message ('') is not sent at all. prefix is inserted wherever a message uses <prefix>.
Messages take their colours from a few tags instead of fixed colours, so the whole look stays
consistent (any MiniMessage colour works too, e.g. <gold> or <#ff8800>, if you prefer your
server's colours):
| Tag | Colour | Used for |
|---|---|---|
<accent> | #C6FF2E lime | the plugin name, menu titles, links and buttons to click |
<base> | #9FB1F5 blue-grey | ordinary text |
<highlight> | #FFFFFF white | names, numbers, commands |
<muted> | #6F86D8 dim blue | notes in parentheses |
<deco> | #2D5BFF cobalt | separators and bullets (» · •) |
<success> / <warning> / <error> | #3EE08A / #FFC04D / #FF5A6A | saved or done / notes and problems / errors |
These tags only exist in messages, not in nametag lines.