# MMD Skin – Bring MMD Models to Minecraft<\/p>\n
**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.<\/p>\n
## \u2728 Features<\/p>\n
– **PMX\/PMD Model Support** – Load and render MMD models in Minecraft
\n– **VMD Animation Playback** – Play skeletal and morph animations
\n– **Real-time Physics** – Hair, skirts, and accessories react naturally to movement
\n– **GPU Skinning** – High-performance vertex skinning via Compute Shader
\n– **Toon Rendering** – Cel-shading effects with customizable parameters
\n– **Multi-layer Animation** – Blend multiple animations simultaneously
\n– **TouhouLittleMaid Integration** – Apply MMD models to maids<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Install Fabric Loader or Forge for Minecraft 1.20.1
\n2. Download the mod `.jar` file and place it in `.minecraft\/mods\/`
\n3. Launch the game – the mod will create the `3d-skin` resource directory automatically
\n4. Add your own models and animations to the corresponding folders<\/p>\n
## \ud83d\udcc1 Directory Structure<\/p>\n
The mod uses `.minecraft\/3d-skin\/` as the resource root:<\/p>\n
“`
\n.minecraft\/
\n\u2514\u2500\u2500 3d-skin\/
\n \u251c\u2500\u2500 EntityPlayer\/ # Player models
\n \u2502 \u251c\u2500\u2500 ModelA\/ # Each subfolder = one model
\n \u2502 \u2502 \u251c\u2500\u2500 model.pmx # Model file (.pmx\/.pmd)
\n \u2502 \u2502 \u251c\u2500\u2500 *.png # Textures
\n \u2502 \u2502 \u251c\u2500\u2500 dance.vmd # Model-specific animation (optional)
\n \u2502 \u2502 \u2514\u2500\u2500 smile.vpd # Model-specific morph (optional)
\n \u2502 \u2514\u2500\u2500 ModelB\/
\n \u2502 \u2514\u2500\u2500 …
\n \u251c\u2500\u2500 DefaultAnim\/ # System preset animations
\n \u251c\u2500\u2500 CustomAnim\/ # User custom animations
\n \u251c\u2500\u2500 DefaultMorph\/ # System preset morphs
\n \u2514\u2500\u2500 CustomMorph\/ # User custom morphs
\n“`<\/p>\n
### EntityPlayer\/ – Player Models<\/p>\n
Store your MMD models here. **Each model must be in its own subfolder**.<\/p>\n
| File Type | Extension | Description |
\n|———–|———–|————-|
\n| Model | `.pmx` \/ `.pmd` | Required, PMX takes priority |
\n| Texture | `.png` \/ `.jpg` \/ `.bmp` \/ `.tga` | Referenced by model |
\n| Animation | `.vmd` | Optional, model-specific |
\n| Morph | `.vpd` | Optional, model-specific |<\/p>\n
**Model Detection Rules:**
\n– Scans each subfolder for `.pmx` or `.pmd` files
\n– If multiple model files exist, `model.pmx` or `model.pmd` is prioritized
\n– Otherwise, the first file alphabetically is selected<\/p>\n
### DefaultAnim\/ – System Preset Animations<\/p>\n
Contains built-in animations that map to player states:<\/p>\n
| Animation | Trigger |
\n|———–|———|
\n| `idle.vmd` | Standing still |
\n| `walk.vmd` | Walking |
\n| `sprint.vmd` | Sprinting |
\n| `sneak.vmd` | Sneaking |
\n| `swim.vmd` | Swimming |
\n| `crawl.vmd` | Crawling |
\n| `sleep.vmd` | Sleeping |
\n| `die.vmd` | Death |
\n| `elytraFly.vmd` | Elytra flight |
\n| `onClimbable.vmd` | Climbing (idle) |
\n| `onClimbableUp.vmd` | Climbing up |
\n| `onClimbableDown.vmd` | Climbing down |
\n| `onHorse.vmd` | Riding |
\n| `swingLeft.vmd` | Left hand swing |
\n| `swingRight.vmd` | Right hand swing |<\/p>\n
> You can replace these files to customize base animations.<\/p>\n
### CustomAnim\/ – User Custom Animations<\/p>\n
Place your `.vmd` animation files here. They can be triggered manually via the action wheel.<\/p>\n
### Animation Priority<\/p>\n
When loading animations, the mod searches in this order:<\/p>\n
1. **Model-specific folder** (`EntityPlayer\/ModelName\/*.vmd`) – Highest priority
\n2. **Custom animation folder** (`CustomAnim\/*.vmd`)
\n3. **Default animation folder** (`DefaultAnim\/*.vmd`) – Lowest priority<\/p>\n
This allows you to create model-specific animations that override general ones.<\/p>\n
## \ud83c\udfae Controls<\/p>\n
### Main Config Wheel (Hold `Alt`)<\/p>\n
Hold `Alt` to open the main configuration wheel:<\/p>\n
| Option | Function |
\n|——–|———-|
\n| \ud83c\udfad **Model Switch** | Open model selector to change player model |
\n| \ud83c\udfac **Action Select** | Open action wheel to play custom animations |
\n| \ud83d\ude0a **Morph Select** | Open morph wheel to apply expressions |
\n| \ud83d\udc55 **Material Control** | Toggle visibility of model parts |
\n| \u2699 **Mod Settings** | Open mod configuration screen |<\/p>\n
### Maid Config Wheel (Press `B` on maid)<\/p>\n
If TouhouLittleMaid is installed, aim at a maid and press `B` to open maid-specific options.<\/p>\n
> **Tip:** Keybinds can be customized in Options \u2192 Controls \u2192 MMD Skin category.<\/p>\n
## \u2699 Settings<\/p>\n
Access mod settings via the config wheel or Mod Menu. Available options:<\/p>\n
### Rendering
\n– **OpenGL Lighting** – Enable\/disable lighting
\n– **MMD Shader** – Use MMD-style shading<\/p>\n
### Performance
\n– **Model Pool Max** – Maximum cached models (10-500)
\n– **GPU Skinning** – Use Compute Shader for vertex skinning (requires OpenGL 4.3+)
\n– **GPU Morph** – Use Compute Shader for morph calculations
\n– **Max Bones** – Maximum bone count (512-4096)<\/p>\n
### Toon Rendering
\n– **Enable Toon** – Enable cel-shading
\n– **Toon Levels** – Number of shade levels (2-5)
\n– **Rim Light** – Edge highlighting
\n– **Shadow Color** – Custom shadow tint
\n– **Specular** – Highlight settings
\n– **Outline** – Model outline (width & color)<\/p>\n
> \u26a0\ufe0f **Note:** Toon Rendering and GPU Skinning are currently incompatible with shader mods (Iris\/Optifine). Disable these features when using shaders.<\/p>\n
## \ud83d\udd27 Tips<\/p>\n
1. **Model not showing?** Check that your model folder contains a valid `.pmx` or `.pmd` file
\n2. **Textures missing?** Ensure texture files are in the same folder as the model
\n3. **Animation not playing?** Verify the `.vmd` file is compatible with your model’s bone structure
\n4. **Performance issues?** Try enabling GPU features on older hardware<\/p>\n
## \ud83d\udcdd Supported Formats<\/p>\n
| Format | Extension | Description |
\n|——–|———–|————-|
\n| PMX | `.pmx` | MikuMikuDance model (recommended) |
\n| PMD | `.pmd` | Legacy MMD model |
\n| VMD | `.vmd` | MikuMikuDance motion data |
\n| VPD | `.vpd` | Vocaloid Pose Data (morphs) |<\/p>\n
## \ud83d\udca1 FAQ<\/p>\n
**Q: Can I use any MMD model?**
\nA: Most PMX\/PMD models should work. Very high-poly models may impact performance.<\/p>\n
**Q: Do physics work with all models?**
\nA: Physics simulation depends on the model having properly configured rigid bodies and joints.<\/p>\n
**Q: Can other players see my model?**
\nA: Yes, if they also have the mod installed and the same model files.<\/p>\n
**Q: Is this compatible with shader mods?**
\nA: 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.<\/p>\n
## \ud83d\ude4f Credits<\/p>\n
This mod is based on the following projects:<\/p>\n
– KAIMyEntity by **kjkjkAIStudio** – Original Minecraft MMD mod
\n– KAIMyEntity-C by **Gengorou-C** – Direct predecessor of this project<\/p>\n
Thanks to the original authors for their open-source contributions!<\/p>\n
## \ud83c\udfa8 Where to Get Models<\/p>\n
You can find MMD models on these websites (please respect the model authors’ terms of use):<\/p>\n
– Aplaybox (\u6a21\u4e4b\u5c4b)
\n– Bowlroll
\n– DeviantArt
\n– Niconi 3D<\/p>\n
—<\/p>\n
*Enjoy your MMD experience in Minecraft!*<\/p>\n","protected":false},"excerpt":{"rendered":"
A mod that replaces Minecraft entity rendering with MMD models<\/p>\n","protected":false},"featured_media":103405,"template":"","meta":{"_minecraft_slug":"mmdskin","_minecraft_project_id":"6eYjvXFw","_minecraft_author":"shiroha","_minecraft_license":"MIT","_minecraft_downloads":103082,"_minecraft_follows":115,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mmdskin.zip","_minecraft_size_bytes":253036732,"_minecraft_version_count":15,"_minecraft_updated_at":"2026-05-16T21:14:54.279382Z","_minecraft_date_created":"2026-02-07T00:56:11.201738Z","_minecraft_date_modified":"2026-05-16T10:05:04.579651Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mmdskin","_minecraft_icon_attachment_id":103405,"_minecraft_imported_at":"2026-06-05T22:42:29+00:00","_minecraft_import_hash":"0d3aa491f70d51cb1e8d1998a3cbe9e9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,156,844,97,104,89,158,92],"mod_loader":[99,106,160],"minecraft_version":[36,37],"class_list":["post-103404","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-decoration","mod_category-economy","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-neoforge","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21-1"],"yoast_head":"\n