Repository navigation
mmdance 0.1.0: MMD dances on any Mixamo-rigged Blender character
First release.
Claude_ChikaDance_10MB.mp4
The example production: a Tripo-generated character dances akomni's MMD motion チカっとチカ千花っ♡ (94 s) with the package's camera, facial track and song; the gown and hair are simulated. A 720p copy of the 1080p render.
A headless, config-driven Blender pipeline that makes a Mixamo-rigged character (Tripo, Meshy, Mixamo, AccuRig or a custom rig) perform a MikuMikuDance (MMD) dance:
- VMD → Mixamo retargeting: proxy MMD skeleton at the rig's joints, world-space transfer relative to MMD's A-pose, shared twist bones, analytic two-bone leg IK.
- MMD camera import, custom shots, and a follow camera when there is no camera VMD.
- Skirt, layered-gown and hair physics: automatic bone chains, a numpy position-based solver (jointed chains with angular limits, capsule and box colliders, inelastic contacts), baked to keyframes.
- Facial animation from VMD morphs: shape keys, or expression atlases for painted faces.
- Auto-rig repairs: hands rebuilt from finger bones, hair/cloth seam rip, rigid boot weights, cross-side leg weights.
- Stage, EEVEE render (parallel, resumable) and encoding with the song.
- CLI:
python -m mmdance new | inspect | vmd | build | stills | render | encode | qa.
Verified against the production it was built for (a 94 s dance with a Tripo-generated character): every cache, the face atlases and the rendered frames are reproduced exactly. It has only been run on one character so far, on Windows 11 with Blender 5.2 and MMD Tools 4.5.14. No characters, motions or music are distributed.