60cce66993
Tests / test (push) Has been cancelled
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
113 lines
6.8 KiB
Markdown
113 lines
6.8 KiB
Markdown
# 其它格式 → 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°。
|