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

Nametag Customizer