MMD & Blender Wiki


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.

  1. Open the Blender User Preferences menu and select the Add-ons tab (Edit > Preferences... > Add-ons)
  2. 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.
  3. After installing the mmd_tools-v0.0.0.zip file, Blender will filter the add-ons list to only show the mmd_tools add-on. Click the checkbox next to the title to enable the add-on.
  4. 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.

Installation-MMD tab

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 to 5 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.
    1. Sidebar > MMD > Model Setup > Assembly: Unbind Morph 🗑️
    2. Menu > File > Clean Up > Recursive Unused Data-Blocks
    3. 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

  • Improve compatibility with MMD physics
  • Add vertex group supplement feature

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.

  1. Head replace / swap (Chop & Join)
  2. Parts and accessories porting
  3. Clothes changing (Peel & Join)

【Blender】How_to_use_Model_Merge_feature-モデルマージ機能の使い方

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:

  1. Uninstall(remove) the old MMD Tools v1
  2. File ‣ Defaults ‣ Save Startup File
  3. Restart Blender
  4. 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 UI Sidebar[]

UI changes-v2.0-Old Sidebar MMD

Old 3D Viewport ‣ Sidebar ‣ MMD

UI changes-v2.0-Old Sidebar Misc

Old 3D Viewport ‣ Sidebar ‣ Misc

New UI Sidebar[]

UI changes-v2.0-New Sidebar MMD

New 3D Viewport ‣ Sidebar ‣ MMD

New UI Shading[]

UI changes-v2.0-New View3D Shading

New 3D Viewport ‣ Shading

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) 🗑