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