Attachment
Anywhere an attachment is expected you can write "self", "target" or an object.
attach object
Section titled “attach object”Where a track sits. Also accepts the strings “self” and “target”.
| Field | Type | Default | Description |
|---|---|---|---|
anchor |
"self" | "target" |
"self" |
Which anchor to use: the effect’s own, or the target set with .to(...). |
bone |
bones | A bone name or a list of names to try in order, such as ["chest", "body"]. Falls back to the anchor itself when none exist. |
|
offset |
vector | [0,0,0] |
Offset in blocks, in the frame of the anchor (x right, y up, z forward). |
rotate |
vector | [0,0,0] |
Extra rotation in degrees: pitch, yaw, roll. |
follow |
boolean | true |
Keep following the anchor. When false the track stays where it started. |
align |
"body" | "head" | "world" | "camera" | "bone" |
"body" |
Which way the frame faces: the entity’s body, its head, the world axes, the camera, or the bone it is attached to, following the bone as it swings (up runs along the bone toward its parent). |
Bone names come from the model. Vanilla and anything baked from layer definitions use the part names, such as head, body, right_arm and left_leg. GeckoLib models use their bone names. Add :tip for the far end of the part or :center for its middle, for example right_arm:tip for a hand. A list is tried in order, so ["chest", "body:center"] works across models.
