MmdSkin

MMD Skin - Bring MMD Models to Minecraft

MMD Skin is a Minecraft mod that allows you to replace the player skin with MMD (MikuMikuDance) models, complete with real-time physics simulation for hair, clothes, and accessories.

✨ Features

- TouhouLittleMaid Integration - Load and render MMD models in Minecraft - TouhouLittleMaid Integration - Play skeletal and morph animations - TouhouLittleMaid Integration - Hair, skirts, and accessories react naturally to movement - TouhouLittleMaid Integration - High-performance vertex skinning via Compute Shader - TouhouLittleMaid Integration - Cel-shading effects with customizable parameters - TouhouLittleMaid Integration - Blend multiple animations simultaneously - TouhouLittleMaid Integration - Apply MMD models to maids

📦 Installation

1. Install Fabric Loader or Forge for Minecraft 1.20.1 2. Download the mod `.jar` file and place it in `.minecraft/mods/` 3. Launch the game - the mod will create the `3d-skin` resource directory automatically 4. Add your own models and animations to the corresponding folders

📁 Directory Structure

The mod uses `.minecraft/3d-skin/` as the resource root:

``` .minecraft/ └── 3d-skin/ ├── EntityPlayer/ # Player models │ ├── ModelA/ # Each subfolder = one model │ │ ├── model.pmx # Model file (.pmx/.pmd) │ │ ├── *.png # Textures │ │ ├── dance.vmd # Model-specific animation (optional) │ │ └── smile.vpd # Model-specific morph (optional) │ └── ModelB/ │ └── ... ├── DefaultAnim/ # System preset animations ├── CustomAnim/ # User custom animations ├── DefaultMorph/ # System preset morphs └── CustomMorph/ # User custom morphs ```

EntityPlayer/ - Player Models

Store your MMD models here. Each model must be in its own subfolder.

| File Type | Extension | Description | |-----------|-----------|-------------| | Model | `.pmx` / `.pmd` | Required, PMX takes priority | | Texture | `.png` / `.jpg` / `.bmp` / `.tga` | Referenced by model | | Animation | `.vmd` | Optional, model-specific | | Morph | `.vpd` | Optional, model-specific |

Model Detection Rules: - Scans each subfolder for `.pmx` or `.pmd` files - If multiple model files exist, `model.pmx` or `model.pmd` is prioritized - Otherwise, the first file alphabetically is selected

DefaultAnim/ - System Preset Animations

Contains built-in animations that map to player states:

| Animation | Trigger | |-----------|---------| | `idle.vmd` | Standing still | | `walk.vmd` | Walking | | `sprint.vmd` | Sprinting | | `sneak.vmd` | Sneaking | | `swim.vmd` | Swimming | | `crawl.vmd` | Crawling | | `sleep.vmd` | Sleeping | | `die.vmd` | Death | | `elytraFly.vmd` | Elytra flight | | `onClimbable.vmd` | Climbing (idle) | | `onClimbableUp.vmd` | Climbing up | | `onClimbableDown.vmd` | Climbing down | | `onHorse.vmd` | Riding | | `swingLeft.vmd` | Left hand swing | | `swingRight.vmd` | Right hand swing |

> You can replace these files to customize base animations.

CustomAnim/ - User Custom Animations

Place your `.vmd` animation files here. They can be triggered manually via the action wheel.

Animation Priority

When loading animations, the mod searches in this order:

1. Default animation folder (`EntityPlayer/ModelName/*.vmd`) - Highest priority 2. Default animation folder (`CustomAnim/*.vmd`) 3. Default animation folder (`DefaultAnim/*.vmd`) - Lowest priority

This allows you to create model-specific animations that override general ones.

🎮 Controls

Main Config Wheel (Hold `Alt`)

Hold `Alt` to open the main configuration wheel:

| Option | Function | |--------|----------| | 🎭 Mod Settings | Open model selector to change player model | | 🎬 Mod Settings | Open action wheel to play custom animations | | 😊 Mod Settings | Open morph wheel to apply expressions | | 👕 Mod Settings | Toggle visibility of model parts | | ⚙ Mod Settings | Open mod configuration screen |

Maid Config Wheel (Press `B` on maid)

If TouhouLittleMaid is installed, aim at a maid and press `B` to open maid-specific options.

> Tip: Keybinds can be customized in Options → Controls → MMD Skin category.

⚙ Settings

Access mod settings via the config wheel or Mod Menu. Available options:

Rendering

- MMD Shader - Enable/disable lighting - MMD Shader - Use MMD-style shading

Performance

- Max Bones - Maximum cached models (10-500) - Max Bones - Use Compute Shader for vertex skinning (requires OpenGL 4.3+) - Max Bones - Use Compute Shader for morph calculations - Max Bones - Maximum bone count (512-4096)

Toon Rendering

- Outline - Enable cel-shading - Outline - Number of shade levels (2-5) - Outline - Edge highlighting - Outline - Custom shadow tint - Outline - Highlight settings - Outline - Model outline (width & color)

> ⚠️ Note: Toon Rendering and GPU Skinning are currently incompatible with shader mods (Iris/Optifine). Disable these features when using shaders.

🔧 Tips

1. Performance issues? Check that your model folder contains a valid `.pmx` or `.pmd` file 2. Performance issues? Ensure texture files are in the same folder as the model 3. Performance issues? Verify the `.vmd` file is compatible with your model's bone structure 4. Performance issues? Try enabling GPU features on older hardware

📝 Supported Formats

| Format | Extension | Description | |--------|-----------|-------------| | PMX | `.pmx` | MikuMikuDance model (recommended) | | PMD | `.pmd` | Legacy MMD model | | VMD | `.vmd` | MikuMikuDance motion data | | VPD | `.vpd` | Vocaloid Pose Data (morphs) |

💡 FAQ

Q: Can I use any MMD model? A: Most PMX/PMD models should work. Very high-poly models may impact performance.

Q: Do physics work with all models? A: Physics simulation depends on the model having properly configured rigid bodies and joints.

Q: Can other players see my model? A: Yes, if they also have the mod installed and the same model files.

Toon Rendering and GPU Skinning do not currently support shaders A: Basic rendering is compatible with Iris/Optifine, but Toon Rendering and GPU Skinning do not currently support shaders. Disable these features in settings when using shader packs.

🙏 Credits

This mod is based on the following projects:

- Gengorou-C by Gengorou-C - Original Minecraft MMD mod - %%MD1%% by Gengorou-C - Direct predecessor of this project

Thanks to the original authors for their open-source contributions!

🎨 Where to Get Models

You can find MMD models on these websites (please respect the model authors' terms of use):

- Aplaybox (模之屋) - Bowlroll - DeviantArt - Niconi 3D

---

*Enjoy your MMD experience in Minecraft!*