Nametag Customizer

# NametagCustomizer > **Take full control of what floats above every player's head.** NametagCustomizer replaces the vanilla nametag with fully customizable multi-line hologram displays. Configure health bars, live chat messages, XP, ping, coordinates, and more — all from a single config file. --- ## Features | | | |---|---| | ● | **Multi-line holograms** that follow players in real time | | ● | **Dynamic placeholders** refreshed every tick | | ● | **** — last chat message floats above the player, wraps, then fades | | ● | Vanilla nametag **never leaks** into chat or death messages | | ● | Single clean config file | --- ## Commands & Permissions | Command | Description | Permission | Default | |---|---|---|---| | `/nc reload` | Reloads the config and refreshes all nametags | `nametagcustomizer.reload` | OP | --- ## Configuration ```yaml nametag: Main-Line: "&f" # Nametag displayed above the player Up-Line-1: "" # Lines go upward from the nametag Up-Line-2: "" message-display: ttl-seconds: 5 # How long a sent message stays visible line-width: 26 # Max characters per line before wrapping ``` **Main-Line** behavior: | Condition | Result | |---|---| | `` present | Formatted player name is shown | | `` absent or line empty | Nametag hidden | | No color code | Defaults to `&f` (white) | > Up-Lines must be numbered without gaps (`Up-Line-1`, `Up-Line-2`, `Up-Line-3`…). --- ## Placeholders ### » Identity | Placeholder | Output | |---|---| | `` | `Steve` | | `` | Custom display name | | `` | `a3f9c12b` | ### » Health | Placeholder | Output | |---|---| | `` | `18/20` | | `` | `❤❤❤❤❤❤❤❤❤❤` *(full/half/empty hearts)* | ### » Food & Armor | Placeholder | Output | |---|---| | `` | `18` | | `` | `⊕⊕⊕⊕⊕⊕⊕⊕⊕⊕` *(bar)* | | `` | `16` | ### » XP | Placeholder | Output | |---|---| | `` | `32` | | `` | `▪▪▪▪▪▪▪░░░` *(progress bar)* | ### » Network & Status | Placeholder | Output | |---|---| | `` | `24ms` | | `` | `Survival` | | `` | `12` | | `` | `Flying` *(empty if not flying)* | | `` | `Sneaking` *(empty if not sneaking)* | | `` | `Speed` | ### » World & Location | Placeholder | Output | |---|---| | `` | `world` | | `` | `Flower forest` | | `` | `14:30` | | `` | `128 64 -256` | | `` | `NE` | ### » Items | Placeholder | Output | |---|---| | `` | `Diamond sword` | | `` | `1532/1561` | ### » Chat | Placeholder | Output | |---|---| | `` | Last sent message, word-wrapped into as many lines as needed. Other Up-Lines shift upward automatically. Disappears after `ttl-seconds`. | --- ## Compatibility | | | |---|---| | **Minecraft** | 1.16 → latest | | **Server** | Spigot / Paper | | **Java** | 17+ | | **Dependencies** | None |