for Blender 3.6 LTS and older[]
Download[]
Download the latest mmd_tools-v0.0.0.zip
file from the GitHub Release page.

Installing the Add-on[]
The easiest way to install the cvcvcvc is to do so through directly through Blender.
- Open the Blender User Preferences menu and select the Add-ons tab (Edit > Preferences... > Add-ons)
- Click the open... or Install... button at the top of the Add-ons menu. This will open a file menu where you can select the
mmd_tools-v0.0.0.zip
file. - After installing the
mmd_tools-v0.0.0.zip
file, Blender will filter the add-ons list to only show themmd_tools
add-on. Click the checkbox next to the title to enable the add-on. - Restart Blender. A Blender restart is maybe required to complete the installation.

Only one version of the add-on should be installed at a time.
On installation, MMD
tab will become available from the Sidebar.

MMD Tools v2.10.3[]
Released on May 27, 2024
- Avoid Bone ID conflict during merging models
- Blender 4.x is not supported yet
- Blender 4.x compatible version is under development in the blender-v4 branch
MMD Tools v2.10.2[]
Released on December 17, 2023
- Suppress exceptions for missing group objects.
- Blender 4.x is not supported yet
- Blender 4.x compatible version is under development in the blender-v4 branch
MMD Tools v2.10.1[]
Released on December 7, 2023
- v2.10.1 is intended to avoid conflicts with versions for Blender 4.x that will be released at a later date
MMD Tools v2.10.0[]
Released on November 15, 2023
- Make bone IDs unique with Join in Model Surgery
- Solve bone id not unique issue when joining models
MMD Tools v2.9.2[]
Released on September 21, 2023
- Joining models with material morphs now works correctly in Model Surgery
MMD Tools v2.9.1[]
Released on August 30, 2023
- Bone morphs now work correctly
MMD Tools v2.8.1[]
Released on March 18, 2023
- Fix and add Chinese translations
MMD Tools v2.8.0[]
Released on October 17, 2022
- Fix corrupted order of materials when exporting
- Set default
ik_loop_factor
to5
for import
MMD Tools v2.7.0[]
Released on October 08, 2022
- Fix 3 problems
- Fixed bone morph exception
- Fixed _getVisibilityOfMMDRigArmature exception
- FIxed rigidbody data loss and regeneration
- Remove dependency on camera property hooks
- MMD Camera motion can be baked and used in a render farm
MMD Tools v2.6.1[]
Released on September 15, 2022
- Solve the slowdown problem when binding a model with many Material Morphs
MMD Tools addon creates as many shader group nodes as there are material morphs. This behavior is unavoidable.
Therefore, we added a button (Sidebar > MMD > Model Setup > Misc: Clean Duplicated Material Morphs
) to clean unwanted/duplicated material morphs.
In addition, morph node groups were streamlined to improve speed.Sidebar > MMD > Model Setup > Assembly: Unbind Morph 🗑️
Menu > File > Clean Up > Recursive Unused Data-Blocks
Sidebar > MMD > Model Setup > Assembly: Bind Morph
MMD Tools v2.6.0[]
Released on September 9, 2022
- Partial support for library override workflow
MMD Tools v2.5.1[]
Released on August 30, 2022
- Fix material morph to work for object materials
MMD Tools v2.5.0[]
Released on August 27, 2022
- Multiple MMD models can be imported without material morph conflicts
- Morph (longer) Settings can be folded
- Fix creation of objects in unexpected collections
- Temporary Group
- Model Surgery can be performed by specifying a target collection
MMD Tools v2.4.0[]
Released on July 1, 2022
MMD Tools v2.3.0[]
Released on June 7, 2022
- Support for Blender 3.2
- Physics Build generates bonetracks and temporary ncc under selected collections
- Alleviated issue #9 that bonetracks and temporary ncc created in other collection
- 【IK Bug】Fix the difference between blender's IK pose and MMD's IK pose.
- error no attribute 'proxy' in 3.2
- Expose MMDShaderDev Color and Alpha sockets
MMD Tools v2.1.0[]
Released on February 18, 2022
Model Merge feature has been implemented[]
With this feature, the following model editing can be easily achieved.
- Head replace / swap (Chop & Join)
- Parts and accessories porting
- Clothes changing (Peel & Join)
MMD Tools v2.0.0[]
Released on January 1, 2022
How to update from v1
[]
Updating from v1
to v2
involves an internal structure change of data, which may cause problems if the v1
data is still in the Startup File.
In order to avoid this problem, please follow the steps to update:
- Uninstall(remove) the old MMD Tools
v1
- File ‣ Defaults ‣ Save Startup File
- Restart Blender
- Install new MMD Tools
v2
UI improvements and changes[]
The New UI elements are organized by function. If you do not want to create MMD models, you can use the simple UI by unchecking Enable MMD Model Production Features in the Preferences. See MMD Tools/Manual#Add-on_Preferences for details.
Old/New UI elements mapping[]
Old UI | New UI | |
---|---|---|
Operator ‣ Create Model | Model Production ‣ Create Model | |
Operator ‣ Convert Model | Model Production ‣ Convert Model | |
Operator ‣ (Update World) | Scene Setup ‣ Update World | |
Operator ‣ Convert Materials For Cycles | Model Setup ‣ Material: Convert to Blender | |
Operator ‣ Separate By Materials | Model Setup ‣ Mesh: Separate by Materials | |
Operator ‣ Join Meshes | Model Setup ‣ Mesh: Join | |
Operator ‣ Attach Meshes to Model | Model Production ‣ Attach Meshes | |
Operator ‣ Translation | Model Production ‣ Translate | |
Operator ‣ (Experimental) Global Translation | Model Production ‣ (Translation) 🪟 Model Setup ‣ Misc: (Experimental) Global Translation | |
Operator ‣ Bone Constraint: Apply | Model Setup ‣ Assembly: Bone | |
Operator ‣ Bone Constraint: Clean | Model Setup ‣ Assembly: (Bone) 🗑 | |
Operator ‣ Physics: Build/Clean | Model Setup ‣ Assembly: Physics | |
Operator ‣ Edge Preview: Create/Clean | Model Setup ‣ Material: Edge Preview | |
Operator ‣ Edge Preview: Clean | Model Setup ‣ Material: (Edge Preview) 🗑 | |
Operator ‣ Model, Motion, Pose: Import/Export | Scene Setup ‣ Model, Motion, Pose: Import/Export | |
MMD Display ‣ Mesh | Model Setup ‣ Visibility: Mesh | |
MMD Display ‣ Armature | Model Setup ‣ Visibility: Armature | |
MMD Display ‣ Temporary Object | Model Setup ‣ Visibility: Temporary | |
MMD Display ‣ Rigid Body | Model Setup ‣ Visibility: Rigid Body | |
MMD Display ‣ Rigid Body Name | Model Setup ‣ Visibility: (Rigid Body Name) | |
MMD Display ‣ Joint | Model Setup ‣ Visibility: Joint | |
MMD Display ‣ Joint Name | Model Setup ‣ Visibility: (Joint Name) | |
MMD Display ‣ Toon Texture | Model Setup ‣ Material: Toon Texture | |
MMD Display ‣ Sphere Texture | Model Setup ‣ Material: Sphere Texture | |
MMD Display ‣ Property Drivers | Model Setup ‣ Assembly: Property | |
MMD Display ‣ (IK Toggle) | Model Setup ‣ IK Toggle | |
MMD Shading ‣ GLSL/Shadeless/Reset | 3D Viewport ‣ Shading ‣ MMD Shading Presets: GLSL/Shadeless/Reset | |
MMD SDEF Driver ‣ Bind | Model Setup ‣ Assembly: SDEF | |
MMD SDEF Driver ‣ Unbind | Model Setup ‣ Assembly: (SDEF) 🗑 |