struct

AnimationState

A single animation state in the controller

Module
Animation
Header
#include "Animation/AnimationController.h"
Namespace
Mowo

Properties

TypeNameDescription
std::stringname
std::stringclipNameDurable clip reference. clipName is the authored identity — matched against AnimatorComponent::clips by AnimationClip::GetName() so reordering a model's clips (or sharing a controller across models) doesn't rebind the state. clipIndex is the resolved cache the runtime samples; it is filled from the name at bind time and, for legacy index-only assets with no name, kept as the serialized fallback.
std::stringclipIdThe AnimSequence package's id, when the clips come from packages. It wins over the name — UE references an AnimSequence as an asset, and a clip renamed in its package, or two meshes' clips of one name sharing a skeleton, still bind to the asset the state was authored against.
int32_tclipIndexresolved from clipId/clipName; representative/ Default -1.
floatspeedtiming clip for a blend-space state Default 1.0f.
boolloopDefault true.
booluseBlendSpaceOptional 1D blend space (locomotion). When useBlendSpace is set, the state additionally blends two clips chosen from blendSpace1D by the float param blendParam; the AnimationSystem samples bsClipA/bsClipB at the state's current time and blends by bsWeight (see UpdateResult). clipIndex still drives timing + transition exit-time. Default false.
BlendSpace1DblendSpace1D
std::stringblendParam
booluseBlendSpace2DOptional 2D blend space (8-way directional locomotion). When useBlendSpace2D is set the state blends up to 3 clips chosen from blendSpace2D by (blendParamX, blendParamY); the AnimationSystem samples them phase-matched (see UpdateResult::bs2*). clipIndex is still the representative/timing clip. Takes precedence over the 1D blend space. Default false.
BlendSpace2DblendSpace2D
std::stringblendParamX
std::stringblendParamY
booluseMotionMatchingMotion-matching state: the pose comes from the entity's MotionMatchingComponent database instead of clipIndex. clipIndex still drives timing + transition exit-time, so authoring stays unchanged. Default false.
std::stringsyncGroup
EAnimSyncRolesyncRoleDefault EAnimSyncRole::Auto.
Ref<class AnimationController>subMachineNested state machine (I5). A state carrying one has no clip of its own: while it is active the machine inside decides the pose, and the PARENT still owns the transitions in and out. Entering the state re-enters the nested machine at its default state, so a sub-graph never resumes mid-stride from the last time the parent visited it.
std::vector<AnimationTransition>transitionsOutgoing transitions from this state
Generated from Animation/AnimationController.h via animation.json · Oct 26, 2026Version 1.0.0