Bettermodel Definition

A BetterModel entity definition

实体由 BetterModel 提供

字段

字段	类型	默认值	描述
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） 字段 类型 默认值 描述 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） 字段 类型 默认值 描述 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

TypeWriter 通用字段（displayName）

字段	类型	默认值	描述
displayName	Var<String>	—	—

How to use it

• modelId is the name of a model loaded by BetterModel. If it is not found the extension falls back to a model named steve, and logs a warning.
• named shows displayName above the model as floating text, with the interaction indicator above it. nameOffset (default 2.3) is its height and showDisplayName can hide the name while keeping the indicator.
• defaultAnimationSettings maps entity states to animation names: idle, walk (only used when walkAnimation is on), strafe, jump, fly, attack, hurt and interact. The interact animation plays when a player clicks the entity; leave it empty to play nothing.
• focusOffset moves the point other systems look at (for example look-at), headLight adds a fake light block above the head (0 disables it), and hitboxes binds click boxes to bones.
• data accepts the generic entity data entries plus the BetterModel ones. Vanilla data that has no equivalent on a 3D model (poses, mob variants…) is ignored with a one-time log warning.