BTC Player Nameplate Banner
Player nameplate banner
A selectable nameplate banner shown above a player's head instead of the vanilla name tag. Content-driven the same way [GlobalNameplateEntry] is. Rendering is true two-layer compositing (see [btc.renaud.hudextension.nameplates.service.PlayerNameplateService]): a background display built from '<prefix>_left'/'<prefix>_middle'/'<prefix>_right' CraftEngine image glyphs, sized in real time to the player's actual name width via [btc.renaud.hudextension.nameplates.service.MinecraftFontWidths], with a separate name-text display stacked measurably closer to the viewer so it always renders on top regardless of viewing angle.
Felder
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
craftEngineImageId | String | — | CraftEngine image asset id PREFIX for the banner background. The service looks up '<prefix>_left', '<prefix>_middle' and '<prefix>_right' (3-slice banner, see craftengine/nameplates/). Empty means no background, name text only. |
tileWidthPx | Int | 16 | Pixel width of the tileable middle texture. |
capWidthPx | Int | 3 | Drawn (opaque) pixel width of a single left/right end cap. Must match the real artwork width — the caps are thin borders, not full tiles. |
paddingPx | Int | 10 | Extra pixels of banner width on each side of the name, beyond the two end caps. |
lines | List<String> | — | MiniMessage lines rendered over the banner. Placeholder: <player_name>. |
offsetY | Double | 0.35 | Vertical offset above the player's head. |
textScale | Float | 1.0 | Scale applied to the banner display. |