Gameplay animation

Gameplay animation runtime

AC_GameplayAnimation coordinates the active settings asset, action state, paired montage playback, animation overrides, and lean state.

Function	Use
`UpdateAnimationSettings`	Switches the active animation settings asset after the character and mesh are initialized.
`StartAction` / `EndAction`	Gates an active character or item action.
`PlayCharacterMontage` / `PlayItemMontage`	Plays synchronized character and item content.
`ResolveMontage`, `ResolveAnimInstance`, `ResolveAnimSequence`	Applies configured overrides before playback.
`UpdateLeaning`	Applies the runtime lean state.

Animation settings

is the data asset that selects the animation content and the procedural layers used by the character. is the editor-authored configuration asset used to organize those settings.

Section	Properties	What they control
General	`Idle Pose`, `Overlay Class`, `Procedural Layer Class`	Base pose and the Animation Blueprint classes that provide overlay and procedural layers.
Viewmodel Offset	`PivotOffset`, `WeaponOffset`, `RightHandOffset`, `LeftHandOffset`	Position, rotation, and scale adjustments for the first-person weapon and hand presentation.
Procedural Movement	`Idle`, `Walk`, `Sprint`, `Jump Start`, `Jump Loop`, `Jump End`	Motion asset, intensity, play rate, and offset for each movement state.
Aiming	`Ads Speed`, `Ads Easing`, `Ads Additive Blend`, `Ads FOV`	The transition and camera values used by the shooter animation layer while aiming.
Recoil	`Recoil Data`	The `DA_RecoilData` asset used by the shooter animation and recoil path.
Sway	Movement and aiming sway spring values	Position and rotation response to movement and aiming input.

Shooter animation settings

extends the settings contract for weapon presentation. It works with and ; the assigned Animation Blueprint must implement the interfaces expected by the configured layer classes.

Procedural Animation Blueprints

The supplied procedural choices include . The configured Animation Blueprint receives the character movement, gait, aim, lean, weapon, and viewmodel state through the shared animation interfaces. Its procedural layer combines the selected movement motion, additive or sway data, IK targets, viewmodel offsets, and the base pose, then returns the final pose to the character graph.

Apply a new settings asset

Create a project-owned asset or duplicate a supplied asset that you must keep unchanged.
Assign compatible idle, movement, aiming, overlay, and procedural-layer assets.
Confirm that the selected mesh, Skeleton, Animation Blueprint, and UE4 or UE5 animation family match.
Call AC_GameplayAnimation.UpdateAnimationSettings(NewSettings) after the character and mesh are initialized.
Use BP_GameplayAnimationOverride when only selected assets differ; keep the complete settings asset stable.

Do not mix a UE4 and UE5 animation family without verifying the Skeleton, retargeter, layer interfaces, and procedural graph.

Unreal Engine

Unity