メインコンテンツまでスキップ

チュートリアル：VRM1

VRChat PC向けのアバターを非破壊編集ワークフローでアバターカメラアプリ向けのVRM1.0に出力するチュートリアルです。

VRChatアバター特有の機能を使用していないほとんどのNDMFプラグインも利用可能です。

TIPS

cluster VRM1.0のアバターを出力する場合は、このチュートリアルの指示に従った後、 チュートリアル＋：VRM1 cluster を読んでください。

前提条件​

以下の事項に関して、基本的な知識を持っている人が対象です。

  • Unityの操作
  • （Modular Avatarを利用した）VRChat向けアバターの改変
  • UniVRMアバターの改変

VRCSDK Avatarsプロジェクトの作成​

本チュートリアルではVRChat想定アバターの設定を読み込む目的でVRCSDKを利用します。

ALCOM などでVRCSDK Avatarsのプロジェクトを作成した上で、アバターのインポートを行ってください。

ALCOM があれば、 VPM Repo: のURLをリポジトリとして登録することで、VPMパッケージを追加できるようになります。

ライブラリのインストール​

INFO

特に明記されていない場合、ライブラリは最新版をインストールするようにしてください。

特にNDMFのクロスプラットフォームサポートは歴史が浅く更新が活発なため、ベータ版のライブラリを使う方が安全です。

NDMFのインストール​

Modular Avatar を利用しているプロジェクトには既にインストールされているはずです。

（アバターが未改変、などの理由で）まだインストールされていない場合は、NDMFをインストールしてください。

Non-Destructive Modular Framework (NDMF)
Docs: https://modular-avatar.nadena.dev/ja/
VPM Repo: https://vpm.nadena.dev/vpm.json
アバターを非破壊改変するツールを連携して動作させるために使います。

ATiV Suiteのインストール​

VPM Repo: https://vpm.kaikoga.net/index.json

ATiV Suite をインストールするか、以下の個別ライブラリをインストールしてください。

Ablet
他のアバター編集ツールを自動的に動かすための基盤ライブラリです。

Emote Wizard
VRMアバターの表情とリップシンクの設定を行います。

Avatar Tinker Vista
VRMのメタデータを設定します。

Avatar Tinker Vista - ApplyOnPlayHack
NDMFのApply On PlayでVRMアバターをVRMアバターとしてビルドできるようにします。

QuestReplacer
VRM1.0で使うMToon10マテリアルの生成と、ビルド時のマテリアル差し替えを行います。

UniVRMのインストール​

Avatar Tinker VistaのVRM1.0出力はUniVRMを利用するため、UniVRMをインストールしてください。

UniVRM
Docs: https://vrm.dev/
GitHub Releases: https://github.com/vrm-c/UniVRM/releases
UnityでVRMアバターを取り扱うために使います。

INFO

UniVRM 0.131.0をUPMでインストールするには、以下のURLをいずれかの方法で追加してください。

    "com.vrmc.gltf": "https://github.com/vrm-c/UniVRM.git?path=/Packages/UniGLTF#v0.131.0",
    "com.vrmc.univrm": "https://github.com/vrm-c/UniVRM.git?path=/Packages/VRM#v0.131.0",
    "com.vrmc.vrm": "https://github.com/vrm-c/UniVRM.git?path=/Packages/VRM10#v0.131.0",

unitypackageによるインストールも可能です。

外部ライブラリのインストール​

AAO: Avatar Optimizer
Docs: https://vpm.anatawa12.com/avatar-optimizer/ja/
VPM Repo: https://vpm.anatawa12.com/vpm.json
ボーン数やメッシュ数を削減したり、全体的な負荷軽減を行います。

本チュートリアルでは以上のツールの使い方の説明はしません。 使い方はそれぞれのリンク先を参照してください。

プロジェクトの準備​

技術的な理由から、NDMFでVRMアバターを編集する際にはNDMFのApply on Playは不都合が多いです。

このため、Apply on Playの仕組みをNDMFからAbletに切り替えます。

メニューバーから Tools → Ablet → Ablet Settings Window を選択し、 Ablet 優先設定 を押してください。

これでプロジェクトでApply on Playを扱えるようになります。

NOTE

VRMアバターのApply on Playを行わないのであれば、この設定変更は不要です。

ただし、AbletではなくNDMFからビルドするため、ビルド手順が変わります。

TIPS

Ablet 優先設定 のままNDMFのプラグインを利用したりVRChatのアバターを改変しても、多くの場合は問題ありません。

ただし、NDMFのApply on Playとは挙動が異なる場合があります。

シーンの準備​

もしあなたがアバターごとに別々のシーンを作るスタイルなら、新しいシーンを作ってください。

シーンにVRChat PC向けアバターのプレハブを置いてください。 プレハブのUnpackは不要です。

NOTE

Unityのプロジェクトを分ける必要はありませんが、VRChat PCにアップロードするためのアバターとは別のオブジェクトとして編集することをお勧めします。

「アバターをVRChatにアップロードした時はVRChat向けの設定になり、VRM出力した時はVRM向けの設定に変わる」というワークフローは素晴らしく見えます。 しかし、自動変換だけで見た目を合わせるにはシェーダーの機能的差分が大きく、また自動変換でうまくいかなかった場合の微調整も難しいため、今回は目指しません。

最後に、もしあなたがアバターのPrefab Variantを作るスタイルなら、アバターをPrefab Variantにしてください。

セットアップ​

VRMアバターへの変更​

  1. VRC Avatar Descriptor と VRC Pipeline Manager を削除してください。
  2. アバターに VRMInstance コンポーネントを追加してください。 これがアバターをVRM1.0として扱うためのマーカーとなります。
INFO

UniVRM単体でVRMアバターの改変を行う場合、 VRM10Object の作成が必要になります。

Avatar Tinker Vistaで VRM10Object を自動生成し、内容の設定まで全て行うため、UniVRMの Create new VRM10Object and default Expressions. select target folder ボタンを押す必要はありません。

マテリアルの差し替え​

VRChat向けアバターをVRM1.0へ出力するためには、マテリアルがUniVRMで利用可能である必要があります。

アバターを右クリック→ Quest Replacer → New VRM1 から、 Quest Replacer を作成してください。

Quest Replacer の Database が必要に応じて自動生成されるので、クリックして参照し、必要に応じて Generated Directory 以下の設定を確認してください。

TIPS

生成された Quest Replacer Database は Assets/ 以下の好きなディレクトリに移動して良いです。

アバターに戻ったら、 Quest Replacer の Sync and Generate ボタンを押してください。 ダイアログが何回か表示される場合がありますが、 OK を押してください。

INFO

シェーダーを変更するため、アバターの見た目がおかしくなることがあります。

その場合、生成されたシェーダーを調整して対応してください。

VRC PhysBonesの変換​

VRChat向けアバターの揺れものをVRM1.0の出力に反映するためには、 VRC Phys Bone をVRM1.0のSpringBoneに変換する必要があります。

  1. アバターを右クリックし、 Avatar Tinker Vista → Extract VRC PhysBones as ATiV Generate Dynamics を実行します。
    • ダイアログが表示されるので、 Just Generate をクリックします。
  2. アバターを右クリックし、 Avatar Tinker Vista → Extract VRC Constraints as ATiV Generate VRM1 Constraints を実行します。
    • ダイアログが表示されるので、 Just Generate をクリックします。
  3. アバターの子に生成された Secondary オブジェクトに ATiV Delete All VRC PhysBones コンポーネントを追加することで、アバターのVRC PhysBoneを削除するようにします。

アバターの子に生成された Secondary オブジェクト以下にSpringBoneの設定が入っている状態になります。

Unityのプレイモードに入ることで、 ATiV Generate 系コンポーネントは実際のVRMのSpringBoneに変換され、揺れものの動作確認ができます。

INFO

元の VRC Phys Bone の設定を残してあるので、 Secondary 以下に生成されたAvatar Tinker Vistaコンポーネントを削除することで、生成をやり直すことが可能です。

表情とリップシンクの設定​

VRChatとVRMではアバターの表情設定の互換性がないため、このままだと表情が動かないアバターになります。

Emote WizardでVRMアバターの表情とリップシンクの設定が行えるため、利用します。

  1. アバターを右クリックし、 Emote Wizard → Emote Wizard Root します。
  2. Emote Wizard Root の Setup を開き、Quick Setup VRM Sources します。
  3. BlendShape Sources の下に Generic Emote Sequence Source が生成されるので、内容を埋めます。

VRMメタ情報の設定​

VRMにメタ情報を設定します。

VRMメタ情報の設定はAvatar Tinker Vistaのコンポーネントで行います。

アバターに空の子オブジェクトを追加して、 ATiV Overwrite VRM0+1 Meta コンポーネントを追加し、オブジェクトに適当な名前をつけてください。 このオブジェクトでは、VRM1.0に含まれるメタ情報を設定します。

VRM一人称描画設定​

VRMの一人称描画設定はAvatar Tinker Vistaのコンポーネントで行います。

アバターに空の子オブジェクトを追加して、 ATiV Default VRM0+1 FirstPerson と ATiV Merge VRM0+1 FirstPerson コンポーネントを追加し、オブジェクトに適当な名前をつけてください。 このオブジェクトでは、メッシュごとに一人称視点と三人称視点のどちらで描画されるかを設定します。

INFO

ATiV Default VRM0+1 FirstPerson の Default Value や ATiV Merge VRM0+1 FirstPerson を Auto にすることもできます。 この場合、ヒューマノイドボーンに基づいて Both または Third Person Only が自動的に設定されます。

この方法のメリットは、簡単であることです。

この方法のデメリットとしては、 UniVRM によって自動的にメッシュが分割され、パフォーマンスに影響することがあります。

ビルド​

AbletまたはNDMFプラグインの適用が必要なので、UniVRMのExport機能は使いません。

DANGER

UniVRMからExportを行うと使用されているテクスチャファイルの圧縮設定が無圧縮に上書きされます。 この状態でVRChatに同じアバターをアップロードすると、アバターのテクスチャメモリが大幅に増加します。

特にVRChatのアバターを同じプロジェクトで管理している場合は、UniVRMからExportを行わない方が良いです。

Abletからビルドする場合​

メニューバーの Tools → Ablet → Ablet Console Window を選んでください。

Select Scene Entrypoints からアバターを選択し、表示される Export VRM1.0 Avatar ボタンをクリックしてください。 保存先選択ダイアログで指定されたパスにVRMファイルが生成されます。

TIPS

ativ:AtivExportVRMUI コンポーネントのインスペクタに表示される Export VRM1.0 Avatar with Ablet ボタンは同じ機能を持ちます。

NDMFからビルドする場合​

メニューバーの Tools → NDM Framework → Show NDMF Console を選んでください。

アバターを選択し、Avatar PlatformのVRM 1.0 (ATiV)を選択してから、表示される Export VRM1.0 Avatar with NDMF ボタンをクリックしてください。 保存先選択ダイアログで指定されたパスにVRMファイルが生成されます。

TIPS

ativ:AtivExportVRMUI コンポーネントのインスペクタに表示される Export VRM1.0 Avatar with NDMF ボタンは同じ機能を持ちます。