NameTag 1.8.x - 1.12.x

For Minecraft 1.13.x - 1.21.x+ Servers (Recommended)

This version is compiled with the latest APIs, ensuring optimal performance and compatibility with modern Minecraft server versions (PaperMC, Spigot, and forks).

• Supported Versions: 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21.x+
  
• Download: https://www.spigotmc.org/resources/nametag-1-13-x-1-21-x.127375/
  

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.

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.

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 nametag.command.group.delete
nametag.command.player.set
nametag.command.player.reset
nametag.command.base (default: op)

Configuration

# 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

1. 
   
   
   • 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