Home

Welcome to the mmd_tools_append wiki!

日本語ページはこちら！

mmd_tools_append is a blender addon for adjust scenes, models and materials in concert with MMD Tools.

Installation

Download

Download mmd_tools_append from the github release page

• https://github.com/MMD-Blender/blender_mmd_tools_append/releases

Installing the Addon

Only one version of the addon should be installed at a time. If you are updating the addon to a new version, the previous version must be first uninstalled.

The easiest way to install the mmd_tools_append 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 Install... button at the top of the Add-ons menu. This will open a file menu where you can select the mmd_tools_append addon .zip file.
3. After installing the addon .zip file, Blender will filter the addons list to only show the mmd_tools_append addon. Click the checkbox next to the title to enable the addon.
4. Restart Blender. A Blender restart is maybe required to complete the installation.

Requirements

• Blender 4.2 LTS or later
• blender_mmd_tools v4.2.1 or later

(Optional) Rigify add-on

If you want to use MMD Rigify Integration feature.

1. Open Blender and go to Preferences then the Add-ons tab.
2. Click Rigging then Rigify to enable the script.

(Optional) 7-zip or p7zip-full

If you want to extract 7-zip archives in Asset search feature.

OS	Installation instructions
Windows	https://www.newsgroupreviews.com/7-zip-installation.html Then add to the PATH, and then reboot the OS.
Linux	Run command sudo {apt,yum,dnf,snap} install p7zip-full
macOS	Run command {sudo port,brew} install p7zip

(Optional) WinRAR or unrar

If you want to extract RAR archives in Asset search feature.

OS	Installation instructions
Windows	https://www.newsgroupreviews.com/winrar-installation.html Then add to the PATH, and then reboot the OS.
Linux	Run command sudo {apt,yum,dnf,snap} install unrar
macOS	Run command {sudo port,brew} install unar

Usage

YouTube video available

How to use MMD UuuNyaa Tools / MMD UuuNyaa Toolsの使い方

MMD Rigify Integration

MMD Rigify integration feature / MMD Rigify統合機能の使い方

Convert a MMD armature to Rigify compatible

1. Select a target MMD armature
2. Goto 3D Viewport > Sidebar > MMD > Append Operator Panel
3. Press Add Metarig
   • check the Clean Koikatsu Armature if you want to use koikatsu export models #23
4. Select the Metarig that was added
5. Goto Properties > Object Data Properties > Rigify Buttons Panel
6. Press Generate Rig
7. Remove (or Hide) unnecessary Metarig
8. Select the MMD and Rigify armatures
9. Press Integrate Armatures

Convert a Rigify armature to MMD compatible

1. Select a target Rigify armature
2. Goto 3D Viewport > Sidebar > MMD > Append Operator Panel
3. Press Convert to MMD compatible
4. Press Apply MMD rest pose

Rigify de-rigger

You can de-rig Rigify to remove control bones automatically (only DEF- bones will remain.) This will come in handy when converting Rigify models to MMD.

Control the armature properties

1. Select a target Armature
2. Goto 3D Viewport > Sidebar > Item > MMD Append Rigify Panel

Property	Range	Description
MMD-Rigify > Bind	Weak 0⇔1 Strong	The binding strength of MMD bones to Rigify bones
MMD-Rigify > Eyes	MMD 0⇔1 Rigify	Eyes control switch
MMD-Rigify > Leg.L/R	MMD 0⇔1 Rigify	Legs control switch
MMD-Rigify > Toe.L/R	MMD 0⇔1 Rigify	Toes control switch
IK-FK > Arm.L/R	IK 0⇔1 FK	Arms IK-FK control switch
IK-FK > Leg.L/R	IK 0⇔1 FK	Legs IK-FK control switch

Asset search

1. Goto 3D Viewport > Sidebar > Assets > Append Asset Search Panel
2. Use Query and Results

Icons in the search results

Icon	State	Description	Storage path in Preferences
⏳	Downloading	The asset is downloading	Asset Cache Folder
☆	Cached	The asset has been downloaded and is being cached	Asset Cache Folder
★	Extracted	The asset is unpacked (eg. unzip, unrar).	Asset Extract Folder

How to use unofficial assets

Click here for the list of available assets.

1. Goto 3D Viewport > Sidebar > Assets > Append Assets Operator Panel
2. Open ▼ Debug pane
3. Edit Query to {'state': 'open', 'milestone': 1}
4. Press Update Assets JSON by query
5. Press Reload Asset JSONs

Setup Eevee render

1. Goto 3D Viewport > Sidebar > MMD > Append Operator Panel
2. Press Setup Render Engine for Eevee

Setup ligihting

1. Goto Properties > World Properties > MMD Append Lighting Panel
2. Choose lighting thumbnail icon

Available lighting presets

Left Accent	Double Side Accent	God Ray	Backlight	Shadowless	Light Probe Grid

Setup materials

1. Goto Properties > Material Properties > MMD Append Material Panel
2. Choose material thumbnail icon

Example of Metal Noble and Gem

Available material presets

Reset	Transparent

Eye Highlight	Eye White	Eye Iris	Eye Lash

Hair Matte

Skin Mucosa	Skin Bump

Fabric Cotton	Fabric Silk	Fabric Bump	Fabric Wave	Fabric Knit	Fabric Leather

Plastic Gloss	Plastic Matte	Plastic Emission	Plastic Bump

Metal Noble	Metal Base

Stone Gem

Liquid Water	Liquid Cloudy

Artistic materials

Watercolor material / 水彩画マテリアル

Artistic Watercolor

Setup material adjuster

Material Adjust feature / マテリアル調整機能の使い方

1. Goto Properties > Material Properties > MMD Append Material Adjuster Panel
2. Choose Adjuster

This feature only supports materials that are output from a Principled BSDF.

Wet Adjuster

This adjuster uses vertex color to apply a wetting effect. The red channel of the vertex color corresponds to the wet 0 ⇔ 1 dry state.

"Wet" vertex color	Result

You can also switch between multiple vertex colors.

Property	Description
Specular	Specify the base Specular
Roughness	Specify the base Roughness

Physics Converter

How to use Physics Adjuster feature/物理調整機能の使い方

1. Goto 3D Viewport > Sidebar > MMD > Append Physics Panel
2. Select rigid bodies to be converted
   You can select the related rigid bodies
3. Select a mesh to be deformed
4. Press Rigid Body to Cloth

MMD Humanoid rig generator

Automatically generate an MMD compatible rig in one-click, complete with leg IK and English names.

Humanoid Renamer

Select bones that correspond to MMD, and the tool will automatically rename the bones to MMD-compatible names.

Generate Skin Hair

How to use Skin hair generate feature/体毛生成機能の使い方

1. Select 3D View > Add > Mesh > Append Extras > Skin Hair

Preferences

1. Open the Blender User Preferences menu and select the Add-ons tab (Edit > Preferences... > Add-ons)
2. Type "mmd" to 🔍 search box at the top of the Add-ons menu.
3. Open the MMD Tools Append

Contribution

mmd_tools_append needs your contribution!

• Feature/Asset requests (material, lighting, etc)
• Document writing / translation
• Asset creation (lighting, materials, accessories, etc)
• Asset maintenance
• Software development

If you are interested in any of the above, please contact me via the issues.

Credits

• Lighting thumbnail images depict the character "Hatsune Miku" of Crypton Future Media, Inc. under the Piapro Character License.
• Append Asset Search Panel image depict the character "Aether", "Lumine", "Venti", "Fischl" of miHoYo Limited.
• Rigid body Physics to Cloth Physics feature is the work of 小威廉伯爵. It was ported with his permission.
• Leg IK maker in MMD Humanoid Generator was ported from MMD Tools Helper (by Hogarth-MMD) (GPLv3).