Files
VRMify-Enhanced/docs/other-formats.md
T
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

113 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 其它格式 → PMX
FBX、unitypackage、uemodel、psk / pskx、xps 先转成 PMX,再走 [PMX → VRM](pmx-to-vrm.md)。图形界面里默认一路转到 VRM,
中间的 PMX 和解包出来的资源放在临时目录,输出目录只有 VRM;「转换成」选「只转 PMX」时输出 PMX 和 `textures/`。
转出的 PMX 也能直接在 MMD / PmxEditor 里用:文本编码是 MMD 要求的 UTF-16LE,材质不使用 toon,每个顶点最多 4 根
骨骼权重,贴图拷进 `textures/`。
## FBX / unitypackage
```bash
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)。
```bash
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)
```bash
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](https://github.com/DarklightGames/io_scene_psk_psa)。
## xps(XNALara)
```bash
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°。