motion-pipeline

What problem does it solve?

This Skill prevents broken, hand-wavy animation pipelines by turning raw BVH motion-capture files into consistent, game-usable motion data (trajectory, pose, contacts, and IK results).

Core Features & Use Cases

• CPU-only motion processing: Run BVH import, contact detection, decomposition, blending, and FABRIK IK using numpy/scipy with no GPU or PyTorch requirement.
• Game-ready outputs: Produce root trajectories, per-joint local Euler angles, contact frame windows for events, and TypeScript MoveFrame functions for gameplay animation.
• Use Case: Generate a roundhouse-kick MoveFrame with an impact window derived from toe/hand contacts, then drive combat timing (damage, VFX, sounds) from the detected contact frames.

Quick Start

Convert a BVH into a TypeScript MoveFrame by running the motion-pipeline generate-move-ts command on your .bvh file and redirect the output to a .ts file.