Nametags

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).

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