✨ 特色- 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.pmxMikuMikuDance型号（推荐）
PMD.pmd遗留的MMD模型
VMD.vmdMikuMikuDance 运动数据
维吉尼亚警察局.vpdVocaloid 姿态数据（变形）💡 常见问题问：我可以使用任何MMD模型吗？
答：大多数PMX/PMD模型都能正常工作。非常高多边形的模型可能会影响性能。
问：物理效果适用于所有模型吗？
答：物理仿真依赖于模型是否正确配置刚体和关节。
问：其他玩家能看到我的模型吗？
答：可以，如果他们也安装了模组并且使用相同的模型文件。
问：这和着色器模组兼容吗？
答：基础渲染兼容Iris/Optifine，但Toon Rendering和GPU蒙皮目前不支持着色器。使用着色器包时，请在设置中禁用这些功能。
🙏 制作人员该模组基于以下项目：
感谢原作者们的开源贡献！
🎨 模型获取渠道您可以在这些网站上找到MMD模型（请尊重模型作者的使用条款）：
祝你在Minecraft中玩MMD的愉快！
