NameTag 1.13.x-1.21.x icon

NameTag 1.13.x-1.21.x -----

NameTag: Personalize player name tags & chat prefixes with powerful in-game commands!



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.

[​IMG]
[​IMG]
[​IMG]
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.

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)

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%
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
Resource Information
Author:
----------
Total Downloads: 45
First Release: Jul 27, 2025
Last Update: Jul 27, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings