AnimationNodeType

Used by AnimationNodeDefinition.NodeType to define how a node in an animation graph processes animation. Setting a node's type resets its input pins to the default set for that type.

For nodes that switch between inputs, see transitions for transition configuration and behavior.

ClipNode#

A reference to an AnimationClip asset. This serves as a leaf node in the graph, generating the raw animation data that feeds into other nodes for blending, selection, or modification.

Inputs#

• None

Properties#

PlayMode accepts the following values:

• Loop (default): Automatically restarts from the beginning once the clip finishes.
• PingPong: Plays from start to end, then immediately plays in reverse from end to start.
• OnceAndHold: Plays once and maintains the final pose upon completion.
• OnceAndReset: Plays once and snaps back to the initial start pose upon completion.

Event data#

• Event Handling: None. This is a leaf node with no children.
• Event Emission: Reads custom markers embedded in the animation clip (e.g., "Footstep", "WeaponSwing") and emits them as named events at the precise frame they occur. If the clip is trimmed, only markers within the defined [TrimStart, TrimEnd] interval (inclusive) are emitted.

SelectNode#

Selects between any number of inputs via the Selection property. Whenever the current selection changes, it triggers a new transition.

Inputs#

• Input1...InputN

Properties#

Event data#

• Event Handling: Events from the currently selected input pass through with their weight unchanged.
• Event Emission: Passes through all events from the currently selected input only. During a transition, event emission follows global event rules.

PrioritySelectNode#

Evaluates a list of connected inputs from top to bottom and plays the first one whose condition evaluates to true. This allows for hierarchical animation selection based on specific logic. Whenever the current selection changes, it triggers a new transition.

Inputs#

• Input1...InputN
  • Trigger (Boolean): A logical condition that must be true for this input to activate. This is wired to a boolean parameter.
  • TransitionOverrideInterruptible (AnimationNodeInterruptible): Defines the rule for when this active animation can be interrupted by a higher-priority input. Overrides the node-level DefaultInterruptible setting.
    • Always (default): The input can be interrupted at any time by a higher-priority condition.
    • Finished: The current animation must complete its playback before a higher-priority input can take over.
    • Trigger: The input is only interruptible when the InterruptibleTrigger is set to true.
  • InterruptibleTrigger (Boolean): Only available if TransitionOverrideInterruptible is set to Trigger. The input can be interrupted when this specific expression is true.

Properties#

Event data#

• Event Handling: Events from the currently selected input pass through with their weight unchanged.
• Event Emission: Passes through all events from the currently selected input only. During a transition, event emission follows global event rules.

SequenceNode#

Activates connected inputs in a specific sequential order based on defined wait conditions. Whenever the current selection changes, it triggers a new transition.

Inputs#

• Input1...InputN
  • TransitionOverrideWaitFor (AnimationNodeWaitFor): Specifies the condition that must be met before the sequence advances to the next input. Overrides the node-level DefaultWaitFor setting.
    • Finished (default): Advances to the next input when the current input completes a cycle. The advancement behavior depends on the connected input:
      • Play-once clip: Advances when the clip finishes.
      • Looping clip: Advances after one full loop completes.
      • Sequence with infinite loops: Advances after one full cycle through all inputs.
      • Sequence with finite loops: Advances after all loops complete.
    • Trigger: Activates the next input when a custom logical expression evaluates to true.
  • WaitForTrigger (Boolean): Only available when TransitionOverrideWaitFor is set to Trigger.

Properties#

Event data#

• Event Handling: Events from the currently active input pass through with their weight unchanged.
• Event Emission: Passes through all events from the currently active input in the sequence only. During a transition, event emission follows global event rules.

RandomSequenceNode#

Selects and plays one of its connected inputs at random. When the currently selected animation completes, the node randomly picks another input to play. Assign each input a specific weight to influence the probability of it being chosen. Whenever the current selection changes, it triggers a new transition.

Inputs#

• Input1...InputN
  • Weight (Number): Determines the probability of this input being selected; higher weights increase the chance of selection.

Properties#

Event data#

• Event Handling: Events from the currently active input pass through with their weight unchanged.
• Event Emission: Passes through all events from the currently active input in the sequence only. During a transition, event emission follows global event rules.

OverNode#

Layers the Over pose on top of the Base pose. When combined with a Mask node, masked-out joints in the Over pose reveal the Base pose entirely, creating a transparent overlay effect.

Inputs#

• Base: The background or bottom layer, typically a full-body animation like locomotion or an idle state.
• Over: The foreground or top layer to be applied over the base, such as a hand gesture or tool-use animation.

Properties#

Event data#

• Event Handling:
  • The node listens for events from both the Base and Over inputs.
• Event Emission:
  • Base Events: All events from the Base input are passed through unmodified.
  • Over Events: Events from the Over input are scaled by the Weight property.
    • At Weight 0.5, Over events propagate at half weight
    • At Weight 0, they are silenced.

AddNode#

Adds the Additive pose to the Base pose, attenuated by a specific Weight (unclamped).

Inputs#

• Base: The primary animation pose.
• Additive: The pose to be layered onto the base.

Properties#

Event data#

• Event Handling: The node listens for events from both the Base and Additive inputs.
• Event Emission: All events from both the Base and Additive inputs are passed through unmodified.

SubtractNode#

Converts an animation into an additive pose by subtracting a relative base pose from the target pose (A - Weight * B). The Weight scales the B pose before subtraction (unclamped).

Inputs#

• A: The target animation pose.
• B: The relative base pose to be subtracted.

Properties#

Event data#

• Event Handling: The node listens for events from both Input A and Input B.
• Event Emission: All events from both Input A and Input B are passed through unmodified.

OneShotNode#

Layers a OneShot pose over a looping Base pose whenever Trigger transitions from false to true, blending it in, holding it while it plays, then blending back out. This covers the common "fire an animation on an event" case (waves, punches, emotes, additive flourishes) in a single node, in place of composing an OverNode/AddNode/SubtractNode with a PrioritySelectNode and manually resetting a trigger every frame.

Inputs#

• Base: The looping or continuous pose played when no shot is active.
• OneShot: The pose played once, layered over Base, each time Trigger fires.

Properties#

BlendMode accepts the following values:

• Over (default): Layers OneShot on top of Base, matching AnimationNodeType.OverNode.
• Add: Adds OneShot to Base, matching AnimationNodeType.AddNode.
• Subtract: Subtracts OneShot from Base, matching AnimationNodeType.SubtractNode.

TransitionOutWhen accepts the following values:

• Finished (default): Starts the blend-out once the shot completes.
• BeforeFinished: Starts the blend-out one TransitionOutDuration earlier, so it lands on the shot's final frame.

Usage#

In the graph editor, bind Trigger to a Trigger parameter rather than a boolean parameter (right-click and select Insert Parameter. Chose Trigger from the list). A Trigger parameter evaluates like a boolean, but it automatically resets to false one frame after being set to true. This lets you set it true repeatedly — for example while spamming a button — without re-firing the shot every frame or needing to manually reset it from a script; the shot still only starts on a false-to-true edge of Trigger.

Event data#

• Event Handling: The node listens for events from both Base and OneShot.
• Event Emission: Base events pass through unmodified. OneShot events are scaled by the node's current blend weight — silent while inactive, at full weight during the hold phase.

Blend1DNode#

Linearly interpolates between the two animation poses closest to the current input position on a single axis.

Inputs#

• Input1...InputN
  • Position (Number): The specific coordinate for each subsequent input on the blend axis.

Properties#

PhaseSync accepts the following values:

• Synced (default): Uses normalized synchronization. The node calculates a "virtual duration" from the weighted average of active inputs. Each input node's time step adjusts so all children converge on the same phase, keeping animations of different lengths in lockstep.
• Unsynced: Clips advance independently at their own playback rates.

Event data#

• Event Handling: The node listens for events from all currently active child nodes.
• Event Emission: Only events from the highest-weight active input propagate, scaled by its blend weight. Events from the secondary input are silenced.

Blend2DNode#

Blends multiple animation poses together based on two input parameters within a 2D coordinate space. This generalizes the Blend1D node to handle complex scenarios, such as blending based on both movement direction and speed simultaneously.

Inputs#

• Input1...InputN
  • X (Number): The X-coordinate for each subsequent input.
  • Y (Number): The Y-coordinate for each subsequent input.

Properties#

InputMode accepts the following values:

• Cartesian (default): Uses standard 2D grid coordinates. X and Y represent the current position within the blendspace.
• Polar: Uses angular and magnitude values. X represents direction in radians, while Y represents movement magnitude or strength. Direction is weighted more heavily, so inputs at similar angles but different magnitudes blend more smoothly than inputs at different angles.

PhaseSync accepts the following values:

• Synced (default): Uses normalized synchronization. The node calculates a "virtual duration" from the weighted average of active inputs. Each input node's time step adjusts so all children converge on the same phase, keeping animations of different lengths in lockstep.
• Unsynced: Clips advance independently at their own playback rates.

Event data#

• Event Handling: The node listens for events from all currently active child nodes.
• Event Emission: Only events from the highest-weight active input propagate, scaled by its blend weight. Events from the secondary input are silenced.

MaskNode#

Applies a predefined mask to the input Pose. A mask is defined by a weight per object (e.g. joint) in the rig hierarchy, allowing for precise control or "feathering" of the animation.

Inputs#

• Pose: The animation pose to be masked.

Properties#

Mask can define weights in either of the following ways:

• Directly: The ObjectValue contains attributes that map rig object names to weight values.
• By Reference: The ObjectValue references another Instance with the mapping attributes, enabling shared masks across graph nodes.

To populate the mask hierarchy, choose a rig schema:

• HumanoidRigDescription: Standardizes the mask for humanoid characters.
• Picker: Lets you select any rig in the workspace to populate the mask hierarchy.

Event data#

• Event Handling: The node listens for all events from the input Pose.
• Event Emission: All events from the input Pose are passed through unmodified.

SpeedNode#

Modifies the playback rate of an incoming animation pose.

Inputs#

• Pose: The animation pose or subgraph whose playback speed will be modified.

Properties#

Event data#

• Event Handling: The node listens for events from the input Pose.
• Event Emission: All events from the input Pose are passed through unmodified. Note that while the visual playback speed changes, the timing of emitted events (such as markers) will scale accordingly with the modified playback rate.

GraphOutput#

Represents the final evaluated pose of the graph. This node is automatically included in all new graphs in the Animation Graph Editor. Its presence ensures that the graph is always valid and consistently produces an animation pose.

Inputs#

• Pose: The final processed animation data to be applied to the rig.

Properties#

• None

Event data#

• Event Handling: The node listens for all events passed through the final connected input.
• Event Emission: This node serves as the exit point for the animation pipeline and does not emit signals back into the graph.