Home - MMD-Blender/blender_mmd_uuunyaa_tools GitHub Wiki

Welcome to the mmd_uuunyaa_tools wiki!

日本語ページはこちら！

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

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

Installation

Download

Download mmd_uuunyaa_tools from the github release page

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.

Install video

Requirements

  • Blender 2.83 LTS or 2.93 LTS
  • 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.htmlThen add to the PATH, and then reboot the OS.
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.htmlThen add to the PATH, and then reboot the OS.
Linux Run command sudo {apt,yum,dnf,snap} install unrar

Usage

YouTube video available

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

MMD Rigify Integration

How to use MMD UuuNyaa Tools's MMD Rigify integration feature
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 > UuuNyaa 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 > 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

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

UuuNyaa Asset Search Panel

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

UuuNyaa Assets Operator Panel

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 Double Side Accent God Ray Backlight Shadowless Light Probe Grid

Setup materials

  1. Goto Properties > Material Properties > MMD UuuNyaa Material Panel
  2. Choose material thumbnail icon
Example of Metal Noble and Gem
Example of Metal Noble and Gem

Available material presets

MATERIAL_RESET Transparent
Reset Transparent
Eye Highlight Eye White Eye Iris Eye Lash
Eye Highlight Eye White Eye Iris Eye Lash
Hair Matte
Hair Matte
Skin Mucosa Skin Bump
Skin Mucosa Skin Bump
Fabric Cotton Fabric Silk Fabric Bump Fabric Wave Fabric Knit Fabric Leather
Fabric Cotton Fabric Silk Fabric Bump Fabric Wave Fabric Knit Fabric Leather
Plastic Gloss Plastic Gloss Plastic Emission Plastic Bump
Plastic Gloss Plastic Matte Plastic Emission Plastic Bump
Metal Noble Metal Base
Metal Noble Metal Base
Stone Gem
Stone Gem
Liquid Water Liquid Cloudy
Liquid Water Liquid Cloudy

Artistic materials

How to use Watercolor material
Watercolor material / 水彩画マテリアル
Artistic Watercolor
Artistic Watercolor

Setup material adjuster

How to use Material Adjust feature
Material Adjust feature / マテリアル調整機能の使い方
  1. Goto Properties > Material Properties > MMD UuuNyaa Material Adjuster Panel
  2. Choose Adjuster

UuuNyaa Material Adjuster Panel

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

Subsurface Adjuster

This adjuster uses Ambient Occlusion to apply a strong subsurface effect to thin areas of the mesh.

Property Description
Min Specify the minimum Subsurface value
Max Specify the maximum Subsurface value
Blood Color Specify the Subsurface Color

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
"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
How to use Physics Adjuster feature/物理調整機能の使い方
  1. Goto 3D Viewport > Sidebar > MMD > UuuNyaa Physics Panel
  2. Select rigid bodies to be convertedYou can select the related rigid bodies
  3. Select a mesh to be deformed
  4. Press Rigid Body to Cloth

Generate Skin Hair

How to use Skin hair generate feature
How to use Skin hair generate feature/体毛生成機能の使い方
  1. Select 3D View > Add > Mesh > UuuNyaa 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 Object: mmd_uuunyaa_tools

Preferences

Contribution

mmd_uuunyaa_tools 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.
  • UuuNyaa 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.