# NametagCustomizer<\/p>\n
> **Take full control of what floats above every player’s head.**<\/p>\n
NametagCustomizer replaces the vanilla nametag with fully customizable multi-line hologram displays.
\nConfigure health bars, live chat messages, XP, ping, coordinates, and more \u2014 all from a single config file.<\/p>\n
—<\/p>\n
## Features<\/p>\n
| | |
\n|—|—|
\n| \u25cf | **Multi-line holograms** that follow players in real time |
\n| \u25cf | **Dynamic placeholders** refreshed every tick |
\n| \u25cf | **[MessageStatus]** \u2014 last chat message floats above the player, wraps, then fades |
\n| \u25cf | Vanilla nametag **never leaks** into chat or death messages |
\n| \u25cf | Single clean config file |<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Description | Permission | Default |
\n|—|—|—|—|
\n| `\/nc reload` | Reloads the config and refreshes all nametags | `nametagcustomizer.reload` | OP |<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
“`yaml
\nnametag:
\n Main-Line: “&f[Username]” # Nametag displayed above the player
\n Up-Line-1: “[MessageStatus]” # Lines go upward from the nametag
\n Up-Line-2: “[Health-Graphic]”<\/p>\n
message-display:
\n ttl-seconds: 5 # How long a sent message stays visible
\n line-width: 26 # Max characters per line before wrapping
\n“`<\/p>\n
**Main-Line** behavior:<\/p>\n
| Condition | Result |
\n|—|—|
\n| `[Username]` present | Formatted player name is shown |
\n| `[Username]` absent or line empty | Nametag hidden |
\n| No color code | Defaults to `&f` (white) |<\/p>\n
> Up-Lines must be numbered without gaps (`Up-Line-1`, `Up-Line-2`, `Up-Line-3`\u2026).<\/p>\n
—<\/p>\n
## Placeholders<\/p>\n
### \u00bb Identity<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Username]` | `Steve` |
\n| `[DisplayName]` | Custom display name |
\n| `[UUID-Short]` | `a3f9c12b` |<\/p>\n
### \u00bb Health<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Health-Numeric]` | `18\/20` |
\n| `[Health-Graphic]` | `\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764` *(full\/half\/empty hearts)* |<\/p>\n
### \u00bb Food & Armor<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Food]` | `18` |
\n| `[Food-Bar]` | `\u2295\u2295\u2295\u2295\u2295\u2295\u2295\u2295\u2295\u2295` *(bar)* |
\n| `[Armor]` | `16` |<\/p>\n
### \u00bb XP<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Level]` | `32` |
\n| `[XP-Bar]` | `\u25aa\u25aa\u25aa\u25aa\u25aa\u25aa\u25aa\u2591\u2591\u2591` *(progress bar)* |<\/p>\n
### \u00bb Network & Status<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Ping]` | `24ms` |
\n| `[GameMode]` | `Survival` |
\n| `[Online]` | `12` |
\n| `[Is-Flying]` | `Flying` *(empty if not flying)* |
\n| `[Is-Sneaking]` | `Sneaking` *(empty if not sneaking)* |
\n| `[Active-Effect]` | `Speed` |<\/p>\n
### \u00bb World & Location<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[World]` | `world` |
\n| `[Biome]` | `Flower forest` |
\n| `[Time]` | `14:30` |
\n| `[Coords]` | `128 64 -256` |
\n| `[Direction]` | `NE` |<\/p>\n
### \u00bb Items<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[Item-Hand]` | `Diamond sword` |
\n| `[Item-Durability]` | `1532\/1561` |<\/p>\n
### \u00bb Chat<\/p>\n
| Placeholder | Output |
\n|—|—|
\n| `[MessageStatus]` | Last sent message, word-wrapped into as many lines as needed. Other Up-Lines shift upward automatically. Disappears after `ttl-seconds`. |<\/p>\n
—<\/p>\n
## Compatibility<\/p>\n
| | |
\n|—|—|
\n| **Minecraft** | 1.16 \u2192 latest |
\n| **Server** | Spigot \/ Paper |
\n| **Java** | 17+ |
\n| **Dependencies** | None |<\/p>\n","protected":false},"excerpt":{"rendered":"
Take full control of what floats above every player’s head.<\/p>\n","protected":false},"featured_media":108641,"template":"","meta":{"_minecraft_slug":"nametag-customizer","_minecraft_project_id":"U6LOpGxQ","_minecraft_author":"mc.schnitzel","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":62,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nametag-customizer.zip","_minecraft_size_bytes":19995,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:58:58.301215Z","_minecraft_date_created":"2026-05-03T01:38:34.681422Z","_minecraft_date_modified":"2026-04-24T13:01:07.478640Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nametag-customizer","_minecraft_icon_attachment_id":108641,"_minecraft_imported_at":"2026-06-06T06:54:32+00:00","_minecraft_import_hash":"2ae563228348bb7c43bdaa592a6608a3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-108640","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n