ModsJava
NameTag 1.13.x-1.21.x
NameTag - Customize Player Nametags & Chat Prefixes! A robust and highly configurable Spigot/PaperMC plugin to personalize player name tags and chat…
⬇ Download on SpigotNameTag - Customize Player Nametags & Chat Prefixes!
A robust and highly configurable Spigot/PaperMC plugin to personalize player name tags and chat messages with prefixes, suffixes, and custom name colors.
Features
All commands start with /nametag or the alias /nt.
Configuration
How to Install
Support
If you encounter any bugs, have suggestions, or need assistance, please feel free to reach out to me! https://discord.gg/7hG6yVHS
A robust and highly configurable Spigot/PaperMC plugin to personalize player name tags and chat messages with prefixes, suffixes, and custom name colors.
- Fully Customizable NameTags: Set unique prefixes, suffixes, and name colors for players directly above their heads and in the tab list
- Group-Based Configuration: Define multiple NameTag groups (e.g., VIP, Admin, Mod) with distinct styles.
- Permission-Based Assignment: Players automatically receive a NameTag based on their assigned permission (e.g., nametag.group.vip).
- Direct Player Assignment: Manually assign a specific NameTag group to any player, overriding their permission-based group. Perfect for special roles or events!
- Direct Player Assignment: Manually assign a specific NameTag group to any player, overriding their permission-based group. Perfect for special roles or events!
- Direct Player Assignment: Manually assign a specific NameTag group to any player, overriding their permission-based group. Perfect for special roles or events!
- Integrated Chat Formatting: Automatically add the player's customized NameTag prefix and colored name to their chat messages, ensuring consistency across your server.
- Easy Configuration: All NameTag styles, group settings, and plugin messages are managed via a simple and intuitive config.yml file.
- In-Game Commands: Manage your NameTag groups and player assignments directly in-game with comprehensive commands.
- Tab Completion: Enjoy a smooth experience with full tab completion support for all plugin commands.
- Lightweight & Efficient: Designed for performance, ensuring minimal impact on your server's tick rate.
- Spigot/PaperMC Compatibility: Built for modern Minecraft versions (1.20.4+) and compatible with both Spigot and PaperMC.
All commands start with /nametag or the alias /nt.
Spoiler: Commands
/nt reload - Reloads the plugin configuration.
/nt list groups - Lists all configured NameTag groups.
/nt info group <name> - Displays detailed info about a specific group
/nt info player <player> - Displays NameTag info for a specific player.
/nt group create <name> - Creates a new NameTag group.
/nt group <name> prefix <prefix> - Sets the prefix for a group
/nt group <name> suffix <suffix> - Sets the suffix for a group.
/nt group <name> permission <permission> - Sets the permission for a group.
/nt group <name> namecolor <color_code> - Sets the name color for players in a group.
/nt group <name> delete - Deletes a NameTag group.
/nt player <player> set <group> - Assigns a specific group's NameTag to a player.
/nt player <player> resetResets a player's direct NameTag assignment
(Base Command) General access to customnametag commands.
/nt list groups - Lists all configured NameTag groups.
/nt info group <name> - Displays detailed info about a specific group
/nt info player <player> - Displays NameTag info for a specific player.
/nt group create <name> - Creates a new NameTag group.
/nt group <name> prefix <prefix> - Sets the prefix for a group
/nt group <name> suffix <suffix> - Sets the suffix for a group.
/nt group <name> permission <permission> - Sets the permission for a group.
/nt group <name> namecolor <color_code> - Sets the name color for players in a group.
/nt group <name> delete - Deletes a NameTag group.
/nt player <player> set <group> - Assigns a specific group's NameTag to a player.
/nt player <player> resetResets a player's direct NameTag assignment
(Base Command) General access to customnametag commands.
Spoiler: Permissions
nametag.command.reload
nametag.command.list
nametag.command.info
nametag.command.info
nametag.command.group.create
nametag.command.group.setprefix nametag.command.group.setsuffix nametag.command.group.setpermission
nametag.command.group.setnamecolor/nt group <name> nametag.command.group.delete
nametag.command.player.set
nametag.command.player.reset
nametag.command.base (default: op)
nametag.command.list
nametag.command.info
nametag.command.info
nametag.command.group.create
nametag.command.group.setprefix nametag.command.group.setsuffix nametag.command.group.setpermission
nametag.command.group.setnamecolor/nt group <name> nametag.command.group.delete
nametag.command.player.set
nametag.command.player.reset
nametag.command.base (default: op)
Configuration
Code (YAML):
# Default NameTag settings for players without specific group permissions or assignments
default-nametag:
prefix : "&6[PLAYER] " # Example: Yellow prefix for the player. No &r if you want this color to bleed into the name.
suffix : " &b[MEMBER]" # Example: Aqua suffix.
name-color : "&f" # The actual color of the player's name (e.g., &f for white, &7 for gray).
# NameTag settings for specific permission groups (e.g., VIP, Admin)
# Players with the defined permission will receive this NameTag.
# The order in this list determines priority: the first matching permission wins.
groups:
vip:
permission : "customnametag.group.vip"
prefix : "&c[VIP] " # Red prefix
suffix : " &a[PRO]" # Green suffix
name-color : "&c" # Player name will be red
admin:
permission : "customnametag.group.admin"
prefix : "&4[ADMIN] " # Dark Red prefix
suffix : " &e[STAFF]" # Yellow suffix
name-color : "&e" # Player name will be yellow
# Player specific NameTag assignments
# Format: 'player_uuid': 'group_name'
# This section overrides permission-based assignments for specific players.
player-assignments :
# Example: 'a1b2c3d4-e5f6-7890-1234-567890abcdef': 'vip'
# Example: 'another-uuid': 'admin'
# Plugin messages (customize all messages sent to players and console)
messages:
plugin-enabled : "&aCustomNameTag has been successfully enabled!"
plugin-disabled : "&cCustomNameTag has been disabled."
player-joined : "&7Player %player_name% joined. Applying NameTag."
config-reloaded : "&aCustomNameTag configuration reloaded!"
no-permission : "&cYou don't have permission to use this command."
command-usage : "&cUsage: %usage%"
group-created : "&aGroup '%group_name%' has been created."
group-already-exists : "&cGroup '%group_name%' already exists."
group-not-found : "&cGroup '%group_name%' not found."
group-prefix-set : "&aPrefix for group '%group_name%' set to '%prefix%'."
group-suffix-set : "&aSuffix for group '%group_name%' set to '%suffix%'."
group-permission-set : "&aPermission for group '%group_name%' set to '%permission%'."
group-namecolor-set : "&aName color for group '%group_name%' set to '%name_color%'."
group-deleted : "&aGroup '%group_name%' has been deleted."
player-set-group : "&aPlayer %player_name%'s NameTag set to group '%group_name%'."
player-reset-group : "&aPlayer %player_name%'s NameTag has been reset."
player-not-found : "&cPlayer '%player_name%' not found or not online."
invalid-arguments : "&cInvalid arguments. Please check usage."
group-list-header : "&6--- NameTag Groups (%count%) ---"
group-list-entry : "&e- %group_name%"
group-info-header : "&6--- Group Info: %group_name% ---"
group-info-details : |
&ePrefix : %prefix%
&eSuffix : %suffix%
&eName Color : %name_color%
&ePermission : %permission%
player-info-header : "&6--- Player Info: %player_name% ---"
player-info-assigned-group : "&eAssigned Group: %group_name%"
player-info-permission-group : "&ePermission Group: %group_name% (Perm: %permission%)"
player-info-default : "&eUsing Default NameTag"
player-info-details : |
&eCurrent Prefix : %prefix%
&eCurrent Suffix : %suffix%
&eCurrent Name Color : %name_color%
default-nametag:
prefix : "&6[PLAYER] " # Example: Yellow prefix for the player. No &r if you want this color to bleed into the name.
suffix : " &b[MEMBER]" # Example: Aqua suffix.
name-color : "&f" # The actual color of the player's name (e.g., &f for white, &7 for gray).
# NameTag settings for specific permission groups (e.g., VIP, Admin)
# Players with the defined permission will receive this NameTag.
# The order in this list determines priority: the first matching permission wins.
groups:
vip:
permission : "customnametag.group.vip"
prefix : "&c[VIP] " # Red prefix
suffix : " &a[PRO]" # Green suffix
name-color : "&c" # Player name will be red
admin:
permission : "customnametag.group.admin"
prefix : "&4[ADMIN] " # Dark Red prefix
suffix : " &e[STAFF]" # Yellow suffix
name-color : "&e" # Player name will be yellow
# Player specific NameTag assignments
# Format: 'player_uuid': 'group_name'
# This section overrides permission-based assignments for specific players.
player-assignments :
# Example: 'a1b2c3d4-e5f6-7890-1234-567890abcdef': 'vip'
# Example: 'another-uuid': 'admin'
# Plugin messages (customize all messages sent to players and console)
messages:
plugin-enabled : "&aCustomNameTag has been successfully enabled!"
plugin-disabled : "&cCustomNameTag has been disabled."
player-joined : "&7Player %player_name% joined. Applying NameTag."
config-reloaded : "&aCustomNameTag configuration reloaded!"
no-permission : "&cYou don't have permission to use this command."
command-usage : "&cUsage: %usage%"
group-created : "&aGroup '%group_name%' has been created."
group-already-exists : "&cGroup '%group_name%' already exists."
group-not-found : "&cGroup '%group_name%' not found."
group-prefix-set : "&aPrefix for group '%group_name%' set to '%prefix%'."
group-suffix-set : "&aSuffix for group '%group_name%' set to '%suffix%'."
group-permission-set : "&aPermission for group '%group_name%' set to '%permission%'."
group-namecolor-set : "&aName color for group '%group_name%' set to '%name_color%'."
group-deleted : "&aGroup '%group_name%' has been deleted."
player-set-group : "&aPlayer %player_name%'s NameTag set to group '%group_name%'."
player-reset-group : "&aPlayer %player_name%'s NameTag has been reset."
player-not-found : "&cPlayer '%player_name%' not found or not online."
invalid-arguments : "&cInvalid arguments. Please check usage."
group-list-header : "&6--- NameTag Groups (%count%) ---"
group-list-entry : "&e- %group_name%"
group-info-header : "&6--- Group Info: %group_name% ---"
group-info-details : |
&ePrefix : %prefix%
&eSuffix : %suffix%
&eName Color : %name_color%
&ePermission : %permission%
player-info-header : "&6--- Player Info: %player_name% ---"
player-info-assigned-group : "&eAssigned Group: %group_name%"
player-info-permission-group : "&ePermission Group: %group_name% (Perm: %permission%)"
player-info-default : "&eUsing Default NameTag"
player-info-details : |
&eCurrent Prefix : %prefix%
&eCurrent Suffix : %suffix%
&eCurrent Name Color : %name_color%
- Download the NameTag.jar file.
- Place the NameTag.jar file into your server's plugins/ folder.
- Restart or reload your server.
- The default config.yml will be generated in plugins/NameTag/. Customize it to your liking!
Support
If you encounter any bugs, have suggestions, or need assistance, please feel free to reach out to me! https://discord.gg/7hG6yVHS
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
NameTag 1.13.x-1.21.x is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 258 times (via Spigot). Download it and open it directly in the game.