How to set up MotionAnimInstance

Use this guide when an Animation Blueprint should consume Motion movement tags and ground data.

Set the parent class

1. Create or open the character Animation Blueprint.
2. Open Class Settings.
3. Set Parent Class to MotionAnimInstance.
4. Compile the Animation Blueprint.

Map GameplayTags to variables

1. Open the Animation Blueprint Class Defaults.
2. Find GameplayTagPropertyMap.
3. Add entries for the tags your graph needs.

Common mappings:

GameplayTag	Property	Type
Motion.State.Walking	bIsWalking	Boolean
Motion.State.Sprinting	bIsSprinting	Boolean
Motion.State.Crouching	bIsCrouching	Boolean
Motion.State.Jumping	bIsJumping	Boolean
Motion.State.StaminaDepleted	bIsStaminaDepleted	Boolean

The properties must already exist in the Animation Blueprint and match the expected type.

Use Motion data in the graph

• Use mapped booleans for state machine transitions.
• Use GroundDistance for landing preparation or foot IK.
• Use CurrentFirstPersonItemConfig when item-linked animation logic needs the active local item config.

Verify binding

1. Start PIE.
2. Check bIsAbilitySystemBound.
3. If it remains false, confirm the PlayerState exposes an ASC through IAbilitySystemInterface.
4. Enable logs if binding is delayed:

log LogMotionAnimation Verbose
log LogMotionCore Verbose
showdebug abilitysystem