MMD皮肤——把MMD模型带到Minecraft中
MMD 皮肤是一个 Minecraft 模组，允许你用 MMD（MikuMikuDance）模型替换玩家皮肤，并配有头发、服装和配饰的实时物理模拟。
✨ 特色
- PMX/PMD 模型支持 - 在 Minecraft 中加载和渲染 MMD 模型
- VMD动画播放——播放骨骼和变形动画
- 实时物理——头发、裙子和配饰会自然响应运动
- GPU 蒙皮——通过计算着色器实现的高性能顶点蒙皮
- 卡通渲染——带有可自定义参数的卡通渲染效果
- 多层动画——同时混合多个动画
- 东方LittleMaid集成——将MMD模型应用于女佣
📦 安装
- 安装 Fabric Loader 或 Forge for Minecraft 1.20.1
- 下载mod文件并放入.jar.minecraft/mods/
- 启动游戏——模组会自动创建资源目录3d-skin
- 把你自己的模型和动画添加到对应的文件夹里
📁 目录结构
该模组使用以下资源根：.minecraft/3d-skin/
.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/ - 玩家模型
这里存放你的MMD模型。每个模型必须放在自己的子文件夹里。
| 文件类型 | 扩展 | 描述 |
|---|---|---|
| 模型 | .pmx / .pmd | 必须，PMX优先 |
| 纹理 | .png / .jpg / .bmp / .tga | 型号参考 |
| 动画 | .vmd | 可选，型号特定 |
| 变形 | .vpd | 可选，型号特定 |
模型检测规则：
- 扫描每个子文件夹，查找文件.pmx.pmd
- 如果存在多个模型文件，或者有优先级model.pmxmodel.pmd
- 否则，按字母顺序选择第一个文件
DefaultAnim/ - 系统预设动画
包含映射到玩家状态的内置动画：
| 动画 | 触发器 |
|---|---|
| idle.vmd | 站着不动 |
| walk.vmd | 徒步 |
| sprint.vmd | 短跑 |
| sneak.vmd | 潜行 |
| swim.vmd | 游泳 |
| crawl.vmd | 爬行 |
| sleep.vmd | 睡觉 |
| die.vmd | 逝世 |
| elytraFly.vmd | 鞘翅飞行 |
| onClimbable.vmd | 攀升（怠速） |
| onClimbableUp.vmd | 攀登 |
| onClimbableDown.vmd | 下山 |
| onHorse.vmd | 骑行 |
| swingLeft.vmd | 左手挥杆 |
| swingRight.vmd | 右手挥杆 |
你可以替换这些文件来自定义基础动画。
CustomAnim/ - 用户自定义动画
请将你的动画文件放在这里。它们可以通过动作轮手动触发。.vmd
动画优先级
加载动画时，模组会按以下顺序搜索：
- 型号专用文件夹（）- 最高优先级EntityPlayer/ModelName/*.vmd
- 自定义动画文件夹 (CustomAnim/*.vmd)
- 默认动画文件夹（）- 最低优先级DefaultAnim/*.vmd
这允许你创建模型特定的动画，覆盖一般动画。
🎮 控制
主配置轮（按住）Alt)
按住以打开主配置轮：Alt
| 选项 | 功能 |
|---|---|
| 🎭 型号开关 | 打开模型选择器以更改玩家模型 |
| 🎬 行动选择 | 打开操作轮以播放自定义动画 |
| 😊 变形选择 | 打开变形轮以应用表达式 |
| 👕 物料控制 | 切换模型零件可见性 |
| ⚙ 模组设置 | 打开模组配置界面 |
女仆配置轮（按女仆）B
如果安装了东方小女仆，瞄准一名女仆并点击以打开女仆专属选项。B
提示：按键绑定可以在MMD皮肤类别→选项→控制中自定义。
⚙ 背景设定
通过配置轮或模组菜单访问模组设置。可选方案：
渲染
- OpenGL 灯光 - 启用/禁用光照
- MMD 着色器——使用 MMD 风格的着色
性能
- 模型池最大值 - 最大缓存模型（10-500）
- GPU 蒙皮——使用 Compute Shader 进行顶点蒙皮（需要 OpenGL 4.3+）
- GPU 变形 - 使用计算着色器进行变形计算
- 最大骨头数 - 最大骨量（512-4096）
卡通渲染
- 启用Toon——启用卡通渲染
- 卡通关卡 - 阴影等级数量（2-5）
- 边缘灯 - 边缘高光
- 阴影颜色——定制阴影色调
- 镜面 - 高光设置
- 轮廓 - 模型轮廓（宽度和颜色）
⚠️ 注意：卡通渲染和GPU蒙皮目前与着色器模组（Iris/Optifine）不兼容。使用着色器时请禁用这些功能。
🔧 小贴士
- 模型没有显示？检查一下你的模型文件夹里有没有有效的文件.pmx.pmd
- 纹理缺失？确保纹理文件和模型在同一个文件夹里
- 动画不播放？确认文件是否兼容你模型的骨骼结构.vmd
- 性能问题？试试在旧硬件上启用显卡功能
📝 支持的格式
| 节目形式 | 扩展 | 描述 |
|---|---|---|
| PMX | .pmx | MikuMikuDance型号（推荐） |
| PMD | .pmd | 遗留的MMD模型 |
| VMD | .vmd | MikuMikuDance 运动数据 |
| 维吉尼亚警察局 | .vpd | Vocaloid 姿态数据（变形） |
💡 常见问题
问：我可以使用任何MMD模型吗？
答：大多数PMX/PMD模型都能正常工作。非常高多边形的模型可能会影响性能。
问：物理效果适用于所有模型吗？
答：物理仿真依赖于模型是否正确配置刚体和关节。
问：其他玩家能看到我的模型吗？
答：可以，如果他们也安装了模组并且使用相同的模型文件。
问：这和着色器模组兼容吗？
答：基础渲染兼容Iris/Optifine，但Toon Rendering和GPU蒙皮目前不支持着色器。使用着色器包时，请在设置中禁用这些功能。
🙏 制作人员
该模组基于以下项目：
- KAIMyEntity 由 kjkjkAIStudio 制作——原版 Minecraft MMD 模组
- KAIMyEntity-C 由 Gengorou-C 开发——该项目的直接前身
感谢原作者们的开源贡献！
🎨 模型获取渠道
您可以在这些网站上找到MMD模型（请尊重模型作者的使用条款）：
祝你在Minecraft中玩MMD的愉快！
