Skip to content

Attachment

Anywhere an attachment is expected you can write "self", "target" or an 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.