Reference
Commands
All CustomPlayerNametags commands are under /nametags (alias /customplayernametags). All commands require the admin permission — see Permissions.
Top level
| Command | Description |
|---|
/nametags reload | Reloads config.yml, messages.yml, 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. Pre-release/beta versions are ignored. |
/nametags format ... | Manage nametag formats — see below. |
Automatic update checksThe plugin also checks Modrinth for a newer version once automatically on startup, and messages any OP who joins afterward if that check found a newer version.
Every format subcommand branches on a target: global (the server-wide format) or player <name> (a specific player's individual format).
view
| Command | Shows |
|---|
/nametags format view global unparsed | The raw global format exactly as stored in config.yml — literal & codes and placeholders are shown. |
/nametags format view global parsed <player> | The global format resolved through PlaceholderAPI using <player> as context, with colors applied (what would actually be shown as the nametag). |
/nametags format view player <unparsed|parsed> <player> | The format currently in effect for <player> — their personal format if set, otherwise the global format. |
set
| Command | Effect |
|---|
/nametags format set global <format> | Updates nametag-format in config.yml and refreshes every online player who has no personal override. |
/nametags format set player <player> <format> | Sets a personal override for <player>, saves to player-formats.yml, and refreshes their nametag. |
reset
| Command | Effect |
|---|
/nametags format reset global | Resets the global format back to the default (%player_name%) and refreshes every player without a personal override. |
/nametags format reset player <player> | Clears <player>'s personal override, reverting them to the global format, and refreshes their nametag. |
dismount — console only
| Command | Description |
|---|
/nametags dismount <player> | Manually dismounts a player's nametag for dismount-duration-ticks. Console-only, and works even if nametag-dismount-mode is NONE. Intended for use with Skript when scripting cross-world teleports. |
CustomPlayerNametags