Unreal Engine 5 Animation Blueprint: Complete Setup Guide

Animation Blueprints in UE5

The Animation Blueprint (ABP) is the control system for character animation in Unreal Engine 5. It reads game state — character velocity, movement mode, orientation, input flags — and decides which animation plays, when, and how animations blend together. Understanding how to build and wire an Animation Blueprint is the core skill for implementing motion capture animation in UE5.

The Two Graphs

Every Animation Blueprint has two main graphs:

AnimGraph — The visual representation of animation logic. This is where you place State Machines, Blend Spaces, and other animation nodes. The output of this graph feeds directly to your character's skeletal mesh every frame.

Event Graph — Standard Blueprint logic that runs on tick, on begin play, and on events. This is where you read game state (velocity from the Character Movement Component, boolean flags, aiming state) and store it as variables that the AnimGraph reads.

Step 1: Create the Animation Blueprint

  1. In the Content Browser, right-click > Animation > Animation Blueprint.
  2. Select your character's skeleton (e.g., SK_Mannequin_Skeleton).
  3. Name it ABP_YourCharacter and open it.

Step 2: Set Up Variables in the Event Graph

Create the variables your AnimGraph needs:

  • Speed (Float) — character velocity magnitude for locomotion blending
  • Direction (Float) — movement direction angle for strafe blending
  • IsInAir (Boolean) — for jump/fall states
  • IsCrouching (Boolean) — for crouch states

In the Event Graph, on Event Blueprint Update Animation: Get a reference to your Pawn owner, cast to your Character class, then pull velocity from the Character Movement Component. Set Speed = velocity vector length. Calculate Direction using the built-in Calculate Direction function (pass velocity and actor rotation).

Step 3: Create a Blend Space

For locomotion, create a Blend Space 1D (for speed only) or Blend Space 2D (for speed + direction):

  1. Right-click in Content Browser > Animation > Blend Space 1D (or Blend Space).
  2. Assign your skeleton.
  3. Set axis labels: Horizontal = Speed (0–500 cm/s), Vertical = Direction (-180 to 180) for 2D.
  4. Drag your walk animation to the 150 cm/s position. Run animation to 400 cm/s. Idle at 0.
  5. For a 2D blend space, add left and right strafe animations at the directional extremes.

Step 4: Build a State Machine

  1. In the AnimGraph, right-click > Add State Machine. Name it "Locomotion."
  2. Inside the State Machine, create states: Idle/Walk/Run, Jump, Fall, Land.
  3. Connect the Locomotion state to the blend space you created.
  4. Add transitions: Idle/Walk/Run > Jump (condition: IsInAir == true). Jump > Fall (automatic after peak). Fall > Land (condition: IsInAir == false).
  5. In each transition, set rules based on your variables.

Step 5: Assign to Your Character

  1. Open your Character Blueprint.
  2. Select the Skeletal Mesh component.
  3. In Details > Animation, set Animation Mode to "Use Animation Blueprint."
  4. Set Anim Class to your ABP.

Importing Motion Capture Animations

Professional mocap clips drop directly into this system. Import your FBX animations via Content Browser > Import, assign the same skeleton, and check "Import Animations." The resulting Animation Sequence assets slot directly into your blend space or state machine states.

MoCap Online UE5 packs include locomotion, combat, idle, and interaction animation sets pre-built for the UE5 Mannequin skeleton — no retargeting needed for standard projects. Download the free pack to test the full import-to-ABP pipeline before purchasing.

Troubleshooting

Animation Blueprint compiles but character is in T-pose: The ABP is not assigned to the mesh component, or the ABP's skeleton does not match the mesh's skeleton.

Character slides at locomotion transitions: Blend space sample positions do not match actual character speeds. Tune the sample positions in the blend space to match your Character Movement Component's walk and run speed values.

Animation plays but with wrong speed: Frame rate mismatch between your FBX and project. Check the animation asset's frame rate and re-import if needed.

Animation Blueprint Fundamentals for Motion Capture Integration in UE5

Unreal Engine 5's Animation Blueprint system has become significantly more capable since UE4, and developers working with professional motion capture packs can leverage several UE5-specific features to build cleaner, more responsive character systems. Here are the UE5 Animation Blueprint concepts that matter most when integrating a motion capture library.

Linked Animation Layers. UE5 introduced Linked Anim Layers, which let you swap out entire sections of the Animation Blueprint graph at runtime — swapping a combat locomotion layer for an unarmed locomotion layer, for example, without rebuilding the base locomotion state machine. For motion capture packs, this means you can maintain a base locomotion layer that works across all character states and load weapon-specific or situation-specific animation layers on top, keeping the animation graph modular rather than building a monolithic state machine that grows unmanageable.

Motion Matching (UE5.4+). Motion Matching is Epic's system for selecting animation clips based on pose and trajectory matching rather than explicit state machine transitions. Instead of explicitly wiring up transitions between Walk, Run, and Jog states, Motion Matching selects the best-fitting clip from a database of motion capture animations at each frame. Professional motion capture packs with high clip-count locomotion libraries are ideal source material for Motion Matching databases — the more coverage the pack provides, the more natural the resulting locomotion feels. MoCap Online's locomotion packs include the directional, speed, and turn variants that make Motion Matching databases effective.

IK Rig and IK Retargeter for skeleton compatibility. If you are using a character that doesn't precisely match the UE5 Manny skeleton, UE5's IK Retargeter lets you map professional motion capture animations from the standard skeleton to your custom character skeleton with minimal distortion. Set up IK chains for the spine and limbs, define the root and pelvis mapping, and the retargeter propagates the mapping to every animation in your library at once. This is far cleaner than the UE4 retargeting workflow and makes it practical to use a standard skeleton motion capture library across multiple character builds with different proportions.

Animation Insights for debugging. When motion capture integration produces unexpected visual artifacts, UE5's Animation Insights tool makes diagnosis fast. Enable the Animation plugin, connect to a running PIE session, and the timeline shows exactly which clips are playing, how blend weights are distributed, and which transitions are firing at any frame. The tool eliminates the guessing that made debugging complex animation graphs painful in UE4.

Animation Blueprint Performance: What Actually Costs Frame Time

Animation Blueprints can become a significant source of CPU overhead in games with many characters. Understanding where the cost comes from lets you optimize intelligently rather than guessing.

Thread Update Mode and Multi-Threading

By default, Animation Blueprints update on the game thread. For complex graphs with many characters, this creates a bottleneck. Enable Use Multi-Threaded Animation Update in the Animation Blueprint class settings to shift evaluation to worker threads. This requires your Event Graph logic to be thread-safe — avoid accessing gameplay objects directly from the Anim Graph. Instead, cache values in the Event Graph and read those cached values in the Anim Graph.

Fast Path Optimization

Unreal's Fast Path optimization skips Blueprint bytecode evaluation for nodes that only read from member variables. A green lightning bolt on a node confirms it qualifies. Nodes that break Fast Path include: calls to custom functions, array accesses, and any node that writes to a variable. Structure your Anim Graph to maximize Fast Path coverage — the compiler will display warnings when nodes break it.

LOD-Based Animation Complexity

Assign animation quality by LOD level using the LOD Threshold settings on individual AnimGraph nodes. Disable expensive nodes (IK solvers, full-body physics, secondary motion layers) on LOD2 and beyond. Characters at distance don't need foot IK or spine aim offsets — the difference is invisible from gameplay camera distances but the CPU savings are significant when dozens of NPCs are active.

Animation Sharing Plugin

For crowd scenarios with many similar characters — soldiers, pedestrians, background workers — the Animation Sharing Plugin lets groups of characters share the same animation evaluation result. Characters in the same sharing group evaluate their Animation Blueprint once and copy the result to all group members. This is not suitable for player characters or characters with unique behavior, but dramatically reduces cost for background crowds where identical movement is acceptable.

Profiling with Animation Insights

Use Unreal's Animation Insights tool (part of Unreal Insights) to identify which parts of your Animation Blueprint cost the most. The tool shows per-node evaluation time across multiple characters simultaneously. Common findings: Layered Blend Per Bone nodes are expensive when the blend weight is always 0 or 1 — replace with conditional branching in those cases. Aim Offset nodes with wide angle ranges are cheaper to bypass with early-out logic when the character is not in aim state.