Player Nameplate Banner
A banner a player can equip, drawn above their head instead of the vanilla name tag. Each entry is one selectable banner; declare as many as you want players to choose from.
Selection is per player and persists through the selection artifact.
Rendering
Unlike a mob plate, a player banner is two stacked displays:
- a background built from the
<prefix>_left/<prefix>_middle/<prefix>_rightresource pack glyphs, sized in real time to the player's actual name width; - a separate text display placed measurably closer to the viewer, so the name always draws on top whatever the viewing angle.
The width is computed from Minecraft's real font metrics, so a banner fits a three-letter name and a sixteen-letter name equally well without manual tuning.
Fields
| Field | Default | Description |
|---|---|---|
craftEngineImageId | "" | Asset id prefix for the three-slice background, from CraftEngine, Nexo or ItemsAdder. Empty means text only. |
tileWidthPx | 16 | Width of the tileable middle texture. |
capWidthPx | 3 | Drawn width of one end cap — must match the real artwork. |
paddingPx | 10 | Extra banner width on each side of the name, beyond the caps. |
lines | <white><player_name> | MiniMessage lines drawn over the banner. |
offsetY | 0.35 | Height above the player's head. |
textScale | 1.0 | Scale applied to the banner display. |
<player_name> is the only placeholder available in lines.
Commands
Players equip and preview banners through /nameplates; see the
extension overview for the full command and permission list.
See also
- Global Mob Nameplate — the equivalent for mobs.
- Player Nameplate Selection Artifact — where the choice is stored.