Nameplates

The Nameplates Extension renders every name tag on the server itself — mobs, NPCs and players — as per-viewer TextDisplay entities, with optional resource pack banner backgrounds sized to the text.

It replaces the former Custom Nameplate extension, which delegated rendering to the external CustomNameplates plugin. Nothing carries over: the entries, the fields and the command tree are all different.

Features

• Rule-based mob plates — one entry describes which mobs get a plate and what it says, rather than configuring each entity.
• Integrated health bar — drawn inside the same display as the name, not as a second entity.
• Three-slice banners — a background assembled from resource pack glyphs and measured against Minecraft's real font metrics, so it fits any name length without manual tuning.
• Player-selectable banners — equipped through /nameplates, persisted per player.
• Per-viewer visibility — distance, field of view, line of sight and look-at are evaluated independently for each player, with per-viewer caps on how many plates render at once.
• Custom NPC status indicators — replace the default ! / ? / ... markers with 3D models.

Entries

Manifests

• Global Mob Nameplate — one rule covering every matching mob, with the optional integrated health bar.
• Player Nameplate Banner — one selectable banner for players.

Entity data

• Nameplate Data — a specific entity's own plate, plus an optional 3D attachment.

Audiences

• NPC Status Override — replace a quest status indicator with a 3D model.

Artifacts

• Player Nameplate Selection Artifact — stores each player's equipped banner.

Quick start

1. Add one Global Mob Nameplate with entityTypes left empty and the default <white><name> line. Every mob now has a plate.
2. Narrow it: set btcMobsOnly if only custom mobs should be labelled, and raise requireLookAt if plates should appear on demand rather than permanently.
3. For a banner background, point craftEngineImageId at your asset prefix and check capWidthPx against the real artwork width — this is the single most common source of a banner that does not line up with its text.
4. For players, declare one Player Nameplate Selection Artifact and one Player Nameplate Banner per banner you want offered.

Commands

/nameplates, aliased /nameplate and /btcnameplates. Run with no argument to see your current banner and whether banners are enabled for you.

Subcommand	Permission	Description
equip <id>	btcnameplates.command.equip	Equip a banner.
unequip	btcnameplates.command.unequip	Clear your banner.
preview [id]	btcnameplates.command.preview	Preview a banner for a few seconds. Switch to third person (F5) to see it.
list	btcnameplates.command.list	List the configured banners.
toggle [on|off]	btcnameplates.command.toggle	Turn banners on or off for yourself.
force-equip <player> <id>	btcnameplates.command.admin.force_equip	Equip a banner on someone else.
force-unequip <player>	btcnameplates.command.admin.force_unequip	Clear someone else's banner.
force-preview <player> [id]	btcnameplates.command.admin.force_preview	Trigger a preview for someone else.
admin-toggle <player> [on|off]	btcnameplates.command.admin.toggle	Turn banners on or off for someone else.

The subcommand names mirror the legacy CustomNameplates tree on purpose, so staff do not have to relearn a command shape.

Dependencies

Dependency	Required	Usage
A resource pack asset system	Optional	Banner backgrounds and health-bar glyphs, from CraftEngine, Nexo or ItemsAdder. Without one, plates render as text only.
BTCMobs	Optional	Required for btcMobsOnly and the <btc_name> / <btc_id> placeholders.
BetterModel	Optional	Usable as an attachment or as an NPC status indicator model.
PlaceholderAPI	Optional	Placeholder resolution in Nameplate Data lines.