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

| | | |---|---| | ● | never leaks that follow players in real time | | ● | never leaks refreshed every tick | | ● | never leaks — 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[Username]" # Nametag displayed above the player Up-Line-1: "[MessageStatus]" # Lines go upward from the nametag Up-Line-2: "[Health-Graphic]"

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 | |---|---| | `[Username]` present | Formatted player name is shown | | `[Username]` 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 | |---|---| | `[Username]` | `Steve` | | `[DisplayName]` | Custom display name | | `[UUID-Short]` | `a3f9c12b` |

» Health

| Placeholder | Output | |---|---| | `[Health-Numeric]` | `18/20` | | `[Health-Graphic]` | `❤❤❤❤❤❤❤❤❤❤` *(full/half/empty hearts)* |

» Food & Armor

| Placeholder | Output | |---|---| | `[Food]` | `18` | | `[Food-Bar]` | `⊕⊕⊕⊕⊕⊕⊕⊕⊕⊕` *(bar)* | | `[Armor]` | `16` |

» XP

| Placeholder | Output | |---|---| | `[Level]` | `32` | | `[XP-Bar]` | `▪▪▪▪▪▪▪░░░` *(progress bar)* |

» Network & Status

| Placeholder | Output | |---|---| | `[Ping]` | `24ms` | | `[GameMode]` | `Survival` | | `[Online]` | `12` | | `[Is-Flying]` | `Flying` *(empty if not flying)* | | `[Is-Sneaking]` | `Sneaking` *(empty if not sneaking)* | | `[Active-Effect]` | `Speed` |

» World & Location

| Placeholder | Output | |---|---| | `[World]` | `world` | | `[Biome]` | `Flower forest` | | `[Time]` | `14:30` | | `[Coords]` | `128 64 -256` | | `[Direction]` | `NE` |

» Items

| Placeholder | Output | |---|---| | `[Item-Hand]` | `Diamond sword` | | `[Item-Durability]` | `1532/1561` |

» Chat

| Placeholder | Output | |---|---| | `[MessageStatus]` | Last sent message, word-wrapped into as many lines as needed. Other Up-Lines shift upward automatically. Disappears after `ttl-seconds`. |

---

Compatibility

| | | |---|---| | Dependencies | 1.16 → latest | | Dependencies | Spigot / Paper | | Dependencies | 17+ | | Dependencies | None |