从 .pmx 到渲染出图:MMD Tools 在 Blender 中的完整上手路径
【免费下载链接】blender_mmd_toolsMMD Tools is a Blender addon for importing/exporting Models and Motions of MikuMikuDance.项目地址: https://gitcode.com/gh_mirrors/bl/blender_mmd_tools
你手头有一个 .pmx 模型,想把它完整搬进 Blender 参与渲染,跑完动作再导回去给 MMD 接力——MMD Tools 就是干这个的:它是 Blender 的 MMD 插件,PMX 模型、VMD 动作、VPD 姿势全部能读能写,本文带你装好插件、导入示例角色、回放 30fps 动作,最后导回 .pmx 形成闭环。
对齐 Blender 与插件版本,30 秒确认 PMX、VMD、VPD 都能读能写
| 扩展名 | 文件内容 | MMD Tools 能力 |
|---|---|---|
| .pmx / .pmd | 模型:网格、骨骼、材质、表情、刚体与关节 | 读取 + 写出(导出 .pmx) |
| .vmd | 动作:骨骼动画,含相机、灯光、表情轨道 | 读取 + 写出 |
| .vpd | 姿势:单帧摆姿数据 | 读取 + 写出 |
Blender 4.2–5.1 → MMD Tools v4.x(当前主线,推荐);Blender 3.6 → v2.x(旧分支已停维,需单独找对应发行包)。
⚠️ 避坑:Blender 和插件版本错配的后果不只是按钮消失——轻则 N 键侧边栏整个 MMD Tools 选项卡不出现,重则导入 PMX 时直接报错崩溃。动手装之前,先跑
blender --version把数字对上表。
在 Get Extensions 搜索安装 MMD Tools,按 N 键确认侧边栏选项卡出现
🎯 推荐在线安装(Blender 4.2+),全程 3 步:
- 编辑 → 偏好设置 → 系统 → 网络:勾选"允许在线访问" → 这是后面能搜到插件的前提
- 编辑 → 偏好设置 → 获取扩展(Get Extensions):搜索框输入 MMD Tools,点 Install → 装完不用重启
- 3D 视图 → 按 N 键:侧边栏出现 MMD Tools 选项卡 → 安装成功
还在用 Blender 3.6?改走偏好设置 → 插件 → 从磁盘安装,选 v2.x 的 .zip 发行包再启用即可。
统一验证标志:按 N 键,侧边栏出现 MMD Tools 选项卡 = 装好。
导入示例 PMX 与 VMD,跑通 30fps 回放再导回 .pmx
🎉 仓库自带素材不用自己找:samples/pmx/里有初音ミク.pmx、巡音ルカ.pmx 两个示例模型,samples/vmd/里有 test.vmd,正好凑成一个完整流程:
- 导入模型:文件 → 导入 → MikuMikuDance Model选 .pmx → 角色带骨骼、材质、表情键出现在视口;若这一步报错,直接跳第 6 节对表
- 导入动作:文件 → 导入 → MikuMikuDance Motion选 .vmd → 帧率与帧范围自动设为 30fps
- 回放验证:按空格或时间轴播放键 → 镜头扫一遍,检查关节有没有穿模、裙摆是否跟着动 → 异常对照第 6 节处理
- 导回原格式:选中模型,文件 → 导出 → MikuMikuDance Model(.pmx)→ 得到的文件回 MMD 打开依然正常,动作同理走 VMD 导出
用材质转换、刚体物理与中文本地化,把画面调得更像 MMD 原版
- 材质转换面板 —— Cycles 与 Eevee 间自动切换,生成考虑 Alpha 通道的着色器,不用手工重搭节点
- 刚体与关节 —— 导入时已映射成 Blender 物理对象,裙摆、长发在视口里直接可预览
- 内置 toon 贴图 ——
mmd_tools/externals/下 toon01–10 共 10 张默认贴图,MMD 标志性的卡通阴影一步还原 - 本地化 —— 提供 zh_HANS 与 ja_JP 翻译,Blender 界面切中文后所有面板同步跟随
对照 5 类现象排查 PMX 导入报错、VMD 姿势不一致和物理失真
| 现象 | 原因 | 处理办法 |
|---|---|---|
| N 键侧边栏没有 MMD Tools | Blender 与插件版本错配 | 见第 2 节对照表换用匹配版本 |
| 模型发粉发黑 | 贴图路径丢失 | 把纹理放回模型同目录,用面板"重新链接纹理"修复 |
| VMD 导入后姿势与 MMD 对不上 | Blender 与 MMD 的 IK 求解器算法不同 | 已知差异,在 Blender 里手动微调关键帧 |
| 裙摆物理和 MMD 里不一样 | MMD 用旧版 Bullet 软约束,Blender 用新版硬约束 | 改用 MMDBridge 等外部物理桥接方案 |
| 导入即崩溃 | Blender 刚体系统在大量约束下不稳 | 导入后禁用不需要的刚体,或改用外部物理桥接 |
💡 技巧:发粉发黑的模型,九成是贴图没跟模型放在一起——先确认纹理与模型同目录,再点"重新链接纹理",基本都能救回。
跑通 34 个自动化测试验证环境,再进 mmd_tools/core 读源码
项目 tests 目录下共有 34 个测试脚本,覆盖 PMX 导入导出、VMD 动作转换、材质、表情、刚体物理等全部核心链路,一行命令全量跑:
blender --background -noaudio --python tests/all_test_runner.py -- --verbose看到 "All tests passed!" 输出就说明环境没问题,下图是一次完整运行的真实结果:
想读代码或改插件,先拿到仓库:
git clone https://gitcode.com/gh_mirrors/bl/blender_mmd_tools跑顺之后翻mmd_tools/core/:pmx、vmd、vpd、pmd 四个子目录各自负责一种二进制格式的解析与写出,结构清晰,是学习二进制格式解析的好素材。别光收藏——打开 Blender,把第一个模型导进去。
【免费下载链接】blender_mmd_toolsMMD Tools is a Blender addon for importing/exporting Models and Motions of MikuMikuDance.项目地址: https://gitcode.com/gh_mirrors/bl/blender_mmd_tools
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考