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 |
|---|---|---|---|---|
| AnimationName | String | configuration | "" | Required. Animator state name or full path; this field does not take an AnimationClip asset. |
| CrossFadeTime | Single | configuration | 0.1 | Blend duration in seconds; zero plays immediately. |
| WaitForComplete | Boolean | configuration | False | Wait for the internal operation before finishing this Action. |
| DurationMs | Int32 | configuration | 0 | Duration in integer simulation milliseconds. |
| 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
AnimationName=Base Layer.Attack, Layer=0, CrossFadeTime=0.1, WaitForComplete=true, DurationMs=600. Without waiting, finish after starting playback; waiting requires a positive simulation duration.
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.