

Modrinth ยท Fabric, Forge, NeoForge
MmdSkin on your Minecraft server
MmdSkin runs on Minecraft servers with Fabric or Forge or NeoForge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
A mod that replaces Minecraft entity rendering with MMD models
- Downloads
- 243.0K
- Author
- shiroha
- Loader
- Fabric, Forge, NeoForge
- Minecraft
- 1.20.1 โ 1.21.4
- Updated
- โ
Screenshots
What MmdSkin looks like
Images: MmdSkin on Modrinth, published by the project team.
Setup
Install MmdSkin on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Forge or NeoForge and choose the matching Minecraft version, for example 1.21.4.
- 03
Install the mod
Search the mod browser for โMmdSkinโ and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Every player installs the same MmdSkin release locally and connects using the server address from the panel.
- On the server
- Required
- On the client
- Required
- Loader
- Fabric, Forge, NeoForge
- Minecraft
- 1.21.4, 1.21.3, 1.21.2 +2 more
- License
- MIT License
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your serverโs loader and Minecraft version. The server and players need the same release.
MmdSkin ยท Modrinth- MmdSkin 1.0.5-1.21.1-2May 17, 2026Minecraft 1.21.1 ยท NeoForge
- MmdSkin 1.0.5-1.21.1-2May 17, 2026Minecraft 1.21.1 ยท Fabric
- MmdSkin 1.0.5-1.20.1May 16, 2026Minecraft 1.20.1 ยท Fabric
- MmdSkin 1.0.5-1.20.1May 16, 2026Minecraft 1.20.1 ยท Forge
Original description by the project author
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
- PMX/PMD Model Support - Load and render MMD models in Minecraft
- VMD Animation Playback - Play skeletal and morph animations
- Real-time Physics - Hair, skirts, and accessories react naturally to movement
- GPU Skinning - High-performance vertex skinning via Compute Shader
- Toon Rendering - Cel-shading effects with customizable parameters
- Multi-layer Animation - Blend multiple animations simultaneously
- TouhouLittleMaid Integration - Apply MMD models to maids
๐ฆ Installation
- Install Fabric Loader or Forge for Minecraft 1.20.1
- Download the mod
.jarfile and place it in.minecraft/mods/ - Launch the game - the mod will create the
3d-skinresource directory automatically - 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
.pmxor.pmdfiles - If multiple model files exist,
model.pmxormodel.pmdis 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:
- Model-specific folder (
EntityPlayer/ModelName/*.vmd) - Highest priority - Custom animation folder (
CustomAnim/*.vmd) - 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 |
|---|---|
| ๐ญ Model Switch | Open model selector to change player model |
| ๐ฌ Action Select | Open action wheel to play custom animations |
| ๐ Morph Select | Open morph wheel to apply expressions |
| ๐ Material Control | 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
- OpenGL Lighting - Enable/disable lighting
- MMD Shader - Use MMD-style shading
Performance
- Model Pool Max - Maximum cached models (10-500)
- GPU Skinning - Use Compute Shader for vertex skinning (requires OpenGL 4.3+)
- GPU Morph - Use Compute Shader for morph calculations
- Max Bones - Maximum bone count (512-4096)
Toon Rendering
- Enable Toon - Enable cel-shading
- Toon Levels - Number of shade levels (2-5)
- Rim Light - Edge highlighting
- Shadow Color - Custom shadow tint
- Specular - 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
- Model not showing? Check that your model folder contains a valid
.pmxor.pmdfile - Textures missing? Ensure texture files are in the same folder as the model
- Animation not playing? Verify the
.vmdfile is compatible with your model's bone structure - 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.
Q: Is this compatible with shader mods?
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:
- KAIMyEntity by kjkjkAIStudio - Original Minecraft MMD mod
- KAIMyEntity-C 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):
Enjoy your MMD experience in Minecraft!
MmdSkin server crashes on startup โ what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for โOutOfMemoryErrorโ, โMixinโ or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does MmdSkin run on?
According to Modrinth, MmdSkin supports Fabric, Forge, NeoForge for Minecraft 1.21.4, 1.21.3, 1.21.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.
How much RAM does a server with MmdSkin need?
As guidance, 3โ4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Client only
Sodium Extra
by FlashyReese
A Sodium addon that adds features that shouldn't be in Sodium.
Server-ready
VeinMiner
by Miraculixx
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
Client only
Remove Reloading Screen
by dima_dencep
Makes resource packs load in the background, allowing you to do other things while waiting!
Server-ready
Sinytra Connector
by Su5eD
Lets you play Fabric mods on NeoForge
Ready for your server with MmdSkin?
4 GB of RAM from โฌ8.00 per month. 35% off your first month with MADO35.