アバター · 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. 1

    テクスチャを準備する

    すべてのテクスチャファイルをPSD → PNGに変換します — ファイルが軽くなり、インポート時の問題も避けられます。

  2. 2

    LAPWINGのFBXをBlenderにインポート

    ベースモデルを読み込みます。

  3. 3

    (任意)ボレロ/ケープを削除する

    この衣装を使わない場合は削除します。手はいまケープの中に隠れていますが、気にしなくて大丈夫です — シェイプキーを削除すると元に戻ります。

  4. 4

    メッシュを結合する

    Shadingで、すべてのメッシュオブジェクトを選択 → Object → Join。マテリアルの扱いがすっきりします。

  5. 5

    不要なシェイプキーを削除する

    Shape Keysを開いて、すべて削除します — 手が元に戻り、ファイルサイズも小さくなります。実際に使う表情のシェイプキーだけを残してください(Valueを0 → 1にするとプレビューできます)。

  6. 6

    マテリアルとテクスチャを割り当てる

    体の場合:LapBody.004を選択し、Image Textureを追加(Shift+A)、そのColorをBase Colorに接続して、「Open」でLapwingBody.pngを開きます。必要に応じてEmissionを0.2で追加します。残りも同様に:

    マテリアル → テクスチャ
    マテリアルテクスチャ(PNG)
    LapEye.004LapwingBody.png
    LapHair.004LapwingHair.png
    LapShoesBag.004LapBagShoes.png
    LapClothes.004LapwingClothes.png
    LapwingUnderwear.004LapUnder.png
    LapShadow.004base color + Emission 0.1
  7. 7

    VRM 1.0を確認する

    ファイルがVRM 1.0に設定されていることを確認します。

  8. 8

    エクスポートして、再インポートする

    VRM 1.0としてエクスポートし、Blenderに再インポートして、もう一度VRM 1.0としてエクスポートします。この二度書き出しで、腕の不自然なねじれ(“noodle arms”)を防げます。

  9. 9

    MEsにインポートする

    MEsを開き、最終のVRMをアップロードすれば、LAPWINGが使えるようになります。🎉