PoBDSDocs
简体中文v1.0.0
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

Actual editor node / inspector for this API. Click to inspect full resolution.

Parameters and pins

NameTypeDirectionDefaultMeaning
StateNameStringconfiguration"Idle"Animator state name or full path, for example Base Layer.Attack; not a clip filename.
DurationMsInt32configuration0Duration in integer simulation milliseconds.
BlendMsInt32configuration100Blend duration in milliseconds; zero plays immediately.
LayerInt32configuration0Zero-based Animator layer index; the state must exist on that layer.
FlowAction.DelayFloat (s)configuration0Delay before entering this Action, in seconds quantized to simulation milliseconds; separate from an Action-specific wait duration.
FlowAction.EveryFrameBooleanconfigurationfalseContinuous execution option; for example, keep invoking a method each frame. Unfinished Actions still receive Update; this does not force completion or repeat Enter.
FlowAction.FinishEventStringconfiguration""Optional event when this Action finishes; empty does not prevent the node from emitting FINISHED once every Action completes.
FlowAction.FailEventStringconfiguration""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.

Combine keywords with / · Enter opens first result · Esc closes