Commands
Admin commands are under /nametags and require the admin permission — see Permissions. Players can manage their own nametag with /nametag.
Top level (admin)
| Command | Description |
|---|---|
/nametags reload | Reloads config.yml, gui.yml, messages.yml, the stored player, group, and editor placeholder data, and refreshes every online player's nametag. |
/nametags update | Runs a fresh check against the plugin's Modrinth project and reports whether a newer release-type version is available. |
/nametags config [key] [value] | Views or changes config.yml settings without needing a restart or /nametags reload — see config. |
/nametags format ... | Manage nametag formats — see format. |
/nametags editor | Opens the admin nametag format editor GUI. Players only. |
/nametags editor placeholders ... | Manages the placeholders offered in the editor — see editor placeholders. |
The plugin also checks Modrinth for a newer version once automatically on startup, and messages any player with the customplayernametags.updatenotify permission (OPs by default) who joins afterward if that check found a newer version.
format — global / player / groups
global
| Command | Effect |
|---|---|
/nametags format global view [java|bedrock] [player] | Shows the global format both unparsed (as stored) and parsed. If [player] is given, it is parsed for that player. |
/nametags format global set [java|bedrock] <format> | Updates nametag-format (or bedrock-nametag-format) in config.yml and applies it to any players using the global format. |
/nametags format global reset [java|bedrock] | Resets the global format back to the default ({player}) and refreshes every player using the global format. |
player
| Command | Effect |
|---|---|
/nametags format player view <player> | Shows the format currently in effect for <player>, unparsed and parsed — their individual format if set, otherwise their group or global format. |
/nametags format player set [announce|silent] <player> <format> | Sets the individual format for <player>. The announce/silent argument is only accepted if nametag-format-notify-mode is set to BOTH — see Configuration. |
/nametags format player disable <player> | Clears <player>'s individual format, reverting them to their group or global format. Anything they typed into widgets is kept. |
groups
Sets, views, or removes a nametag format for an entire LuckPerms group. Group formats can be configured without LuckPerms installed, but they won't apply to anyone until it is (you are warned when you run these commands without it). If a player is in more than one group, the format from their highest-weighted group that has one is used.
| Command | Effect |
|---|---|
/nametags format groups add [java|bedrock] <group> <format> | Creates a nametag format for everyone in <group>. Fails if the group already has one. |
/nametags format groups edit [java|bedrock] <group> <format> | Updates the format already set for <group>. Fails if the group doesn't have one yet. |
/nametags format groups remove [java|bedrock] <group> | Removes the format set for <group>. |
/nametags format groups view [java|bedrock] <group> [player] | Shows the format set for <group>, unparsed and parsed, optionally parsed for a specific player. |
Formats are resolved in this order: Player -> Group -> Global. Without PlaceholderAPI installed, only individual player formats apply.
editor placeholders
The nametag editor's Placeholder picker offers a built-in {player} username button plus any placeholders added with these subcommands, which are stored in storage/editor-placeholders.yml.
| Command | Effect |
|---|---|
/nametags editor placeholders add <placeholder> [name] | Adds a PlaceholderAPI placeholder to the picker. <placeholder> must include its % signs. [name] is the display name shown on its button. |
/nametags editor placeholders edit <placeholder> <name> | Changes the display name of a placeholder that has already been added. |
/nametags editor placeholders remove <placeholder> | Removes a placeholder from the picker. |
For example:
/nametags editor placeholders add %luckperms_prefix% Rank Prefixdismount — console only
| Command | Description |
|---|---|
/nametags dismount <player> [ticks] | Manually dismounts a player's nametag for [ticks], or for dismount-duration-ticks if left out (values below 2 are raised to 2). Console-only, and works even if nametag-dismount-mode is NONE. Intended for use with Skript when scripting cross-world teleports. |
/nametag — player menu
/nametag opens a menu for the player who runs it. It requires the customplayernametags.nametag permission, which everyone has by default. From the menu, a player can edit their nametag's widgets, view their current nametag format, and hide or show other players' nametags from them. See Nametag Formats for details.