Sueta

Nametag Customizer

1.1

Take full control of what floats above every player's head.

·Plugin
Tested MC versions
1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 26.1

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

CommandDescriptionPermissionDefault
/nc reloadReloads the config and refreshes all nametagsnametagcustomizer.reloadOP

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:

ConditionResult
[Username] presentFormatted player name is shown
[Username] absent or line emptyNametag hidden
No color codeDefaults to &f (white)

Up-Lines must be numbered without gaps (Up-Line-1, Up-Line-2, Up-Line-3…).


Placeholders

» Identity

PlaceholderOutput
[Username]Steve
[DisplayName]Custom display name
[UUID-Short]a3f9c12b

» Health

PlaceholderOutput
[Health-Numeric]18/20
[Health-Graphic]❤❤❤❤❤❤❤❤❤❤ (full/half/empty hearts)

» Food & Armor

PlaceholderOutput
[Food]18
[Food-Bar]⊕⊕⊕⊕⊕⊕⊕⊕⊕⊕ (bar)
[Armor]16

» XP

PlaceholderOutput
[Level]32
[XP-Bar]▪▪▪▪▪▪▪░░░ (progress bar)

» Network & Status

PlaceholderOutput
[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

PlaceholderOutput
[World]world
[Biome]Flower forest
[Time]14:30
[Coords]128 64 -256
[Direction]NE

» Items

PlaceholderOutput
[Item-Hand]Diamond sword
[Item-Durability]1532/1561

» Chat

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

Compatibility

Minecraft1.16 → latest
ServerSpigot / Paper
Java17+
DependenciesNone

Similar projects

Plugin →