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 ` 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�FF00Admin` 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 ` 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 prefix ` | Changes the player's prefix and notifies them in chat. | | `/nametag silentprefix ` | Changes the prefix silently (no message is sent to the target player). | | `/nametag rgbprefix ` | Set a gradient prefix (e.g. `&#FF0000�FF00Owner`). | | `/nametag suffix ` | Changes the player's suffix and notifies them. | | `/nametag silentsuffix ` | Changes the suffix silently. | | `/nametag rgbsuffix ` | Set a gradient suffix. | | `/nametag nickcolor ` | Sets nickname color (Options: `red`, `blue`, `green`, `gold`, `yellow`, `white`, `aqua`, etc.). | | `/nametag subtitle ` | Toggles the ` HP` display below the player's name. | | `/nametag reset` | Resets the selected category (prefix, suffix, or nickcolor). | | `/nametag 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.