state_machine

Files live in animations/. Used by state_machine · machine.

A state machine switches a player between clips. start is the state entered first; [states] maps each state to the clip it plays from the player's library (an empty clip is the state's own name). Each transition names from and to, a fade in seconds, an advance (disabled never fires, enabled fires only on animation.travel, auto also fires on its own), a switch (immediate once any fade already running has finished, sync the same keeping the playhead, at_end fading so the fade ends with the clip) and an optional condition that animation.set_condition turns on.

type = "state_machine"
start = "idle"

[states]
idle = "idle"
walk = "walk_cycle"

[[transitions]]
from = "idle"
to = "walk"
fade = 0.2
advance = "auto"
condition = "moving"