Blender Free Plugins · Tutorial bf-06
Reusable Bone Mappings with Expy Kit
Use the GPL Expy Kit addon to define bone-mapping presets once and reuse them across every character in your project. Production-grade retargeting hygiene, free. Part of the MasterAllArts Creative 3D Roadmap.
Part of the MasterAllArts Creative 3D Roadmap .
Expy Kit by Paolo Acampora (pKrime) is a GPL-3 toolkit for armature manipulation in Blender. Among many other tools it includes a clean bone-mapping preset system — define a mapping once, save it as a JSON, and apply it to any matching armature later.
If you do retargeting two or three times, addon-driven mapping is fine. If you do it across a whole project, this is the skill that saves you hours.
What it adds
Expy Kit gives you tools spread across a few places. The ones most relevant to retargeting:
- Armature → Convert Bone Names — apply a preset to rename one rig’s bones to match another’s convention.
- Armature → Sideline → Extract Mapping — read the rig’s current bone structure into a mapping file.
- Pose → Action Retarget — apply a mapping to copy a baked action between rigs.
- N-panel → Expy Kit → Presets — load and save mapping presets.
It’s broader than just retargeting (it also has rig-conversion and IK utilities), but the preset-driven mapping is the killer feature for this series.
Install
- Clone or download the Expy-Kit repo as a ZIP from GitHub.
- Edit → Preferences → Add-ons → Install and select the ZIP.
- Search “Expy Kit” and tick the checkbox.
After enabling, you’ll see new menu entries under Armature, Pose, and Object as listed above.
The preset format
A preset is a JSON file describing a bone-name mapping:
{
"name": "mixamo-to-rigify-def",
"source_skeleton": "mixamo",
"target_skeleton": "rigify-def",
"bones": {
"mixamorig:Hips": "torso",
"mixamorig:Spine": "DEF-spine.001",
"mixamorig:Spine1": "DEF-spine.002",
"mixamorig:Spine2": "DEF-spine.003",
"mixamorig:Neck": "DEF-spine.004",
"mixamorig:Head": "DEF-spine.006",
"mixamorig:LeftUpLeg": "DEF-thigh.L",
"mixamorig:LeftLeg": "DEF-shin.L",
"mixamorig:LeftFoot": "DEF-foot.L",
"mixamorig:LeftArm": "DEF-upper_arm.L",
"mixamorig:LeftForeArm": "DEF-forearm.L",
"mixamorig:LeftHand": "DEF-hand.L"
}
}
Save the file under your Blender config directory at presets/expy_kit/bone_mappings/. After a Blender restart it appears in the Expy Kit preset dropdown.
If you’ve ever managed Auto-Rig Pro
.bmapfiles, this is the same idea with a saner format.
Build your first preset
The easy path is to extract from an existing rig:
- Select a Mixamo armature.
- Armature → Sideline → Extract Mapping. Expy Kit reads the bone hierarchy and offers it as a starting JSON.
- Edit the file to add the target side: replace each value with the corresponding Rigify bone name.
- Save it under
presets/expy_kit/bone_mappings/mixamo-to-rigify-def.json.
Now any time you import a new Mixamo animation, you can apply the preset without re-mapping by hand.
Apply a preset to retarget
With both armatures in the scene:
- Select the target armature (Rigify rig).
- Pose → Action Retarget.
- Set:
- Source Armature: the Mixamo rig
- Mapping Preset:
mixamo-to-rigify-def(the one you just saved) - Bake Range: full action length
- Click Retarget.
Expy Kit creates the constraints, bakes them out, and removes them — the same workflow as bf-05, automated.
Bone-name conversion (the other power)
Expy Kit can also rename the source rig’s bones to match a target convention without retargeting. Useful when:
- You want to use a Mixamo animation but ship the rig with cleaner bone names.
- You want to merge two animations from different sources onto a single named skeleton.
Armature → Convert Bone Names → [preset] does this in place. Make a backup first; bone renames break drivers and constraints downstream.
Common pitfalls
- Preset doesn’t appear after saving. You saved it under the wrong directory. Open Blender’s text editor, run
import bpy; print(bpy.utils.user_resource('SCRIPTS')), and look underpresets/expy_kit/bone_mappings/relative to that path. - Bones map but the result is twisted. Mapping by name doesn’t fix bone-roll mismatches. Run
Armature → Recalculate Rollon both rigs with the same convention before extracting the preset. - Action Retarget fails silently. Expy Kit assumes both rigs are in the same rest pose. If they’re not, retargeting either does nothing visible or produces garbage. Snapshot both to the same rest pose first.
Where this saves you time
A single preset works across:
- Every character generated with MB-Lab + rigged with Rigify (target side stays the same).
- Every animation you download from Mixamo (source side stays the same).
Once you have one Mixamo→Rigify preset you trust, your per-animation retargeting time drops to ~30 seconds: import FBX, select target rig, pick preset, click Retarget.
Next
- Webcam mocap with BlendArMocap — produce your own animations and retarget them with the preset you just built.