modelconv

Experimental 3D model converter

Goで3Dモデルファイルを読み書きするライブラリ＆変換ツールです．

仕様が良くわかからないものは実際のファイルを見ながら雰囲気で実装してるので，読み込めないデータがあるかもしれません．

Command-line tool

cmd/modelconv

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

• (.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にビルド済みのWindows用の実行ファイルを置いてあります．

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

Usage examples

MMD to VRM

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

gltf to glb

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

Unity to glb

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

Scaling

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

Flags

vrmconfig:

設定ファイルのjsonは converter/vrmconfig_presets にあるファイルや， Qiitaの記事も参考にしてください．

MMDからの変換時にはデフォルトで mmd.json が使われます．

hide,hidemat,unlit:

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

autotpose:

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

Unit:

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

例： MMD → VRM : default scale = 0.08

API

T.B.D.

Example: .pmx to .mqoz

	mmdModel, err :=  mmd.Load("model.pmx")
	if err != nil {
		return err
	}
	mqDoc, err := converter.NewMMDToMQOConverter(nil).Convert(mmdModel)
	if err != nil {
		return err
	}
	err = mqo.Save(mqDoc, "model.mqoz")
	if err != nil {
		return err
	}

License

MIT License