Bettermodel Instance

An instance of a BetterModel entity

EntityProvided by BetterModel

Fields

Field	Type	Default	Description
definition	Ref<BetterModelDefinition>	—	— BetterModelDefinition (11) Field Type Default Description displayName Var<String> — — sound Var<Sound> EMPTY — data List<Ref<EntityData<*>>> empty — modelId Var<String> — The BetterModel model ID to use named Var<Boolean> false Whether the entity should display a nametag defaultAnimationSettings DefaultAnimationSettings — Default animation settings for the entity DefaultAnimationSettings (10) Field Type Default Description walkAnimation Boolean true Run the default walk animation if the entity is moving idle Var<String> idle The idle animation to play when the entity is not moving walk Var<String> walk The walk animation to play when the entity is moving attack Var<String> attack The attack animation to play when the entity swings its arm hurt Var<String> hurt The hurt animation to play when the entity takes damage strafe Var<String> strafe The strafe animation to play when the entity moves sideways jump Var<String> jump The jump animation to play when the entity leaves the ground fly Var<String> fly The flying animation to play when the entity is airborne interact Var<String> interact The interact animation to play when the entity is interacted with hitboxYOffset Double -1.6 Y offset applied to bone hitbox interaction entities (client-side positioning) focusOffset Vector — Offset used as focus point for interaction bounds like look_at headLight Var<Int> 0 Light level of a fake light block above the entity's head (0 disables) hitboxes List<BoneHitbox> empty List of custom hitboxes attached to bones BoneHitbox (7) Field Type Default Description boneName String — — width Float 0.5 — height Float 0.5 — scale Float 1.0 — offsetX Double 0.0 — offsetY Double 0.0 — offsetZ Double 0.0 — nameOffset Double 2.3 Y offset for the name display above the entity. Use this to adjust the text display height. showDisplayName Boolean true Whether to show the display name above the entity
spawnLocation	Var<Position>	ORIGIN	—With rotation
data	List<Ref<EntityData<*>>>	empty	—
activity	Ref<out SharedEntityActivityEntry>	—	—

How to use it

Place the instance on a manifest page. definition is required; without it the log prints You must specify a definition and nothing is shown.

• spawnLocation is the position (with rotation). If you use a dynamic value (a variable instead of a fixed position), the model is resolved per player.
• data is applied on top of the definition's data, so an instance can override one bone or glow of its definition.
• activity can be any shared or individual entity activity, for example a path from the road network. An individual activity makes each player see their own copy.