POBDS / 12
PlayAnimation
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
Entry → Action [PlayAnimation] → FINISHED → Return. Use FAILED for error handling. Enable continuous updates only where needed.
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.