modelconv

README

3Dモデルファイルを変換するコマンドラインツールです．

最新版はGitHubにあります．Windows(x64) 以外のバイナリが必要な場合はお手数ですがご自身でビルドしてください．
https://github.com/binzume/modelconv

# Usage

以下の組み合わせの変換が可能です．

- (.pmd | .pmx | .mqo | .mqoz | .fbx | .unity) → (.pmx | .mqo| .mqoz | .glb | .gltf | .vrm)
- (.glb | .gltf | .vrm) → (.glb | .gltf | .vrm) (※1)

※1: glTF同士の変換は特別扱いをしているため，モデルに変更を加えるオプションは未対応です．(scaleは可能)

## Install "modelconv" commant

新し目のGoがあればビルドできると思います．
[Releases](https://github.com/binzume/modelconv/releases/latest)にビルド済みのWindows用の実行ファイルを置いてあります．

```bash
go install github.com/binzume/modelconv/cmd/modelconv@latest
```

## Usage examples

### MMD to VRM

```bash
modelconv -autotpose "右腕,左腕" "model.pmx" "model.vrm"
modelconv -vrmconfig "model.vrmconfig.json" "model.pmx" "model.vrm"
```

### gltf to glb

```bash
modelconv "model.gltf" "model.glb"
modelconv -format glb "model.gltf"
```

### Unity to glb

```bash
modelconv  "test.unitypackage#Assets/scene.unity" "scene.glb"
modelconv  "YourProject/Assets/Scenes/scene.unity" "scene.glb"
```


### Scaling

```bash
modelconv -scale 1.5 "model.glb" "model_scaled.glb"
modelconv -scaleY 1.5 -scaleX 1.3 "model.mqo" "model_scaled.mqo"
```

## Flags

| Flag       | Description    | Default    |
| ---------- | -------------- | ---------- |
| -format    | Output format  |            |
| -scale     | Scale          | See `Unit` |
| -scaleX    | Scale x-axis   | 1.0        |
| -scaleY    | Scale y-axis   | 1.0        |
| -scaleZ    | Scale z-axis   | 1.0        |
| -rot180    | rotate 180 degrees around Y-axis |  |
| -hide      | hide objects (OBJ1,OBJ2,...) |  |
| -hidemat   | hide materials (MAT1,MAT2,...)  |  |
| -unlit     | unlit materials (MAT1,MAT2,...)  |  |
| -vrmconfig | Config file for VRM | "inputfile.vrmconfig.json" |
| -autotpose | Arm bone names |            |
| -chparent  | replace parent bone (BONE1:PARENT1,BONE2:PARENT2,...) |  |
| -physics   | Convert Physics colliders (experinemtal) | false |


### vrmconfig:

設定ファイルのjsonは [converter/vrmconfig_presets](converter/vrmconfig_presets) にあるファイルや，
[Qiitaの記事](https://qiita.com/binzume/items/d29cd21b9860809f72cf)も参考にしてください．

MMDからの変換時にはデフォルトで [mmd.json](converter/vrmconfig_presets/mmd.json) が使われます．

### hide,hidemat,unlit:

対象のオブジェクトやマテリアルの名前をカンマ区切りで指定してください．ワイルドカード(`*`)が利用可能です．

### autotpose:

腕のボーンを指定するとX軸に沿うように形状を調整します(暫定実装)

### Unit:

- MQO: 1mm
- MMD: 80mm
- glTF/VRM: 1m

例： MMD → VRM : default scale = 0.08


# License

https://github.com/binzume/modelconv
  MIT License (https://github.com/binzume/modelconv/blob/master/LICENSE)