unreal-motion-matching

Build, tune, and debug Motion Matching animation systems in Unreal Engine 5.8.

Updated May 28, 2023
One-click install
npx skills add https://github.com/steveulrich/ProjectB --skill unreal-motion-matching-steveulrich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unreal-motion-matching
Source: https://github.com/steveulrich/ProjectB/tree/main/.cursor/skills/unreal-motion-matching
Command: npx skills add https://github.com/steveulrich/ProjectB --skill unreal-motion-matching-steveulrich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up Motion Matching in Unreal Engine 5.8 involves many interdependent decisions—schema channels, database partitioning, trajectory prediction, Chooser filtering, and cost tuning—and mistakes produce symptoms like pose thrashing, foot sliding, and wrong gait selection that are hard to diagnose without a structured workflow. ## Core Features & Use Cases - System selection guidance: Decide when Motion Matching fits versus State Machines, Blend Spaces, or Montages based on animation data coverage and moveset style. - Schema and database construction: Create Pose Search Schemas with minimal trajectory and pose channels, build partitioned databases, and wire Choosers for context-based filtering. - Rewind Debugger diagnosis: Inspect Pose Candidates, feature costs, and Active/Continuing Pose to fix selection defects with evidence instead of blind weight changes. - Use Case: A character's locomotion thrashes between clips during stops. Use this Skill to record the moment in Rewind Debugger, identify that future trajectory fails to anticipate braking, and correct the prediction model before touching any weights. ## Quick Start Use the unreal-motion-matching skill to diagnose why my character's feet slide during stops and recommend the schema, database, and tuning changes to fix it.

Frequently Asked Questions about unreal-motion-matching

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Motion Matching in Unreal Engine 5.8?▼

Enable the Pose Search plugin, create a Pose Search Schema with trajectory and pose channels, build databases with root-motion clips, then add a Motion Matching node and Pose History node to the AnimGraph. Generate trajectory on Pose History and add all schema-sampled bones to Collected Bones.

When should I use Motion Matching vs a State Machine in Unreal Engine?▼

Use Motion Matching when a broad, coherent animation set should drive responsive locomotion through runtime pose selection. Keep a State Machine or Blend Space when the moveset is small, stylized, intentionally discrete, or lacks the data coverage to justify search.

Why does Motion Matching thrash between animation clips?▼

Thrashing usually comes from continuing pose bias, reselect history, or a noisy trajectory. Record the defect in Rewind Debugger, compare Active Pose, Continuing Pose, and Pose Candidates costs, then adjust one variable such as Continuing Pose Cost Bias or Pose Reselect History.

How do I fix foot sliding in Unreal Engine Motion Matching?▼

Check root-motion clip speed against capsule and trajectory speed first, then chosen frame and phase continuity, blend duration, stride or orientation warp scale, and ground-contact IK. Fix data or movement-speed disagreement before suppressing symptoms with weights.

Does Motion Matching require root motion animation?▼

Yes, Unreal Engine's documented locomotion setup expects root-motion animation with Enable Root Motion set on the clips. The root-motion speed distribution must also match the movement model, or the database repeatedly selects its maximum-speed pose.

What are the limitations of Motion Matching in UE 5.8?▼

Motion Matching cannot manufacture missing motion, so coverage gaps in speed, direction, starts, stops, or pivots must be fixed with authored or retargeted data. VPTree, Permutation Time, and Crashing Legs remain Experimental in UE 5.8, and search cost and memory grow with database density.