MmdSkin · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

MMD皮肤 - 将MMD模型带入Minecraft

MMD皮肤 是一款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`	必需，PMX具有优先权
纹理	`.png` / `.jpg` / `.bmp` / `.tga`	由模型引用
动画	`.vmd`	可选，模型专属
形态	`.vpd`	可选，模型专属

模型检测规则：

扫描每个子文件夹中的.pmx或.pmd文件
如果存在多个模型文件，优先选择model.pmx或model.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`）

如果安装了TouhouLittleMaid，对准女仆并按B打开女仆专属选项。

提示： 键位可以在选项 → 控制 → MMD皮肤分类中自定义。

⚙ 设置

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

渲染

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

性能

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

卡通渲染

启用卡通效果 - 启用赛璐璐着色
卡通等级 - 阴影等级数量（2-5）
边缘光 - 边缘高光
阴影颜色 - 自定义阴影色调
高光 - 高光设置
描边 - 模型轮廓线（宽度和颜色）

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

🔧 使用技巧

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

📝 支持的格式

格式	扩展名	说明
PMX	`.pmx`	MikuMikuDance模型（推荐）
PMD	`.pmd`	旧版MMD模型
VMD	`.vmd`	MikuMikuDance动作数据
VPD	`.vpd`	Vocaloid姿势数据（形态）

💡 常见问题

问：我可以使用任何MMD模型吗？
答：大多数PMX/PMD模型应该都能正常工作。高面数模型可能会影响性能。

问：物理效果对所有模型都有效吗？
答：物理模拟取决于模型是否正确配置了刚体和关节。

问：其他玩家能看到我的模型吗？
答：可以，如果他们安装了该模组并拥有相同的模型文件。

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

🙏 致谢

本模组基于以下项目：

KAIMyEntity 作者 kjkjkAIStudio - 原始Minecraft MMD模组
KAIMyEntity-C 作者 Gengorou-C - 本项目的前身

感谢原作者的开放源代码贡献！

🎨 在哪里获取模型

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

在Minecraft中尽情享受MMD的乐趣吧！