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.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 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.

  3. 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.

  4. 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.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

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.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a โ€œServer Crashedโ€ notice with an โ€œAnalyze Nowโ€ button.

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
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

  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. Model-specific folder (EntityPlayer/ModelName/*.vmd) - Highest priority
  2. Custom 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
๐ŸŽญ 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

  1. Model not showing? Check that your model folder contains a valid .pmx or .pmd file
  2. Textures missing? Ensure texture files are in the same folder as the model
  3. Animation not playing? 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.

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!

FAQ

MmdSkin questions

Question not listed? Ask our team.

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.

Ready for your server with MmdSkin?

4 GB of RAM from โ‚ฌ8.00 per month. 35% off your first month with MADO35.

Order server