MmdSkin - Mmd皮肤

MMD Skin - 将 MMD 模型带入 Minecraft

MMD Skin 是一款 Minecraft 模组，允许你将玩家皮肤替换为 MMD（MikuMikuDance）模型，并配有头发、衣物和配饰的实时物理模拟。

✨ 功能特性

• PMX/PMD 模型支持 - 在 Minecraft 中加载并渲染 MMD 模型
• VMD 动画播放 - 播放骨骼和形变动画
• 实时物理效果 - 头发、裙摆和配饰会根据运动自然反应
• GPU 蒙皮 - 通过计算着色器实现高性能顶点蒙皮
• 卡通渲染 - 可自定义参数的卡通着色效果
• 多层动画混合 - 同时混合多个动画
• TouhouLittleMaid 集成 - 将 MMD 模型应用于女仆

📦 安装方法

• 为 Minecraft 1.20.1 安装 Fabric Loader 或 Forge
• 下载模组 .jar 文件并放入 .minecraft/mods/ 文件夹
• 启动游戏 - 模组会自动创建 3d-skin 资源目录
• 将你自己的模型和动画添加到相应的文件夹中

📁 目录结构

模组使用 .minecraft/3d-skin/ 作为资源根目录：

.minecraft/
└── 3d-skin/
    ├── EntityPlayer/      # 玩家模型
    │   ├── ModelA/        # 每个子文件夹 = 一个模型
    │   │   ├── model.pmx  # 模型文件 (.pmx/.pmd)
    │   │   ├── *.png      # 纹理贴图
    │   │   ├── dance.vmd  # 模型特定动画（可选）
    │   │   └── smile.vpd  # 模型特定形变（可选）
    │   └── ModelB/
    │       └── ...
    ├── DefaultAnim/       # 系统预设动画
    ├── CustomAnim/        # 用户自定义动画
    ├── DefaultMorph/      # 系统预设形变
    └── CustomMorph/       # 用户自定义形变

EntityPlayer/ - 玩家模型

将你的 MMD 模型存放在这里。每个模型必须放在其独立的子文件夹中。

模型检测规则：

• 扫描每个子文件夹中的 .pmx 或 .pmd 文件
• 如果存在多个模型文件，优先选择 model.pmx 或 model.pmd
• 否则，按字母顺序选择第一个文件

DefaultAnim/ - 系统预设动画

包含映射到玩家状态的内置动画：

> 你可以替换这些文件来自定义基础动画。

CustomAnim/ - 用户自定义动画

将你的 .vmd 动画文件放在这里。它们可以通过动作轮盘手动触发。

动画优先级

加载动画时，模组按以下顺序搜索：

• 模型特定文件夹 (EntityPlayer/ModelName/*.vmd) - 最高优先级
• 自定义动画文件夹 (CustomAnim/*.vmd)
• 默认动画文件夹 (DefaultAnim/*.vmd) - 最低优先级

这允许你创建覆盖通用动画的模型特定动画。

🎮 控制方式

主配置轮盘（按住 Alt）

按住 Alt 键打开主配置轮盘：

女仆配置轮盘（对女仆按 B）

如果安装了 TouhouLittleMaid，瞄准女仆并按 B 键可打开女仆特定选项。

> 提示： 按键绑定可在 选项 → 控制 → MMD Skin 类别中自定义。

⚙ 设置

通过配置轮盘或 Mod Menu 访问模组设置。可用选项：

渲染

• OpenGL 光照 - 启用/禁用光照
• MMD 着色器 - 使用 MMD 风格着色

性能

• 模型池上限 - 最大缓存模型数 (10-500)
• GPU 蒙皮 - 使用计算着色器进行顶点蒙皮（需要 OpenGL 4.3+）
• GPU 形变 - 使用计算着色器进行形变计算
• 最大骨骼数 - 最大骨骼数量 (512-4096)

卡通渲染

• 启用卡通渲染 - 启用卡通着色
• 卡通层级 - 阴影层级数 (2-5)
• 边缘光 - 边缘高亮
• 阴影颜色 - 自定义阴影色调
• 高光 - 高光设置
• 轮廓线 - 模型轮廓（宽度和颜色）

> ⚠️ 注意： 卡通渲染和 GPU 蒙皮目前与光影模组（Iris/Optifine）不兼容。使用光影时请禁用这些功能。

🔧 提示

• 模型不显示？ 检查你的模型文件夹是否包含有效的 .pmx 或 .pmd 文件
• 纹理缺失？ 确保纹理文件与模型在同一文件夹中
• 动画不播放？ 确认 .vmd 文件与模型的骨骼结构兼容
• 性能问题？ 在较旧的硬件上尝试启用 GPU 功能

📝 支持格式

💡 常见问题

问：我可以使用任何 MMD 模型吗？

答：大多数 PMX/PMD 模型应该都能工作。面数非常高的模型可能会影响性能。

问：物理效果对所有模型都有效吗？

答：物理模拟取决于模型是否配置了适当的刚体和关节。

问：其他玩家能看到我的模型吗？

答：可以，前提是他们也安装了此模组并拥有相同的模型文件。

问：与光影模组兼容吗？

答：基础渲染与 Iris/Optifine 兼容，但卡通渲染和 GPU 蒙皮目前不支持光影。使用光影包时请在设置中禁用这些功能。

🙏 鸣谢

此模组基于以下项目：

• KAIMyEntity 作者 kjkjkAIStudio - 原版 Minecraft MMD 模组
• KAIMyEntity-C 作者 Gengorou-C - 本项目的直接前身

感谢原作者的开源贡献！

🎨 获取模型的途径

你可以在这些网站上找到 MMD 模型（请尊重模型作者的使用条款）：

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

享受你在 Minecraft 中的 MMD 体验吧！