NameplateBuilder

Customize the Nameplate above NPCs & Players in Hytale. Any mod can integrate and add their "segment" to this - you control how it looks.

Health bars, elite titles, guild tags, ranks for both NPCs & Players - drag and drop them into any order, pick display formats, and tweak separators. Talking about interesting features…

NameplateBuilder Preview

Editor UI overview

Why?

In Hytale, each entity only has one nameplate. When multiple mods try to show their own info above an entity, they overwrite each other. NameplateBuilder solves this. It collects text from every mod (that has integrated using the API) and combines them into one nameplate that you can fully customize.

Features

What You Get Out of the Box

NameplateBuilder comes with built-in nameplate segments for Player Name (with an option to hide your real name), Health, Stamina, and Mana. Each one has multiple display styles - show health as 42/67, as a percentage 63%, or as a visual bar ||||||------. Built-in segments are highlighted with a warm purple tint so you can tell them apart from mod-added ones.

Any mod that supports the NameplateBuilder API can add its own segments too (like elite tier labels, guild tags, or titles), and they all show up in your editor automatically.

Customize Everything

Open the editor with /npb and make nameplates look exactly how you want:

Drag and drop to reorder segments in any order you like
Choose display formats - pick how each segment looks (numbers, percentages, bars, etc.)
Custom separators - change what appears between segments, or remove separators entirely
Add text around segments - wrap any segment with custom text (e.g. HP: [42/67])
Adjust bar style - change the fill character used in bar displays
Vertical offset - slide nameplates up or down with a slider for a floating hologram look
Live preview - see your changes in real time before saving
Search - quickly find segments across all installed mods

Smart Defaults

NPC nameplates only appear when you look at them (within 12 blocks). Player nameplates are always visible
Player nameplates hide automatically when you crouch (just like in Minecraft)
Nameplates disappear when an entity dies instead of lingering
New players start with a sensible default setup. Mods can mark their most important segments to be turned on automatically
The save button stays greyed out until you actually change something
All buttons and controls have tooltips explaining what they do

Server Admin Controls

Server admins (nameplatebuilder.admin permission) get a full control panel:

On/off switches - Turn nameplates on or off for the whole server, for NPCs only, for players only, per mod, or per world/instance
Lock the chain - Force all players to see the same segment order. Players get a read-only view while admins can still make changes
Required segments - Make sure certain segments always show for everyone
Hidden segments - Remove segments from everyone's view entirely
NPC blacklist - Pick specific NPC types that should never get nameplates, with a searchable popup
Pattern blacklist - Use patterns like Citizen.* to block entire groups of NPCs at once. Comes with default patterns for Citizen, Mount, and Pet NPCs
Server name and welcome message - Set a custom name and toggle the join message on or off

When an admin disables something, players see "(Disabled by Admin)" and can't turn it back on.

For Mod Developers

Want to add your own segments? Check out the documentation for the full API reference and a working example mod. You can:

Register segments with display names, examples, and multiple format variants
Have NameplateBuilder compute your segment text automatically using resolvers, or set it yourself
Mark up to 3 of your segments to be enabled by default for new players

Performance

NameplateBuilder is built to be lightweight. Entities with no players nearby are skipped entirely, and results are cached wherever possible. You can test it yourself with /npbbench <players> <seconds> (e.g. /npbbench 50 5 simulates the current amount of entities in your world for a whopping 50 players for 5 seconds and reports how much of the server's tick budget is used). Increasing the time (seconds) gives a more accurate result.