CAUSupporter

複数の VRChat アバターを選択して、Continuous Avatar Uploader (CAU) 用の AvatarUploadSetting を一括生成するツールです。プラットフォーム (Windows / Quest / iOS) ごとの設定をまとめて適用でき、大量のアバターをグループファイルへ自動分割することもできます。

主な機能

Hierarchy で選択したアバター (VRCAvatarDescriptor を持つオブジェクト) をまとめて収集
収集したアバターから AvatarUploadSetting を生成し、既存の AvatarUploadSettingGroup へ追加
Windows / Quest (Android) / iOS のプラットフォーム別設定 (バージョニング・Git タグ付けなど) を一括適用
同じアバターが既にグループに登録済みの場合は自動でスキップ (二重登録防止)
指定した件数ごとに複数のグループファイルへ自動分割して保存する Auto-split 機能

前提条件

このツールは anatawa12 氏の Continuous Avatar Uploader (CAU) に依存しています。CAU が導入されていないプロジェクトでは、内部で参照している AvatarUploadSetting などの型が存在しないためスクリプトがコンパイルエラーとなり、メニュー自体が表示されません。先に CAU を VCC などで導入してください。

収集対象は VRCAvatarDescriptor コンポーネントを持つ GameObject です。持たないオブジェクトを選択しても収集されません。

開き方

Unity メニューバーから開きます。

Tools > Mekanyanko Tools > CAU Supporter

画面の説明

項目	説明
Avatar Upload Setting Group	追加先となる既存の `AvatarUploadSettingGroup` アセットを指定します (通常の Execute で使用)。
Set Target Avatars	現在 Hierarchy で選択しているアバターを収集リストへ取り込みます。Sibling Index 順に並びます。
Clear List	収集リストを空にします。
Collected Avatars	収集済みアバターの一覧。各行の Remove ボタンで個別に除外できます。

Platform Settings

Windows / Quest (Android) / iOS の 3 つを折りたたみ (Foldout) で個別設定します。各プラットフォーム共通の項目は次の通りです。

項目	説明
Enable	そのプラットフォームでアップロードを有効にするか。無効時は下の項目が編集不可になります。
Update Image	アップロード時にサムネイル画像を更新するか。
Versioning Enabled	バージョン名を自動付与するか。
Version Name Prefix	バージョン名の接頭辞 (Versioning 有効時のみ表示)。既定値は Windows=`ver` / Quest=`quest` / iOS=`ios`。
Git Tagging Enabled	アップロード時に Git タグを付けるか。
Tag Prefix / Tag Suffix	Git タグの接頭辞・接尾辞 (Git Tagging 有効時のみ表示)。

初期状態では Windows のみ Enable にチェックが入り、折りたたみも開いています。Versioning や Git を無効にすると、対応する Prefix / Suffix は空文字として書き込まれます。

Auto-split Settings

項目	説明
Avatars per Group	1 グループファイルあたりに含めるアバター数 (最小 1、既定 20)。
Group File Base Name	生成するグループファイル名のベース。`<ベース名>_01`, `_02` … の形式で連番が付きます (既定 `AvatarGroup`)。

実行ボタン

ボタン	説明
Execute	指定した Group へ収集アバターを追加します。実行前に確認ダイアログが出ます。
Auto-split Execute	収集アバターを指定件数ごとに分割し、複数のグループファイルを新規作成します。実行前に確認ダイアログが出ます。

使い方

既存グループへ追加する (Execute)

Hierarchy でアップロードしたいアバターを複数選択します。
Avatar Upload Setting Group に追加先のグループアセットを指定します。
Set Target Avatars を押して選択アバターを収集します。
Platform Settings で各プラットフォームの設定を整えます。
Execute を押し、確認ダイアログで OK を選びます。
追加件数とスキップ件数が Console に表示されます。

グループファイルを自動分割生成する (Auto-split Execute)

アバターを選択し Set Target Avatars で収集します。
Avatars per Group と Group File Base Name を設定します。
Auto-split Execute を押し、確認ダイアログで OK を選びます。
保存先フォルダを選択します (プロジェクト内の Assets 配下を指定)。
指定件数ごとに分割されたグループファイルが生成され、最初のグループが選択・Ping されます。

注意事項

二重登録の防止: Execute では、追加先グループに同一アバターを指す設定が既にある場合、その分はスキップされます。スキップが発生した場合は「追加 N 件 / 登録済みスキップ M 件」のダイアログが表示されます。
Undo: Execute での追加は Undo.RecordObject によりグループへの登録操作を Undo できます。ただし AssetDatabase.SaveAssets で保存済みのため、サブアセットが残る場合があります。Auto-split で作成したアセットファイルは Undo 対象外です (手動で削除してください)。
Auto-split の保存先: プロジェクト外のフォルダを選ぶと「Assets 配下を選択してください」と警告が出て中断します。必ずプロジェクト内のフォルダを指定してください。
Auto-split 側は二重登録チェックを行わず、収集したアバターをそのまま分割生成します。