【プロジェクト分割】VRC Project Divide

複数のアバター改変を1つのUnityプロジェクトへ継ぎ足し、「秘伝のタレ」状態になっていませんか？

VRC Project Divideは、HierarchyまたはPrefabで選んだ改変済みアバターだけを、必要な依存アセットのみをVPMパッケージ/ProjectSettings/ツール環境と一緒に、新しい独立したUnityプロジェクトへ引き継ぐEditor拡張です。複数アバターまとめて指定もできます。

アバターごとに環境を分けることで、プロジェクト破損やSDK/ツール更新時の影響範囲を分離し、関係のないアバターを抱え続ける状態を解消します。元プロジェクトは変更せず、作成後はVCC/ALCOMへ自動登録します。

制作：sunrise

🐍こんな状態になっていませんか？🐍

・改変を全部1つのプロジェクトへ継ぎ足し、何が何に必要なのか分からない

・SDKや改変ツールを更新するたび、別のアバターまで壊れないか不安

・プロジェクトを分けたいが、改変済み状態を最初から作り直したり.unitypackageを作るのは大変

VRC Project Divideは、現在の改変環境を維持したまま、選んだアバター専用の新規Unityプロジェクトを作成します。

🐍このツールの目的🐍

アバターごと、または用途ごとにプロジェクトを分けることで、プロジェクト破損やSDK/ツール更新時の影響範囲を限定できます。関係のないアバターを同じScene/Projectへ抱え続ける状態も解消できるため、環境によっては読込/検索/コンパイル/ビルド待ちの短縮にもつながります。ただし、短縮量はプロジェクト構成や導入ツールによって異なります。

🐍Project Divideでできること🐍

・複数アバターをまとめて1つの新規プロジェクトへ引き継ぎ

・VPMで導入したパッケージや.unitypackageで読み込んだ改変ツールを引き継ぎ

・作成したプロジェクトをVCC/ALCOMのプロジェクト一覧へ自動登録

🐍引き継ぐもの🐍

・指定したアバターだけを配置した新規Scene

・Unityが追跡できるAssets内の依存ファイルとそれらが属するasset全て

・各種プロジェクトの設定

Editor系フォルダは単純に除外しません。編集ツールの一部だけが移動してコンパイル不能になる事故や、Resources.Loadなど静的な依存解析だけでは見えない参照の欠落を抑えるため、関連するアセット単位で引き継ぎます。

Libraryのインポートキャッシュ、Shaderキャッシュ、Temp、Logsなど、元プロジェクト固有または再生成できる大きな一時データはコピーしません。

🐍元プロジェクトを守る設計🐍

・元プロジェクト内のファイルは変更・削除しません

・ハードリンクを使わず、独立したファイルとしてコピーします

・既存の保存先へ上書きしません

・作成途中は一時フォルダを使い、失敗時は途中データを整理します

・Windowsの禁止文字、予約名、長すぎるパス、VCC/ALCOMのインストール先などを事前に検証します

ここでいう「分割」は、元プロジェクトを切り崩す操作ではありません。元の環境を残したまま、選択したアバター用の独立プロジェクトを新しく作成します。

🐍使い方🐍

1. Unityへ本ツールを導入します。

2. Tools > S&N > VRCProjectDivide を開きます。

3. 引き継ぎたいアバタールートまたはPrefabを1体以上指定します。複数まとめてドロップできます。

4. 保存先フォルダと新しいプロジェクト名を指定します。

5. 完了後、VCC/ALCOMから新規プロジェクトを開き、SceneとConsole、作成レポートを確認してください。

🐍制限・注意事項🐍

・アバター階層外のSceneオブジェクトを直接参照している場合、その参照を新規Sceneへ持ち越せないことがあります。検出できたものは完了画面とレポートで警告します。

・文字列指定で独自にロードされるアセットなど、Unityが依存として追跡できない参照は自動検出できません。必要に応じて作成後に追加してください。

・新規プロジェクトの初回起動時はLibraryを再構築するため、UnityのImportに時間がかかります。

・引き継ぎ対象によっては多くのファイルをコピーします。保存先に十分な空き容量を用意してください。

・作成後は必ずScene、Prefab、マテリアル、アニメーション、アップロード前の動作を確認してください。

・作成先には購入済みアセットが含まれる場合があります。生成したプロジェクトや同梱アセットを第三者へ配布せず、各アセットの利用規約を守ってください。

🐍動作環境🐍

Windows、Unity 2022.3.22f1

・VCCまたはALCOMで管理しているVPMプロジェクトを想定

・Unity Editor上で動作するEditor拡張です。VRChat内で動作するツールではありません。

🐍お問い合わせ🐍

不具合や不明点はBOOTHメッセージからご連絡ください。

🐍利用規約🐍

・本データの再配布・販売・自作発言は禁止です。

・完全な挙動及び将来にわたる動作を保証するものではありません。

・本データの使用によって生じるいかなる損害についても、作者は一切の責任を負わないものとします。

🐍更新履歴🐍

2026/07/18 v1.0.0公開