BTC Global Nameplate
Global mob nameplate
Campos
| Campo | Tipo | Predeterminado | Descripción |
|---|---|---|---|
entityTypes | List<String> | empty | Bukkit EntityType names. Empty means every living entity except players and armor stands (see includeArmorStands). Players always go through the dedicated player nameplate system. |
btcMobsOnly | Boolean | false | Only match active btcMobs entities. Vanilla/classic mobs are left untouched. |
includeArmorStands | Boolean | false | Also match armor stands. Off by default so decorative/hologram armor stands from other systems are never touched. |
lines | List<String> | — | MiniMessage lines. The optional integrated bar is appended after these lines. Placeholders: <name>, <vanilla_name>, <btc_name>, <btc_id>, <type>, <health>, <max_health>, <health_percent>. |
offsetY | Double | 0.35 | Vertical offset above the entity. |
viewDistance | Double | 15.0 | Maximum client-side distance in blocks. Defaults to 15 blocks. |
requireLookAt | Boolean | false | Only show this plate while the viewer is looking at the mob. |
fieldOfViewDegrees | Double | 110.0 | Horizontal field of view in degrees used for client-side culling. |
requireLineOfSight | Boolean | true | Hide plates when an opaque block is between the viewer and the mob. |
maxVisibleNameplates | Int | 64 | Maximum simultaneous nameplates for one viewer. |
refreshTicks | Long | 4 | Refresh interval for nearby/targeted plates in ticks. |
showHealthBar | Boolean | false | Render the UiCore health gauge behind a centred counter, below the name. |
healthBarBtcMobsOnly | Boolean | true | Only render the integrated bar for active btcMobs entities. |
healthBarRequireLookAt | Boolean | true | Only show the integrated bar while the viewer is looking at the mob. |
healthBarMaxVisible | Int | 3 | Maximum simultaneous integrated health bars for one viewer. |
healthBarFocusRadius | Double | 2.0 | When look-at mode is enabled, include mobs within this radius of the crosshair hit. |
healthBarSegments | Int | 10 | Number of bitmap segments in the integrated bar. |
healthBarValueFormat | String | <white>%.1f / %.1f | MiniMessage/printf format for the exact health line. |
craftEngineImageId | String | — | CraftEngine image asset id PREFIX for a banner background drawn behind the text, as a second display. The service looks up '<prefix>_left', '<prefix>_middle' and '<prefix>_right' (3-slice banner, see craftengine/nameplates/). Empty means no background, 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 text, beyond the two end caps. |
bannerLineCount | Int | 1 | How many lines from the top the banner covers. 1 keeps it behind the name only, leaving the health bar and value lines bare. 0 covers every line. |
textScale | Float | 1.0 | Scale applied to the complete unified nameplate display. |
hideVanillaName | Boolean | true | Hide the vanilla custom name while this plate is active. |
backgroundColor | Int | 0 | ARGB background color, zero means transparent. |
textOpacity | Int | 255 | Text opacity from 0 to 255. |