NameTag - 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
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.
Commands & Permissions All commands start with /nametag or the alias /nt.
/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.
# 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%
How to Install
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