Files
Black-Cyan 60cce66993
Tests / test (push) Has been cancelled
初始化 VRMify 增强版(VRMify Enhanced)
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
2026-11-15 23:21:59 +08:00

6.8 KiB
Raw Permalink Blame History

其它格式 → PMX

FBX、unitypackage、uemodel、psk / pskx、xps 先转成 PMX,再走 PMX → VRM。图形界面里默认一路转到 VRM, 中间的 PMX 和解包出来的资源放在临时目录,输出目录只有 VRM;「转换成」选「只转 PMX」时输出 PMX 和 textures/。

转出的 PMX 也能直接在 MMD / PmxEditor 里用:文本编码是 MMD 要求的 UTF-16LE,材质不使用 toon,每个顶点最多 4 根 骨骼权重,贴图拷进 textures/。

FBX / unitypackage

python convert/fbx2pmx.py "model.fbx" -o "model.pmx"
python convert/fbx2pmx.py "model.fbx" --info                      # 只看结构,不转换
python formats/unitypackage_unpack.py "pack.unitypackage" --list  # 列出包里的文件
python formats/unitypackage_unpack.py "pack.unitypackage" -o out  # 解包
参数 说明
--scale mmd / raw / 倍率 默认缩放到 MMD 标准身高(约 20 单位);raw 保持 FBX 原尺寸
--alpha auto / keep / strip 贴图透明通道:默认逐张判定,keep 原样保留,strip 一律去掉
--no-auto-facing / --face-180 关掉朝向自动判定 / 在判定结果上再转 180°
--no-morphs / --max-morphs N 不导出表情 / 最多导出 N 个
--keep-untextured-meshes 保留没有材质的网格(默认跳过)
--no-center 不把模型移到原点、落到地面
--no-flip-z 不做右手系 → 左手系转换(调试用)
  • 格式:二进制和 ASCII FBX 7.x,不需要 FBX SDK。网格、UV、法线、蒙皮权重、骨骼层级、BlendShape 表情都会转换; 四边形自动三角化,绕序按法线自动判定。
  • 朝向:FBX 没有「正面朝哪」的字段,按脚尖骨骼方向判定,没有脚尖时看脸部网格的位置。判错时用 --face-180。
  • 贴图透明:MMD 把贴图 alpha 当作材质透明度,而游戏贴图的 alpha 常常存的是别的数据(高光、遮罩),留着会让整块 模型变透明。auto 按 alpha 的分布判断是真透明还是数据遮罩;去掉 alpha 的贴图另存为 <名字>_noalpha,不改原文件。
  • 效果片:没有材质的网格多是游戏里的特效面片,转出来会是一块盖在身上的灰板,默认跳过。
  • Unity 资源:FBX 里没写贴图文件名时(unitypackage 里常见),按 Unity 的材质文件(.mat)找回贴图。
  • 命名:英文骨名(HumanIK / Mixamo / VRoid / Blender / 3ds Max 风格)和英文表情名(VRChat、VRoid、MTH_A 等) 在转 VRM 时自动对应;PMX 里保留原来的英文骨名,所以直接套 MMD 动作(按日文骨名匹配)需要先改名。
  • 替换网格:同一位置的几套网格(手势、张嘴的头)只显示一套,其余做成切换用的表情。
  • unitypackage:本质是 gzip 打包的 tar,界面里直接加即可;包里有几套服装时会同时转。只有衣服 / 配件、没有身体的 模型在开启「只转换人物」时跳过。
  • FBX 里没有物理(刚体、关节)。转 VRM 时会按骨骼名自动补 SpringBone。

uemodel(UEFormat)

FortnitePorting / FModel 导出的 .uemodel(UEFormat v1~v10)。

python convert/uemodel2pmx.py "model.uemodel" -o "model.pmx"
python convert/uemodel2pmx.py "part.uemodel" --align-to "body.uemodel"   # 把拆开的部件放回整身模型上
参数 说明
--scale fixed / mmd / 倍率 默认 fixed:按 UE 厘米统一换算,几个部件保持相对大小;mmd 每个文件各自归一到 20 单位
--align-to 整身.uemodel 按 *_adjust 骨求平移,把部件对齐到整身模型(界面里在「其它格式」页选参考模型)
--lod N 用第几级 LOD
--keep-alpha 保留贴图 alpha(默认去掉:UE 贴图的 alpha 多是数据遮罩)
--no-textures / --no-add-uv 不关联贴图 / 不写附加 UV
--edge / --force-double-sided 开启轮廓线 / 材质双面
--fbx 同时写一份 ASCII FBX

贴图不在 .uemodel 里:按导出目录里的材质实例 MI_<材质名>.json 找基础色贴图。表情(MORPHTARGETS)转成顶点表情。

psk / pskx(Unreal ActorX)

python convert/psk2pmx.py "model.pskx" -o "model.pmx"
参数 说明
--scale mmd / raw / 倍率 默认归一到 20 单位
--raw-bone-names 骨骼保留原始英文名(默认转 MMD 日文标准名,原名写进英文名字段)
--no-ik 不补 MMD 的足 IK 骨
--no-morphs 不导出表情
--keep-alpha 保留贴图 alpha
--no-textures / --no-add-uv 不找贴图 / 不写附加 UV
--edge / --force-double-sided 开启轮廓线 / 材质双面
--fbx 同时写一份 ASCII FBX
  • 骨骼:3ds Max Biped 的 Bip001* 命名转成 MMD 标准日文名(Bip001Pelvis → センター、Bip001LThigh → 左足 …), 对应不上的保留原名;按腿部骨链补 左足IK / 左つま先IK,在 MMD 里可以直接摆姿势。
  • 表情:MRPH 顶点位移转成 PMX 顶点表情;附加 UV(EXTRAUVS)写成 PMX 附加 UV。
  • 贴图:按材质名在源文件目录里找同名图片,找不到时是白模(日志会提示)。
  • 参考实现:io_scene_psk_psa。

xps(XNALara)

python convert/xps2pmx.py "model.xps" -o "model.pmx"
参数 说明
--scale mmd / raw / 倍率 默认归一到 20 单位
--raw-bone-names / --no-ik 保留英文骨名 / 不补足 IK
--show-unused unused 占位骨也放进主表示枠(默认单独一组)
--one-sided 材质不默认双面
--no-textures / --edge / --fbx 不拷贴图 / 开启轮廓线 / 同时写 FBX

XPS 的英文描述式骨名(arm left elbow、leg right knee …)转成 MMD 标准日文名;贴图 alpha 保留(XPS 的 alpha 就是 头发、睫毛的透明度)。XPS 没有表情。

常见问题

PmxEditor 打开时提示「アンカーデータの読み込みに失敗しました」:PmxEditor 会自动加载和模型同名的 .psk 当作 锚点数据,而 .psk 也是 Unreal 网格的扩展名。点确定即可,模型不受影响;把 PMX 换个名字或文件夹,或者关掉 [ファイル] → [アンカーデータの自動読み込み/保存] 就不会再弹。

MMD 提示无法载入 PMX:MMD 只读 UTF-16LE 编码的 PMX。本工具输出的都是 UTF-16LE;别处来的文件可以用 python formats/pmxio.py "旧文件.pmx" 转换编码(-o 指定输出,--in-place 覆盖原文件)。

模型背对镜头 / 躺倒:FBX 用 --face-180;其它格式的轴约定是固定的,遇到特殊的源文件可以在 PmxEditor 里绕 Y 转 180°。