POBDS / 12
Play animation
Attach an Animator with a controller to the Actor object or a child. Enter the state name and layer, choose the blend duration and configure completion using simulation milliseconds. Missing Animator, controller or state fails the Action with a diagnostic.
Configuration
Parameters and pins
| Name | Type | Direction | Default | Meaning |
|---|---|---|---|---|
| StateName | String | configuration | "Idle" | Animator state name or full path, for example Base Layer.Attack; not a clip filename. |
| DurationMs | Int32 | configuration | 0 | Duration in integer simulation milliseconds. |
| BlendMs | Int32 | configuration | 100 | Blend duration in milliseconds; zero plays immediately. |
| Layer | Int32 | configuration | 0 | Zero-based Animator layer index; the state must exist on that layer. |
| FlowAction.Delay | Float (s) | configuration | 0 | Delay before entering this Action, in seconds quantized to simulation milliseconds; separate from an Action-specific wait duration. |
| FlowAction.EveryFrame | Boolean | configuration | false | Continuous execution option; for example, keep invoking a method each frame. Unfinished Actions still receive Update; this does not force completion or repeat Enter. |
| FlowAction.FinishEvent | String | configuration | "" | Optional event when this Action finishes; empty does not prevent the node from emitting FINISHED once every Action completes. |
| FlowAction.FailEvent | String | configuration | "" | Optional failure event for this Action; connect error handling as needed. Interruption is not success. |
Output / result: See execution completion rules
Example
Create an Attack state with a clip in Base Layer. Set StateName=Base Layer.Attack, Layer=0, BlendMs=100, DurationMs=600. Entry → Play character animation → FINISHED → Return. Completion uses the simulation clock, not normalized animation time.
Completion and interruption
An Action node advances when all Actions finish. Exit also runs on interruption, but interruption does not emit a false success. Milliseconds, seconds and world units are not interchangeable.