CraftHub
Nametags

Nametags

Nametags is a lightweight Minecraft plugin for Paper/Spigot 1.20.6+ designed to fully customize player displays.

1 871 downloads 1 followers

A robust and lightweight Minecraft plugin designed for Paper/Spigot 1.20.6+ (and newer) that lets you fully customize player nametags, chat formatting, tab lists, and health displays.

🌟 Overview

The plugin manages player prefixes, suffixes, nickname colors, and health subtitles across three areas:

  1. Above player heads (3D scoreboard team nametags).
  2. On the TAB list (player list).
  3. On the Chat (the default <PlayerName> Message format is replaced with Prefix Nickname Suffix: Message, and colors are prevented from bleeding into the message text).

🛠️ Key Features

  1. Gradients & RGB Hex Support (1.16+):

    • Fully supports legacy color codes (e.g., &a, &l, §c).
    • Supports custom Hex colors (e.g., &#FF5555).
    • Built-in multi-hex color interpolation for gradients (e.g., &#FF0000&#00FF00Admin smoothly transitions from red to green).

  2. Smart Formatting & Auto-Spacing:

    • Automatically adds a space after prefixes and before suffixes if missing, ensuring they never clash or stick to player names.

  3. Native Nickname Coloration (nickcolor):

    • Uses Minecraft's native team.color(...) scoreboard field to change player name colors above heads and in the TAB list.
    • Modifies chat name colors while cleanly resetting message colors afterwards to prevent color bleed.

  4. Health Display below Name (subtitle):

    • Enabled by default (shows <health> HP in red under player names in real-time).
    • Health scores update exactly 1 tick after damage or healing events for accuracy.
    • Simple per-player toggle using on/off options.

  5. LuckPerms Integration:

    • Allows manual synchronization of prefix/suffix values from LuckPerms groups.
    • Features a toggleable autosync scheduler that updates all online players' groups every 5 seconds.

  6. Persistent Data:

    • All player modifications (prefixes, suffixes, colors, and subtitle configurations) are stored in data.yml inside the plugin directory so they survive server restarts.

📋 Commands & Permissions

Modify commands require the nametags.use permission. Admin commands (reload/autosync) require nametags.admin (defaults to OP).

Command Description
/nametag <player> prefix <text> Changes the player's prefix and notifies them in chat.
/nametag <player> silentprefix <text> Changes the prefix silently (no message is sent to the target player).
/nametag <player> rgbprefix <hex/gradient> Set a gradient prefix (e.g. &#FF0000&#00FF00Owner).
/nametag <player> suffix <text> Changes the player's suffix and notifies them.
/nametag <player> silentsuffix <text> Changes the suffix silently.
/nametag <player> rgbsuffix <hex/gradient> Set a gradient suffix.
/nametag <player> nickcolor <color> Sets nickname color (Options: red, blue, green, gold, yellow, white, aqua, etc.).
/nametag <player> subtitle <on/off> Toggles the <health> HP display below the player's name.
/nametag <player> <category> reset Resets the selected category (prefix, suffix, or nickcolor).
/nametag <player> luckperms-sync Performs a one-time synchronization of prefix/suffix from LuckPerms.
/nametag luckperms-autosync Toggles the automatic 5-second LuckPerms synchronizer.
/nametag reload / /nametags reload Reloads the plugin configuration and applies updates to online players.

Full tab-completion support is included, suggesting online player names, subcommands, and English color names for the nickcolor command.

No gallery available for this project.

Version Minecraft Loader Download

1.0

1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
bukkit, paper, spigot
Download