Candy Box

アバター改変向けの小さなエディタ拡張の詰め合わせです。 使うツールだけを有効にして利用できます。

詳しい使い方はドキュメントサイトをご覧ください。

動作環境

• Unity 2022.3
• エディタ専用
• 基本機能、04_Hair Tone Matcher、05_Bone Weight Collapser、06_BlendShape Backuper に追加の依存パッケージは不要です。04_Hair Tone Matcher の対応シェーダーは lilToon と Poiyomi ですが、パッケージへの導入は必須ではありません。01_Helper for MA Blendshape Sync を使う場合は Modular Avatar 1.17.0 以降が必要です。02_Helper for AAO Merge PhysBone と 03_Helper for AAO Merge Bone を使う場合は AAO: Avatar Optimizer 1.9.0 以降が必要です。

使い方

Unity の Tools > Candy Box から設定ウィンドウを開き、使うツールを有効にします。 ツールは既定ですべて無効です。 各ツールの「開く」と、設定変更を確定または取り消す「適用 / 破棄」は別の行にあります。 切り替えは「適用」を押すまで反映されません。適用するとスクリプトが再コンパイルされます。

収録ツール

00_Blendshape Keeper

表情アニメーションを再生したときに、改変したブレンドシェイプが元へ戻るのを防ぎます。

1. シーン上の対象メッシュ（顔メッシュなど）を指定します。アバタールートは自動で判定されます。
2. 対象アニメーションを指定します。フォルダをドロップするとまとめて追加できます。
3. 「差分を確認」で変更内容を確認します。
4. 必要に応じて「変更をプレビュー」で、修正前と修正後のアニメーションを再生して比較します。
5. 反映する項目を選び、「適用」を押します。

アニメーションのキー値がメッシュの現在値より小さい場合に限り、キー値を現在値まで引き上げます。 キー値のほうが大きい場合は変更せず、クリップに存在しないブレンドシェイプのカーブも追加しません。 指定していないメッシュのブレンドシェイプは対象外です。

出力は、元のアニメーションを上書きする方法と、別のアニメーションとして保存する方法から選べます。 「別のアニメーションとして保存」では Assets/ または Packages/ 配下の指定フォルダに複製を作り、元のクリップは変更しません。 出力フォルダは選択ボタンのほか、Project ウィンドウからフォルダをドラッグ＆ドロップして指定できます。 「変更が無いアニメーションも複製する」を有効にすると、「差分を確認」の一覧にあるクリップは、反映項目をすべて解除していても出力できます。 同名のファイルがある場合は連番付きの別名で保存し、既存ファイルを上書きしません。 「変更をプレビュー」では、修正前と修正後のアニメーションをそれぞれ再生し、ブレンドシェイプやボーンの動きを比較できます。 プレビューは「顔」と「全身」を切り替えられ、それぞれの表示に合わせて視点をリセットできます。

再生中と Animation ウィンドウのプレビュー中は実行できません。 適用した変更は「元に戻す（Undo）」で取り消せますが、重要なプロジェクトでは事前のバックアップを推奨します。

01_Helper for MA Blendshape Sync

Modular Avatar 1.17.0 以降の MA Blendshape Sync を使い、衣装のシェイプキーを素体へ追従させる設定をまとめて作ります。

1. アバター配下の素体メッシュを指定します。顔や体など、複数のメッシュを指定できます。
2. 同じアバター配下の衣装ルートを指定します。
3. 「対応を確認」で自動検出された対応を確認し、必要な項目を選びます。
4. 「適用」で MA Blendshape Sync の設定を書き込みます。

素体と同じ名前のシェイプキーは自動で対応付けられます。 対応が見つからなかった素体側の項目は、「素体のシェイプキーを追加」から選んで一覧へ追加できます。 名前が異なる場合は衣装側の名前を選ぶと、その名前を持つ衣装メッシュへまとめて紐付けられます。 対応一覧とシェイプキーの選択欄は、名前を入力して絞り込めます。 一覧では素体のシェイプキー値をその場で変更して、衣装との対応を確認できます。 設定の適用と素体値の変更はいずれも「元に戻す（Undo）」で取り消せます。 素体メッシュと衣装ルートは、同じアバターの配下に置いてください。

02_Helper for AAO Merge PhysBone

AAO: Avatar Optimizer 1.9.0 以降の AAO Merge PhysBone を対象に、統合する PhysBone の値を比較して override 値を提案します。

1. AAO Merge PhysBone が付いたオブジェクトを 1 つ指定します。
2. 「差分を確認」で統合対象それぞれの現在値を比較します。
3. 差異のある項目ごとに、提案に使う指標を選びます。
4. 内容を確認し、必要な項目を「適用」で override として書き込みます。

統合対象はアバタールートからの相対パスとチェーンの長さ付きで一覧表示されます。 数値の提案には最小・最大・平均・中央・最頻を選べます。有効・無効や種類のように大小関係のない項目では最頻のみとなります。 提案値は適用前に手で書き換えられます。

カーブを持つ項目は、値とカーブを合わせた実効値から提案を作ります。 生成されるカーブは 11 点の線形補間で、元のカーブの形状やタンジェントは再現しません。 統合対象でチェーンの長さが異なる場合、カーブの提案は目安として扱ってください。 Colliders と Endpoint Position は値の提案対象外です。

再生中は実行できません。適用した変更は「元に戻す（Undo）」で取り消せます。

03_Helper for AAO Merge Bone

AAO: Avatar Optimizer 1.9.0 以降の AAO Merge Bone を使い、ボーンを親へ統合する設定をツリーからまとめて切り替えます。

1. 対象のオブジェクトを 1 つ指定します。その配下にあるボーンが対象です。
2. 「ボーンを確認」で現在の設定と警告を確認します。
3. 親へ統合するボーンにチェックを付けます。チェックを外したボーンは統合しません。
4. 内容を確認し、「適用」で設定を反映します。

アバタールート、人型ボーン、EditorOnly のオブジェクトは統合の対象外です。 Transform 以外のコンポーネントを持つボーンや、アニメーションで動かされているボーンには一覧上で印が付きます。 アニメーションの確認は、アバターの Animator から辿れるものだけが対象です。ビルド時に追加されるアニメーションは含まれません。 ボーン名で絞り込めるほか、ボーンとその子孫をまとめてチェックできます。

「チェーンを間引く」で始点ボーンと保持間隔を指定すると、チェーン上のボーンを一定間隔で統合対象にできます。始点は必ず残ります。 間引きの結果はチェックに反映されるだけで、「適用」を押すまでシーンは変更されません。

再生中は実行できません。適用した変更は「元に戻す（Undo）」で取り消せます。

04_Hair Tone Matcher

差し替えた髪の色味を元の髪へ近づけます。必要な追加パッケージはありません。新しい髪のマテリアルは lilToon または Poiyomi に対応している必要がありますが、元の髪のマテリアルはどのシェーダーでも利用できます。

1. 元の髪のマテリアルと、新しい髪の Renderer をそれぞれ 1 つ以上指定します。どちらも複数指定でき、元の髪はマテリアル単体または Renderer のスロットから追加できます。
2. 新しい髪は GameObject（Prefab を含む）を指定して配下の Renderer をチェックで選ぶか、Renderer を直接複数追加します。
3. 「色を比べる」で、元の髪全体と新しい髪の各対象を比較します。前髪と後ろ髪でテクスチャが違う場合も、対象ごとに別々の補正値が求められます。同じマテリアルを共有する対象は 1 つにまとめて扱われます。
4. 一覧から対象を 1 つ選び、その対象の補正値と補正前・補正後の平面プレビューを確認します。
5. 書き込み方法と出力フォルダを確認し、「適用」でチェックした対象へまとめて反映します。

色の合わせ方は、指定範囲全体の統計を使う方法と、2 枚のテクスチャからそれぞれ 1 点を選んで「この色をこの色に」と指定するスポイト方式から選べます。補正方式は、色相・彩度・明度・ガンマを調整する「色調の補正」と、色の分布から曲線を作る「階調を合わせる」の 2 種類です。

書き込み先は次の 3 通りです。

• 「複製 + テクスチャ焼き込み」が既定の方法です。マテリアルとメインテクスチャをどちらも複製し、補正を新しいテクスチャの画素へ焼き込みます。元のマテリアルとテクスチャは変更されず、シェーダーがフォールバックしても色が保たれます。
• 補正をマテリアルの設定として保持したい場合は、「複製して差し替え（補正は設定として保持）」を選びます。元のマテリアルは変更されませんが、シェーダーがフォールバックすると補正は反映されません。
• 「上書き」は新しい髪のマテリアルそのものを変更します。そのマテリアルを共有している他のオブジェクトにも影響します。

複製または新しいテクスチャを作る場合は、Assets/ 配下の出力フォルダを指定します。階調をマテリアル設定として書き込む場合は階調 LUT、マスクを書き出す場合は適用範囲マスクも同じフォルダに作られます。

適用後は「反映の切り替え」で、色調補正とコピーしたマテリアル設定の反映を個別またはグループ単位で切り替えられます。色調補正とコピーした値はその場で直接編集できます。この切り替えは、ウィンドウを閉じるかスクリプトが再コンパイルされるまで有効です。 テクスチャへ焼き込んだ場合は、編集中のプレビューを確認して「この値で焼き直す」から元のテクスチャを基に作り直せます。焼き直しは「元に戻す（Undo）」では取り消せません。

髪飾りなど色を変えたくない部分は、選択したマテリアルスロットの UV、既存のマスク、追加のマスクを使って対象外にできます。同じシェーダー同士では、影・リムライト・マットキャップなど、元の髪と異なるマテリアル設定を選んでコピーできます。設定の一覧は機能グループごとに折りたため、プロパティ名や表示名で絞り込めます。

合わせられるのは色味です。メッシュの形や陰影の付き方の差は埋まりません。また、彩度と明度には上限があるため、元の髪より暗い髪を十分に明るくできない場合があります。

マテリアルがロックされている場合は、解除してから実行してください。再生中は実行できません。適用によるマテリアルと Renderer の変更は「元に戻す（Undo）」で取り消せますが、生成したファイルは残ります。

05_Bone Weight Collapser

不要なボーンのウェイトを別のボーンへ寄せ、衣装などの追従先を直します。追加の依存パッケージはありません。

1. 対象オブジェクトを指定すると、配下の SkinnedMeshRenderer が自動で一覧になります。
2. 処理するメッシュにチェックを付けます。既定ではどれも選択されていません。
3. 畳み込みルールごとに、移動元ボーンを直接並べるか、起点ボーンの子孫からまとめて指定します。
4. 移動先ボーンと移動比率を指定し、必要ならルールを追加します。
5. 「影響を確認」で頂点数と移動ウェイトを確認します。
6. 出力フォルダを指定し、「適用」を押します。

移動元・移動先・移動比率の組（ルール）は複数追加でき、1 回の適用でまとめて処理されます。 出力されるメッシュはルールの数によらず、メッシュ 1 つにつき 1 つです。 ルールは上から順に適用され、先のルールによる移動結果を後のルールが引き継ぎます。

移動比率 1.0 では移動元のウェイトを完全に移し、0.5 では半分を残します。 移動先には、そのメッシュのボーン一覧に含まれるボーンを指定してください。ボーン自体の削除は行いません。

処理後のメッシュは新しい .asset として保存され、対象のメッシュ参照だけが差し替わります。元のメッシュや FBX は変更しません。同名のファイルがある場合は連番を付け、既存のファイルを上書きしません。

再生中は実行できません。メッシュ参照の差し替えは「元に戻す（Undo）」で取り消せますが、生成したファイルは残るため、不要になったものは手動で削除してください。

06_BlendShape Backuper

SkinnedMeshRenderer のブレンドシェイプ値をキー名と対応付けて保存し、あとから復元します。メッシュの更新でキーの並びが変わっても、同じ名前のキーへ正しく戻せます。追加の依存パッケージはありません。

1. 対象メッシュを指定します。
2. 表示名と保存先を確認し、「バックアップを保存」を押します。
3. 一覧から戻したいバックアップを選び、現在値との違いを確認します。
4. 復元するキーにチェックを付け、「プレビュー」で見た目を確かめます。
5. 「復元」を押します。

既定の保存先は Assets/zzz_pytr/CandyBox/BlendShapeBackups です。フォルダが無ければ自動で作られ、サブフォルダを指定して分けることもできます。

復元した値は「元に戻す（Undo）」で取り消せますが、保存したバックアップのファイルは Undo では消えません。不要になったものは Project ウィンドウから削除してください。 再生中は保存・プレビュー・復元できません。

ライセンス

MIT License