【Unity】コンポーネントの完全転送CostumeTransferTool
- Digital100 JPY
私が！！欲しかった！！夢のツール！！ 補助ボーンの追加等でFBXとプレハブがうまくリンクしない！！ それに伴うFBXへのコンポーネントの復元作業... 指定オブジェクトの参照やコンポーネント探し... コライダー用オブジェクトの作成... PhysBoneファイル作成... 複雑なMa Item Menuの内部の解析と復元... そんな「虚無の30分」が、たったのワンクリックで終わります！ (※実際は３ドラッグ１クリックです) 元のプレハブ（Source）から、新しくインポートしたFBX（Destination）へ、コンポーネント、マテリアル、そして「複雑な参照関係」を移植します。 今までのコピーツールになかった完全な移植を実現します！
■主な機能
1. 賢いコンポーネント転送 PhysBone、Collider、Modular Avatar (MA)、Contact、Joint、自作スクリプトなど、メッシュ以外のほぼ全ての設定をコピーします。 「設定済みの衣装」のコンポーネントを、「調整後のFBX」に一瞬で移植可能です。 2. リンク切れを自動修復（参照リダイレクト） 単にコピーするだけではありません。 「PhysBoneのCollider指定」や「MAのBoneProxy指定」などが、古いオブジェクトを指したままにならないよう、自動的に「転送先の新しいオブジェクト」へ紐づけ直します。 配列やリストの中身（Inspectorで閉じている部分）まで深くスキャンして修正するため、手動での付け直し作業が不要になります。 3. Blenderの「.001」問題や階層ズレに対応 Blenderを通すとボーン名に「.001」がついたり、アーマチュアの構造が微妙に変わったりすることがあります。 本ツールは名前の揺らぎや構造を自動解析し、「これとこれはペアだ」と賢く判断して設定を適用します。 4. 足りないオブジェクトを自動生成 Blender作業で消えてしまった「コライダー専用の空オブジェクト」や「physbone用のからオブジェクト」などが元データにあれば、自動で生成・配置して復元します。 maを使ったエクスプレッションメニュー用のゲームオブジェクトも完全再現します。 5. レンダラー設定の安全な同期 メッシュやボーンのデータは新しいFBXのものを維持しつつ、「Cast Shadows」「Update When Offscreen（バウンディングボックス）」などのレンダラー設定のみを安全にコピーします。 これにより「転送したらメッシュが崩れた」「視界の端で消えるようになった」といったトラブルを防ぎます。 6. アバター本体の移行にも対応 衣装だけでなく、アバター本体のFBX更新（素体のバージョンアップなど）にも使用可能です。 ViewPositionやAvatar Descriptorの設定もそのまま引き継げます。
■使い方
ダウンロードしたスクリプトをUnityプロジェクトに入れます。 Unity上部メニュー Tools > Costume Transfer Tool を開きます。 用途に合わせてオブジェクトをドラッグ＆ドロップします。 【衣装の転送を行う場合】 Source: 設定済みの元の衣装プレハブ Dest: Blenderから来た新しい衣装FBX Root: 衣装を入れている「アバターのルート」 【アバター本体の移行を行う場合】 Source: 古いアバター Dest: 新しいアバターFBX Root: 「新しいアバターFBX(Dest)」自身 あとはExecute ボタンを押すだけ！
■こんなシチュエーションで便利
衣装の調整: 「もちふぃったー」などで変換した後、Blenderで補助ボーンを入れたりメッシュを調整したが、Unityに戻すとプレハブのメッシュが崩れるため、FBXを入れ替えて設定だけ移したい。 アバターの更新: 改変済みのアバターの設定を、作者がアップデートした新しい素体FBXに移植したい。 ボーン構造の変更: Blenderでボーン名を変更したり統廃合したが、Unity上の設定は維持したい。
■仕様・注意事項
コピーされるもの PhysBone / Collider / Contact / Joint Modular Avatar 関連コンポーネント全般 VRC Avatar Descriptor / Pipeline Manager マテリアル参照 Rendererの詳細設定（Shadows, Probes, UpdateWhenOffscreen等） その他、TransformとMesh系以外のコンポーネント コピーされないもの Transform（位置・回転・スケール） ※メッシュ崩壊を防ぐため Mesh Filter / Mesh (ポリゴンデータ) Skinned Mesh Renderer のボーンウェイト情報 Animatorについて オプションでコピー可能ですが、予期せぬ挙動を防ぐため、実行後の確認を推奨しています。