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 |
| ● | [MessageStatus] — 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

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

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