PureMotion

Kuruma in Import & Export

(This documentation is for the original version of PureMotion and is currently not updated with all the new features)

Kuruma's Animation Toolbox 

So you’ve got mocap data. It’s noisy, the feet slide, euler flips are everywhere, and you need it clean enough for games. Kuruma's Animation Toolbox is made for that: cleaning, fixing, and preparing character animation inside Blender.Here’s what it does and how to use it.

Requirements

  • Blender 5.0 or newer
  • An armature with an active action (the add-on works on your current animation)

Installation

  1. Download the add-on .zip from your purchase.
  1. In Blender: Edit → Preferences → Add-ons.
  1. Click Install and choose the .zip file.
  1. Enable Kuruma's Animation Toolbox.
  1. The toolbox appears in the 3D Viewport sidebar (press N), under the Kuruma category.

Quick Start

  1. Select your rigged character (armature).
  1. Make sure it has an action assigned.
  1. Open the Kuruma panel in the 3D Viewport sidebar.
  1. Choose a rig preset (Mixamo, UE Mannequin, Rigify, Rokoko, or Custom).
  1. Use Apply or Auto-Detect to map bones.
  1. Start with Save Snapshot before big changes, then work through the sections below.

Features

Rig presets

Rig types differ in bone names. The add-on supports Mixamo, UE Mannequin, Rigify, Rokoko, or Custom.
  • Apply — Fills bone fields from the selected preset.
  • Auto-Detect — Tries to recognize your rig from its bone names.
Helps avoid manually entering every bone name.

Cleanup

Keyframe decimation

Mocap often has far more keyframes than you need. Decimation removes redundant ones while keeping the motion.
  • Error threshold — Higher values remove more keys; lower values keep more detail. Try around 0.05 and adjust.
  • Preserve first/last — Keep start and end keyframes (usually what you want).

Noise filter

Reduces jitter and noise without killing important motion. Three filters:
  • Moving average — Simple, fast.
  • Gaussian — Smoother, good default.
  • Butterworth — Low-pass style, useful for clean curves.
  • Strength — 0 = original, 1 = fully filtered. Start around 0.5.
  • Iterations — Multiple passes for more smoothing.
  • Window size — Neighbors considered; larger = smoother.
  • Preserve first/last — Keep start and end values intact.

Euler filter

Rotation curves sometimes flip by 180°. This cleans those discontinuities. One click, no extra settings.

Scale correction

Useful when units don’t match (e.g. cm vs m). Scale factor multiplies all location data.
  • 0.01 — cm → m
  • 100 — m → cm

Root motion

Common need for game engines: character moves in place while the root holds the world-space movement.
  1. Add root bone — Create a root at the origin. “Reparent Existing Bones” keeps your hierarchy organized.
  1. Bake in-place — Choose the source bone (usually Hips or Pelvis). Movement is baked onto the root; character stays in place.
  1. F-curve extraction — Direct extraction from hip/pelvis F-curves to a root bone (more advanced workflow).

Foot tools

Sliding reduction

Detects when feet are on the ground and smooths horizontal motion during contact.
  • Left/Right foot bones — Foot bone names (or toe/heel).
  • Height threshold — Z height below which contact is assumed.
  • Smooth strength — 0.85 is a good starting point; tweak per clip.

Foot IK setup

Adds IK targets for both feet and bakes FK into them. Optional pole targets for knee direction.
  • Chain length — 2 = typical leg (thigh + shin).
  • Create pole targets — Optional, for controlling knee bend.

Pin feet to ground

During detected ground contact, IK targets are pinned to the ground. Use Pin Blend Frames to ease in and out of contact.

Looping

Smart loop finder

Scans the clip for poses that match a reference frame so you can cut to a clean loop.
  1. Move the playhead to a good start pose.
  1. Click Use Current Frame to set the reference.
  1. Set Min loop length.
  1. Click Find Loop Points.
  1. Inspect the suggested match; lower score = better match.
  1. Trim to Loop to keep only the looped range.

Loop blend

Smooths start and end so the clip loops cleanly. Blend Frames controls how many frames are blended; 10 is a solid default.

Export

Export FBX for Unreal — One-click export with common Unreal settings: deform bones only, no leaf bones, correct axes. Select the armature (and mesh if needed) and export.

Batch processing

For blend files with many actions, the Batch Process panel lets you apply decimation, smoothing, euler filter, and loop blend across all actions at once. Use checkboxes to choose operations, then run once.

Snapshots

Save Snapshot stores a copy of the current action before major edits. Restore Snapshot brings it back. Useful when experimenting.

Suggested workflow

  1. Save Snapshot — Backup before edits.
  1. Apply preset or Auto-Detect — Map bones.
  1. Euler filter — Fix rotation flips first.
  1. Smooth — Reduce noise (Gaussian, strength ~0.5).
  1. Decimate — Trim unnecessary keyframes.
  1. Foot tools — Fix sliding and, if needed, add foot IK.
  1. Root motion — Add root bone and bake in-place if needed.
  1. Loop — Use smart loop finder or loop blend for cycles.
  1. Export FBX — Export for Unreal or other tools.
Adjust order depending on the clip and target.

Bone targeting

In the main panel you can choose All Bones or Selected Bones. Use Selected Bones when you only want to affect specific bones (e.g. arms only, or only the upper body).

Tips

  • Start with small changes and test often. Undo works; Snapshots add safety.
  • Use Selected Bones when experimenting on a single limb or region.
  • For strong smoothing, increase iterations or window size instead of maxing strength.
  • After decimation, inspect playback to ensure important accents aren’t lost.
  • For Unreal, bake root motion before export.

Need help?

If something doesn’t work as expected, share your Blender version, rig type, and what you tried. Common issues:
  • Armature has no Action — Assign an action in the Dope Sheet or Action Editor.
  • No suitable loop points found — Lower min loop length, or use a different reference frame.
  • Bone not found — Double-check preset or bone names (case-sensitive).
Thanks for using Kuruma's Animation Toolbox.Have fun, and keep animating.

  • Take your mocap and animation creation to the next level PureMotion, your gateway to a stress free fixing and cleaning experience.

    $16

  • A new and improved addon built ontop of the current PureMotion! Features a ton of new panels to utilise and an all new UI overhaul.

    $25
$16

Have questions about this product?
Login to message

Details
Blender Extension Compatible Yes
Published 7 months ago
Blender Version 5.0
Extension Type Add-on
Render Engine Used Arnold, Blender-Internal, Blender-Game-Engine, Cycles, Eevee, Freestyle, Luxrender, Mental-Ray, Octane, Vray, Yafaray
License GPL

Kuruma

Visit Website See all items by this creator
Discover more products like this

root animation Blender time saver decimate blend loop tool Export mocap