アバター · VRM — もっと深く
アバターに、少し手当てが必要なとき。
インポートエラーの意味と直し方、そして実例をひとつ丸ごと。そのままでは入ってこないアバターのために。
VRM 0.xとVRM 1.0のどちらも、通常は変換せずインポートできます。インポーターが別の問題を報告したときだけ、このページを開いてください。
インポートエラー一覧
インポートに失敗したとき — その意味と、直し方。
多くの失敗を防ぐための簡単な確認事項。ファイル名の変更による「変換」はしないでください(例:.gltf→.vrm)— 正しいエクスポーターで書き出します。.glbを推奨します(バッファとテクスチャを内包します)。手動編集ではなく、元のシーンから再エクスポートしてください。オプティマイザを使った場合は、まず最適化なしで書き出してみてください。
ファイル形式が認識されない
"This file type isn't recognized." · "Unsupported version." · "Unknown / Legacy glTF." — インポーターがこのファイルを対応形式・対応バージョンとして読み取れていません。対処:VRMはVRM 0.xまたはVRM 1.0の.vrmとして、glTFは2.0(GLB推奨)で再エクスポートします。FBXはBinary / ASCIIの切り替えや別のバージョンプリセットを試し、オプティマイザを挟まないクリーンなパイプラインで書き出してください。
VRMのバージョンとVRMC_vrmメタデータ
"…failed validation: Missing specVersion / meta / meta.name / humanoid." — VRM 1.0として書き出されたファイルのVRMC_vrmブロックが不完全です。対処:VRM 1.0対応のエクスポーターから、有効なspecVersion、metaブロック(少なくともname)、検証を通るhumanoid定義を含めて書き出します。VRM 0.xはこの1.0用メタデータを使わず、MEsでもそのまま対応しています。
Humanoidマッピングとリグ階層
"Some required humanoid bones aren't mapped." · "Parent mismatch for {Bone}…" · "…has a parent that doesn't exist." — humanoidマッピングと、実際のボーンの親子関係が食い違っています。対処(Blender):Edit Modeで各ボーンの親を確認し、必須のhumanoidボーンをすべて実在のボーンにマッピングし、マッピングしたボーンの親もマッピングされていることを確認します。humanoidボーンを、humanoid以外の補助ボーンに割り当てないでください。アバターのVRMバージョンは変えずに再エクスポートします。
インポート上限の超過
マテリアルスロット · ボーン · メッシュプリミティブ · 三角形 · 頂点 · インデックスが多すぎる。 対処:マテリアルを統合する(アトラス化・ベイク)、「Only Deform Bones」を有効にする、同じマテリアルを共有するメッシュを結合する、デシメートやリトポロジーでポリゴンを削減する、またはアセットを複数のメッシュに分割して、それぞれの上限内に収めます。
未対応のglTF拡張と圧縮
"…requires extensions MEs doesn't support." · "…uses meshopt compression, which isn't supported." 対処:該当の拡張を無効にして再エクスポートし、特殊な機能はコアのマテリアルやテクスチャにベイクします。meshoptなどのメッシュ圧縮はオフにして、プレーンなGLBとして書き出してください。
構造・パースの失敗
"No mesh geometry to import." · "Buffer view… has no buffer." · "Invalid JSON / Invalid glTF." · FBX: "Truncated file / Invalid UTF-8 / Unsupported version." — 内容が壊れているか不整合です。多くは手動編集や、過度な最適化が原因です。対処:DCCツールから、後処理なしの新しいGLBを再エクスポートします。メッシュ(スケルタルメッシュの場合はスキンウェイトとジョイントも)が実際に含まれていることを確認し、ファイルを手動編集しないでください。
ひとつの実例
LAPWINGをMEsにアップロードする
実在のアバターで、パイプライン全体をたどります — BOOTHのモデルLAPWINGをBlenderで準備し、VRM 1.0として持ち込みます。
始める前に、BlenderにVRMアドオンをインストールして、有効化しておく必要があります。
- 1
テクスチャを準備する
すべてのテクスチャファイルをPSD → PNGに変換します — ファイルが軽くなり、インポート時の問題も避けられます。
- 2
LAPWINGのFBXをBlenderにインポート
ベースモデルを読み込みます。
- 3
(任意)ボレロ/ケープを削除する
この衣装を使わない場合は削除します。手はいまケープの中に隠れていますが、気にしなくて大丈夫です — シェイプキーを削除すると元に戻ります。
- 4
メッシュを結合する
Shadingで、すべてのメッシュオブジェクトを選択 → Object → Join。マテリアルの扱いがすっきりします。
- 5
不要なシェイプキーを削除する
Shape Keysを開いて、すべて削除します — 手が元に戻り、ファイルサイズも小さくなります。実際に使う表情のシェイプキーだけを残してください(Valueを0 → 1にするとプレビューできます)。
- 6
マテリアルとテクスチャを割り当てる
体の場合:LapBody.004を選択し、Image Textureを追加(Shift+A)、そのColorをBase Colorに接続して、「Open」でLapwingBody.pngを開きます。必要に応じてEmissionを0.2で追加します。残りも同様に:
マテリアル → テクスチャ マテリアル テクスチャ(PNG) LapEye.004 LapwingBody.png LapHair.004 LapwingHair.png LapShoesBag.004 LapBagShoes.png LapClothes.004 LapwingClothes.png LapwingUnderwear.004 LapUnder.png LapShadow.004 base color + Emission 0.1 - 7
VRM 1.0を確認する
ファイルがVRM 1.0に設定されていることを確認します。
- 8
エクスポートして、再インポートする
VRM 1.0としてエクスポートし、Blenderに再インポートして、もう一度VRM 1.0としてエクスポートします。この二度書き出しで、腕の不自然なねじれ(“noodle arms”)を防げます。
- 9
MEsにインポートする
MEsを開き、最終のVRMをアップロードすれば、LAPWINGが使えるようになります。🎉
