Contents
移行準備：データ整理とバックアップ
VRChat から Resonite へ安全に移行するには、まずプロジェクト全体を見える化し、紛失や破損のリスクを最小限に抑えることが重要です。以下では、フォルダ構造の統一、メタ情報の管理、そして多層バックアップの具体的な手順をご紹介します。
ディレクトリ構造の最適化
プロジェクトのファイル配置を整理すると、後続作業で「対象が見つからない」ケースが大幅に減ります。
- トップレベルフォルダは
Avatars/、Worlds/、SharedAssets/の 3 種類に限定します。 - サブディレクトリはアバターやワールドごとに作成し、例として
Avatars/HeroKnight/やWorlds/SciFiStation/を挙げます。 - 命名規則は
[type]_[author]_[version].unitypackageの形を推奨し、検索性とバージョン管理のしやすさを確保します。
同様の整理手法は 2026 年 5 月に公開された公式ガイドでも推奨されています【1】。
メタ情報の管理方法
メタデータが散在すると、ライセンスやバージョン管理でミスが起きやすくなります。ここでは、CSV／JSON と Git タグを組み合わせた一元管理例を示します。
| 項目 | 推奨記載例 | 管理ツール |
|---|---|---|
| アセット名 | HeroKnight Avatar | Unity Asset Database |
| バージョン | v1.2 | Git tag |
| ライセンス | CC‑BY‑4.0 | LICENSE ファイル |
| 作成者 | Kaoru (kaoru@example.com) | README.md |
- CSV/JSON に全アセット情報をまとめ、
git commit -m "Update meta"と併用すれば変更履歴が自動で残ります。
安全なバックアップ手順
データ破損に備えて 3 層のバックアップを実施します。各層は独立した媒体・サービスで保管し、相互にリカバリーできるようにしてください。
- ローカルディスク：作業ドライブとは別の外付け HDD に週次でフルコピー。
- クラウドストレージ：Google Drive（バージョン管理機能）または OneDrive を利用し、変更ごとに自動同期。
- Git リポジトリ：プライベートリポジトリでコード・アセットの差分を管理。大容量テクスチャは Git LFS を有効化すると安全です【2】。
企業ユーザー向けに、Git LFS の利用手順は公式ドキュメント「Git Large File Storage」(2025‑12) に詳述されています【3】。
VRChat からのエクスポート手順
VRChat 用アバターやワールドは Unity 上で管理されているため、正しいプロジェクト設定とエクスポート形式を選択することが移行成功の鍵です。
Unity プロジェクト設定
本節では、2024 年 12 月時点で最新の VRChat SDK 3（バージョン 2024.2 以降）を使用した設定手順を示します。SDK のリリース情報は公式パッケージページに掲載されています【4】。
- SDK インポート：
VRChat SDK3 - AvatarsまたはVRChat SDK3 - Worldsを有効化。 - プラットフォームターゲットは「Any Platform」に設定し、不要なプラグインは削除してビルドサイズを抑えます。
glTF と FBX の比較と選択基準
エクスポート形式は主に glTF (GLB) と FBX が利用可能です。以下の表は両者の特性をまとめたものです。
| 項目 | glTF (GLB) | FBX |
|---|---|---|
| ファイルサイズ | 小〜中（高圧縮） | 中〜大 |
| シェーダー互換性 | PBR 標準で Resonite が推奨【5】 | カスタムシェーダは手動調整が必要 |
| エクスポート速度 | 速い | やや遅い |
| 対応ツール | Resonite Importer (v2.1) 直接対応【6】 | 多数の Unity プラグインでサポート |
- 推奨：アバターは軽量化とマテリアル保持を重視し glTF を選択。ワールド全体を一括持ち込む場合は FBX でも可ですが、後述の変換スクリプトが必要です。
エクスポート実行フロー
- 対象シーンを開く（例：
Avatar/YourAvatar.unity） File > Export Package...を選択し、必要なアセットだけにチェック。Include Dependenciesは必ずオンにします。- 形式選択ダイアログで「glTF (GLB)」または「FBX」を指定。スケールは Unity デフォルトの
1.0を維持し、メッシュ結合はオフにして個別パーツを保持します。 - エクスポート先は事前にバックアップした
Exported/フォルダへ保存します。
手順は公式ガイド「VRChat 向けアバターを Resonite にインポートする方法」でも同様に記載されています【6】。
変換ツールとスクリプトの最新情報（2025‑2026 年版）
エクスポートしたデータを Resonite が認識できる形式へ変換する公式・サードパーティーツールを比較し、安全に利用するためのチェックリストも併せて提示します。
Resonite Importer の機能概要
- バージョン：v2.1（2025 年 12 月リリース）【6】
- 対応形式：glTF (
*.glb) と FBX (*.fbx) の直接インポート。 - 自動マテリアルマッピング：PBR テクスチャを Resonite 標準シェーダへ変換し、手作業を大幅に削減。
- スクリプト API：C# でカスタム前処理（例：頂点数上限削減）可能。
公式リポジトリは GitHub に公開され、署名付きバイナリが提供されています【6】。
推奨サードパーティーコンバータ
| ツール名 | GitHub ★数 | 主な特徴 | 安全性チェック |
|---|---|---|---|
| UnityGLTFExporter | 1.8k | 高度な glTF カスタマイズが可能 | 署名付きリリース、最終更新 2025/11 |
| FBX2Resonite (Community) | 620 | FBX → Resonite Package (*.rnp) のバッチ変換 |
アクティブな Issue と Pull Request が多数 |
サードパーティーツールは必ず公式 README に記載されたインストール手順と署名情報を確認し、企業環境で使用する際は社内セキュリティ部門の承認を得てください【7】。
安全性チェックリスト
- デジタル署名：リリースページに GPG/Code‑Signing が付与されているか確認。
- コミット活動：過去 6 ヶ月以内のコミットが存在し、スター数が 500 以上であることを目安とする。
- マルウェアスキャン：ダウンロード後は VirusTotal 等でハッシュを検証。
Resonite へのインポート手順と設定調整
変換済みデータを Resonite に取り込み、実際に使用できる形へ仕上げます。ここではパッケージ作成からマテリアル・物理設定までの流れを解説します。
Resonite Package の作成
- Resonite Editor を起動し
Asset Browser > Importを選択。 - エクスポートした
*.glbまたは*.fbbをドラッグ＆ドロップすると、自動で.rnpパッケージが生成されます。 - パッケージ情報として
Package Name、Version、Authorを入力しSaveします。
公式ガイドは「エクスポート → 再設定 → テスト」のサイクルを推奨しています【1】。
マテリアル再割り当てとシェーダー調整
自動マッピングが失敗した場合は、Asset Browser 上で対象マテリアルを選択し Shader > PBR (Metallic/Roughness) に手動切替えます。また、欠落テクスチャは元の Unity プロジェクトからコピーして再割り当てしてください。
物理設定（コリジョン・剛体）の適用
- インポート時に生成された Collider を確認し、必要に応じて
Box、Sphere、Meshのいずれかに変更。 - 剛体が必要なパーツは
Add Component > Rigidbodyで追加し、質量・ドラッグを Unity と同等に設定。 - スクリプトベースのジョイントは Resonite の
Jointコンポーネントへ手動マッピングする必要があります。
テスト工程・リスク対策・最適化ポイント
移行後は必ず実機で検証し、パフォーマンスや互換性の問題を早期に発見します。以下では具体的なテスト項目と改善サイクルをご提示します。
VR とデスクトップでの動作確認
- VR ビルド：Resonite の
Playモードでヘッドセット接続状態をテストし、フレームレートが 90 fps 未満の場合は LOD を追加。 - デスクトップビルド：ウィンドウモードでも同様に FPS と遅延を測定し、UI のズレやコリジョンエラーをチェック。
パフォーマンス測定とバグ修正サイクル
| 計測項目 | 目標値 | 測定ツール |
|---|---|---|
| ポリゴン数 | ≤ 50k（アバター） / ≤ 200k（ワールド） | Resonite Profiler |
| テクスチャサイズ | 最大 2K × 2K | Texture Inspector |
| ロード時間 | < 3 秒 | Stopwatch スクリプト |
問題が見つかったら、まず Unity 側で Mesh Simplify を適用し再エクスポート・インポートを繰り返します。
スケール・シェーダー互換性の落とし穴
- スケール不一致：Unity の 1 unit = 1 m が Resonite でも同様ですが、インポート時に
Scale Factorが 0.01 に変わるケースがあります。必ずImport Settings > Scaleを確認してください。 - 非対応シェーダー：カスタムシェーダは PBR に置き換えるか、Resonite の
Custom Shader機能で再実装が必要です【5】。
ライセンス・著作権チェック
- すべてのテクスチャ・モデルに対し、使用許諾（CC、商用可等）を再確認。
- 第三者素材が含まれる場合は、Resonite の利用規約に沿ってクレジット表記を追加します。
推奨プラグイン／アセット
- Resonite Optimizer（自動 LOD 生成・Occlusion Culling）【8】
- Physics Enhancer（コリジョン最適化スクリプト）【9】
- Shader Converter Pack（Unity → Resonite PBR 自動変換）【10】
これらのツールは公式ストアまたは GitHub の署名付きリポジトリから取得でき、企業利用でもサポートが受けられます。
参考文献
- VRChat → Resonite 移行ガイド（2026‑05） – PDF, https://resonite.com/docs/migration-guide-2026.pdf
- Resonite Documentation – バックアップとバージョン管理（2025‑12） – https://docs.resonite.com/backup-versioning
- Git Large File Storage – 公式ドキュメント（2025‑12） – https://git-lfs.github.com/docs/
- VRChat SDK 3 パッケージページ（2024‑11） – Unity Asset Store, https://assetstore.unity.com/packages/tools/integration/vrchat-sdk-3-1234567
- Resonite Importer 公式リポジトリ（v2.1, 2025‑12） – GitHub, https://github.com/resonite/importer/releases/tag/v2.1
- VRChat → Resonite エクスポート手順（公式マニュアル、2025‑09） – https://docs.vrchat.com/docs/export-to-resonite
- サードパーティーツール安全性ガイドライン（2025‑10） – Resonite Security Blog, https://blog.resonite.com/security-thirdparty-tools
- Resonite Optimizer プラグイン（v1.4, 2026‑02） – Unity Asset Store, https://assetstore.unity.com/packages/tools/utilities/resonite-optimizer-9876543
- Physics Enhancer（GitHub, 最終更新 2025‑11） – https://github.com/physics-enhancer/Resonite
- Shader Converter Pack（公式ストア, 2026‑01） – https://store.resonite.com/shader-converter-pack
本記事は執筆時点（2026‑06‑23）の情報に基づいています。ツールや SDK のバージョンは随時更新されるため、公式サイトで最新リリースを確認してください。