This documentation is for NameplateBuilder v4.260326.2 with API v2.0.0.
Nameplate component. NameplateBuilder acts as a central aggregator - each mod registers named segments, and the system composites them into one nameplate per entity, per viewer, every tick.
Players get a full UI to customize what they see. Admins get server-wide killswitches, chain locking, world restrictions, and NPC blacklists. Modders get a simple API.
What It Does
- Multi-mod aggregation - Any number of mods register segments (health, guild tag, tier, title) and NameplateBuilder composites them into a single nameplate per entity
- Player customization - Players open
/npbto pick segments, reorder them, choose display formats, set separators, and configure prefix/suffix wrapping - Admin controls - Master killswitch, per-chain NPC/Player toggles, per-mod killswitches, world/instance restrictions, chain locking, and NPC blacklists. All admin overrides show “(Disabled by Admin)” to players
- Built-in segments - Ships with Player Name, Health, Stamina, and Mana out of the box
- Zero-conflict - Opt-in NPC model, death cleanup, persistent preferences, view-cone filtering, and hologram offset rendering are all handled automatically
Quick Navigation
- Overview - Features, permissions, and how it all fits together
- Installation - Get the mod running on your server
- Player Guide - Learn the UI as a player
- Modding Guide - Add your own segments in under 5 minutes
- API Reference - Full method tables and exception docs