Home

Welcome to the mmd_uuunyaa_tools wiki!

日本語ページはこちら！

mmd_uuunyaa_tools is a blender addon for adjust scenes, models and materials in concert with powroupi/blender_mmd_tools.

mmd_uuunyaa_toolsはpowroupi/blender_mmd_toolsと連携してシーン、モデル、マテリアルを調整するためのBlenderアドオンです。

Installation

Download

Download mmd_uuunyaa_tools from the github release page

• https://github.com/UuuNyaa/blender_mmd_uuunyaa_tools/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_uuunyaa_tools 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_uuunyaa_tools addon .zip file.
3. After installing the addon .zip file, Blender will filter the addons list to only show the mmd_uuunyaa_tools 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 2.83 or later
• blender_mmd_tools v0.7.0 or later

(Optional) Rigify add-on

If you want to use MMD Rigify Integration feature.

• Open Blender and go to Preferences then the Add-ons tab.
• 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
Linux	Run command sudo {apt,yum,dnf,snap} install p7zip-full

(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
Linux	Run command sudo {apt,yum,dnf,snap} install unrar

Usage

YouTube video available

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

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

MMD Rigify Integration

Convert a MMD armature to Rigify compatible

1. Select a target MMD armature
2. Goto 3D Viewport > Sidebar > MMD > UuuNyaa Operator Panel
3. Press Add Metarig
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 > UuuNyaa Operator Panel
3. Press Convert to MMD compatible
4. Press Apply MMD rest pose

Control the armature properties

1. Select a target Armature
2. Goto 3D Viewport > Sidebar > Item > UuuNyaa MMD 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 > UuuNyaa 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 > UuuNyaa 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 > UuuNyaa Operator Panel
2. Press Setup Render Engine for Eevee

Convert shaders for Eevee

1. Select target mesh
2. Goto 3D Viewport > Sidebar > MMD > UuuNyaa Operator Panel
3. Press Convert Shaders for Eevee

Setup ligihting

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

Available lighting presets

Left Accent	God Ray	Backlight

Setup materials

1. Goto Properties > Material Properties > MMD UuuNyaa 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

Gem

Liquid Water	Liquid Cloudy

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 Object: mmd_uuunyaa_tools

Contribution

mmd_uuunyaa_tools needs your contribution!

• Feature/Asset requests (material, lighting, etc)
• Document writing
• 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.
• UuuNyaa Asset Search Panel image depict the character "Aether", "Lumine", "Venti", "Fischl" of miHoYo Limited.