VR Vlog lilToon VRM Exporter
日本語 · English
lilToonのアバターを、VR Vlogで使えるVRM 1.0形式に書き出すUnity用ツールです。
MITライセンスで公開しています。
対応環境
| 必要なもの | バージョン・導入方法 |
|---|
| Unity | 2022.3 |
| lilToon | バージョンを問わず書き出せます。アプリではlilToon 2.3.4として描画するので2.3.4を推奨します（1.0.0以降と0.12.0-beta.4以降。それより前は、0.12.0-beta.1〜beta.3が2.0.0〜2.3.4、安定版0.11.15が2.3.4だけ）。VCC・ALCOMのほか、unitypackageでAssetsの下に入れたlilToonでも書き出せます |
| UniVRM | 導入不要。UniVRM 0.131.4を名前空間・シェーダー名を変えて同梱しているので、導入済みのUniVRMとはバージョンにかかわらず衝突しません |
| VR Vlog | 0.1.1（ビルド345）以降 |
| VRChat SDK | 任意。3.5.0以上3.11.0未満（3.11.0未満のベータ版を含む）で確認しています。音声再生（VRC Animator Play Audio）を含む表情ファイルを使う場合は、3.5.2以上3.11.0未満が必要です |
| NDMF | 任意。Modular AvatarなどNDMFで動くツールを使うアバターは、NDMF 1.6.0以上2.0.0未満の正式版が必要です。Modular Avatar 1.19.0-alpha.2用に、プレリリースの1.15.0-beta.1・beta.2も通します |
| Modular Avatar | 任意。Shape Changer・Object Toggle・Material Setter・Material Swap・Mesh Cutterを使うアバターは1.12.2以上1.19.0未満か、プレリリースの1.19.0-alpha.2。これらを使わないアバターはバージョンを問いません |
Modular Avatarを使う場合は、事前に導入してください。
注意
- lilToonのバージョンでは書き出しを止めません。1.x・2.3.4より新しいバージョン・プレリリースでも書き出し、アプリでは導入済みのバージョンにかかわらずlilToon 2.3.4として描画します。
- 2.3.4とシェーダーが違うところは、書き出し画面に警告として一覧で出して書き出しを続けます。2.3.4にないプロパティは書き出さず、2.3.4のプロパティと合わないマテリアルはMToonで近似します。Unityとアプリで同じ見た目にするには2.3.4を使ってください。
- 止まるのは、lilToonが入っていないときと、ベイク用シェーダー（
Hidden/ltsother_baker）が2.3.4と違うときだけです。互換性の詳細
インストール
インストールページを開く · 変更履歴
- 「VCC / ALCOMに追加」を押す。
- VCC・ALCOMで、使いたいプロジェクトのパッケージ管理画面を開く。
- 「VR Vlog lilToon VRM Exporter」を追加する。
VCC・ALCOMのリポジトリ追加画面に、次のURLを貼り付けてください。
https://vrvlog.fun/exporter/index.json
以前の個人側・組織側のURLを登録済みなら、そのまま使えます。
VCC・ALCOMを開かずに、Unityで開いているプロジェクトへ入れられます。
- Releasesから
com.vrvlog.liltoon-vrm-exporter-installer-<版>.unitypackage をダウンロードする。
- Unityで開いているプロジェクトのProjectウィンドウへドラッグ&ドロップし、Importを押す。
- 確認の画面で「Install」を押す。このリポジトリ（
https://vrvlog.fun/exporter/index.json）がプロジェクトとVCC・ALCOMに登録され、エクスポーターが Packages に入る。インストーラーのファイルは終わると自動で消える。
インストーラーは、ダウンロードした版と同じ系列（1.0.0のインストーラーなら2.0.0より前の1.x、0.12.0のインストーラーなら0.12.x）のうち、VPMの一覧にある最新の版を入れます。ベータ版のインストーラーはベータ版も選びます。Releaseに出た直後で一覧にまだ載っていない版は入らないので、少し待ってからやり直してください。特定の版を入れたいときはZIPで導入してください。
- インストールページの「ZIPで導入」を開く。
- エクスポーターのZIPをダウンロードする。
Packages 内のフォルダーへ展開する。- フォルダーの直下に
package.json があることを確認する。
- Unityの読み込みが終わるのを待つ。
使い方
安定版1.15.0の手順です。
1. アバターを準備
Unityで、書き出すアバターと衣装を表示します。親オブジェクトも有効にしてください。
2. 表情ボードを開く
Hierarchyでアバターの一番上のオブジェクトを選び、メニューの VR Vlog → アプリに転送（通常）｜Send to App... を選びます。Hierarchyでアバターを右クリックしたときの VR Vlog にも同じ項目があります（右クリックでアプリに転送する）。prefabとして保存したアバターは、Projectでそのprefabを右クリックしたときの VR Vlog からも同じように開けます。VRMファイルだけを保存するときも、この表情ボードの4ページ目の VRMを保存 を使います。
3. アバターを確認
表情ボードが開き、選んだアバターで「書き出しを準備」まで進みます。別のアバターにするときは、1ページ目の「アバター」欄の横の「変更」を押します。
4. 表情を割り当てる（任意）
見つかった表情は、すべて「その他の表情」（VRMのカスタム表情）に入ります。
- 割り当て： 表情をVRMの表情5枠（喜び・怒り・悲しみ・安らぎ・驚き）へドラッグ＆ドロップします。右クリックのメニューでも移せます。
- 除外： 使わない表情は「書き出さない表情」へ移します。
- 確認： 表情を押すとプレビューできます。
- 追加：
.anim を「その他の表情」へドロップします。
表情の名前（その表情を出すVRChatメニューの項目名も含みます）から自動で入った枠は「自動の候補○件を確定」で確定できます。表情を割り当てずに保存することもできます。
選んでから2秒で顔が止まらないメニューの表情（少し待ってから切り替わる・長いアニメーション・ループ）は、Animatorの遷移をたどった最終状態の顔で書き出し、書き出し結果の一覧に「近似」として表示します。
5. 保存
表情ボードは「1 表情の設定 › 2 視線の設定 › 3 除外するオブジェクト › 4 VRMの保存と転送」の4ページに分かれています。1ページ目で表情・瞬き・任意の全身ポーズを決め（瞬きの下の 自動で軽量化する をオンにすると、見た目の変化を抑えてテクスチャを小さくし、lilToonでオフにしてある機能だけが使うテクスチャと、どのマテリアルも読まない頂点カラーを省き、ボーンのウェイトとインデックスを詰めて書き出します。他のVRMアプリだけが表示する画像は小さくするので、他のVRMアプリでは解像度が下がります。既定はオンで、アバターごとに覚えます）、下の 次へ：視線の設定 を押します。2ページ目では、アプリでカメラを目で追うときに目が動く範囲（上・下・左右の角度）を、上下左右を見た顔のプレビューで確かめて変えられます（変えなければ今までどおり）。次へ：除外するオブジェクト を押し、3ページ目でVRChat用のギミックと手で外すオブジェクトを確認し（右側の全身のプレビューに、外したものがその場で消えます）、次へ：VRMの保存と転送 を押すと、変えた除外をプレビューに反映してから4ページ目へ移ります。4ページ目には名前・作者名・VRMの利用条件 の欄があり、下に VRMを保存 と QRコードを作る が並びます。作者名 を入力し、VRMの利用条件 を確認して VRMを保存 を押します。保存だけなら利用規約への同意は要りません。
全身ポーズがアプリの上限（128件、動くポーズのフレーム合計32,768、動くポーズのデータ16MB、静止ポーズのデータ2MB）を超えるときは、書き出しの途中で アプリの上限を超えた項目 の画面が1回だけ開きます。既定ではリストの末尾から外すので、残すポーズを選び直して この内容で書き出す を押します。選んだ内容はアバターの書き出し設定に保存し、次の書き出しと アプリに転送（かんたん） でも使います。外したポーズは書き出し結果の一覧に「同梱ポーズ」として表示します。上限内なら画面は開きません。
保存後は「保存先を開く」でファイルを確認できます。
アプリで髪や体が消える・透けるときは、書き出し結果のウィンドウか アプリに転送 の完了画面の 診断情報をコピー を押し、コピーした文字列を不具合の報告に貼ってください。メッシュとマテリアルの数値、書き出さなかったギミックの種類と数（外したギミック・カメラや音などのVRMに入らない部品・PhysBoneとコンストレイントの変換前後の数）と変換の内容だけで、アバター名・オブジェクト名・作者名・パスは入りません。
開発者からDMなどで詳しい情報を頼まれたときは、診断情報をコピー の右の ▾ から 名前・パスを含めてコピー（DM など非公開の場だけ） を選んでください。同じ内容に、アバター名、メッシュとマテリアルの名前・元のシェーダー名、外したギミックと部品の場所、変換の内容の文面と対象のパスを足した別の文字列をコピーします。先頭に「名前・パスを含みます。DM など非公開の場だけで送ってください」と入ります。公開のチャンネルやIssueには貼らないでください。
ライセンス設定
利用条件を設定する場合は、4ページ目の VRMの利用条件 を開き、元の利用規約に合わせてプルダウンを選びます。規約URL（VN3等）、著作権表示、第三者ライセンスも入力できます。設定は出力VRMのメタデータに保存されます。設定を開かない場合は、このアバターで前に書き出したときの設定で書き出します。記録が無ければ既定値（作者のみ・個人非営利・クレジット表記が必要・表現用途の各許可なし・再配布と改変なし）です。
アプリでの見え方を確認
保存したVRMを、VR Vlogアプリと同じ読み込み処理で開いて確認する画面です。1.0.0以降には、この画面を開くボタンとメニューがありません。開いた画面では、ほかの .vrm を VRM ファイルを開く で選べます。
- マテリアル: アプリと同じ表示（lilToon専用表示）か、標準のMToonだけの表示かを切り替えます。lilToonで表示できたか、MToonで表示したマテリアルの件数と理由を表示します。lilToonは公式のBuilt-in版シェーダーで描くため、アプリのURP版とは細部が異なることがあります。
- 表情: VRMの表情を1つずつ適用し、表情アニメーションを再生します。
- まばたき: 自動のまばたき（4秒ごと）か、目の閉じ具合のスライダーで確認します。自動のまばたきはこの画面だけの確認用の動きで、アプリのまばたきの間隔とは関係ありません。
- 揺れもの: アバターを左右に揺らして揺れものの動きを確認します。
この画面は、VR Vlogアプリの読み込みパッケージ（com.vrvlog.avatar-runtime）がプロジェクトに入っているときだけ使えます。このパッケージは一般には配布していません。入っていなくても書き出しは今までどおり動きます。
パッケージを参照するのは Editor/AppPreview/AvatarRuntimeBackend.cs（VRVlog.LilToonExporter.AppPreview アセンブリ）だけです。画面はこのファイルが登録するインターフェイス（Editor/AppPreviewEntry.cs の IAppPreviewBackend）だけを使います。パッケージの置き場所や名前が変わったときは、このファイルとアセンブリ定義だけを直します。
書き出したVRMをスマホで読み込む
QRコードで転送する
QR対応の最新iPhone TestFlight版が必要です。Android配布版では受信できません。
PCとスマホをインターネットに接続してください。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
