衣装変身バンク

Transformation Bank は旧衣装と新衣装を1本のAnimation Controller進行度でつなぐShader Core モジュールです。PC向けを対象とし、SabaShader/Illust2D とNonToonで検証しています。

シェーダーだけで衣装GameObjectを有効・無効にはできません。変身中は旧衣装と新衣装のRendererを 有効に保ち、モジュールの Progress で各meshの描画範囲を制御します。旧衣装を無効にするのは バンク完了後です。

最短手順

1. 衣装MaterialのInspectorで Select Modules を開き、__TransformationBank を有効にして Apply します。
2. Tools > SabaShader > Transformation Bank Clip Generator を開き、Avatar Rootと衣装A／Bを指定します。
3. Material互換性エラーが出た場合は、対応Shaderから互換Materialを生成するか、既存対応Materialを割り当てます。
4. Style、遷移時間、Effect Intensityを決め、双方向Animation Clipを生成します。
5. 生成ClipをAvatarのFX Animatorへ組み込み、必要なStyleだけParticleを別途同期します。

Clip Generatorが自動化するのは手順2～4です。FX Animator、Parameter、Particle Systemの組み込みは、Avatarごとの 既存構成や衣装切替方式が異なるため手順5の別工程としています。

構成

衣装に使うマテリアルInspectorで Select Modules を開き、 __TransformationBank (io.github.sabas0ba.transformationbank) を有効にして Apply を押します。 既存の Appearance Transition と同じマテリアルでは併用しません。双方がclipと頂点変位を行うためです。

このモジュールはbodyの被覆を保証しません。衣装下のbodyをBlendShapeなどで隠す場合は、変身中に 旧衣装と新衣装が必要とする隠し範囲の和集合を維持してください。

ProgressとRole

Animation Clipから両Rendererの次のmaterial propertyを0から1へ動かします。

material._io_github_sabas0ba_transformationbank_Progress

既定timingは次の通りです。数値は Costume Windows で変更できます。

共通Effect envelopeはProgress中央で最大になり、0と1で値と勾配が0になるbell curveです。Animation Clipを linear keyframeにした場合も、変身開始直後と完了直前の発光・変位が急に確定しないよう収束します。 各Styleのnoise・turbulence・頂点変位にもRole別の表示率から求めたbell curveを適用し、Costume Windows の 開始・終了値をまたいだときに完全表示判定へ不連続に切り替わらないようにしています。

既定値ではOutgoingとIncomingの表示率の和が1を下回りません。これはbody被覆率ではなくshader上の 表示率です。windowを変更する場合は Incoming開始 <= Outgoing開始 <= Incoming終了 <= Outgoing終了 の順序を維持します。

IncomingとOutgoingは相補的な表示閾値を使用します。Gaia・FlameなどでIncomingが下から上へ出現する場合、 Outgoingも下から上へ消失します。Umbra・Cyberなどのnoise／block型では、Incomingが現れる領域から Outgoingが消えるため、両Roleが同じ領域へ重なって別領域が空白になる状態を抑制します。

変身中に別の衣装変更を受け付けると現在衣装の判定が不定になるため、FX Animatorはバンク終了まで 次の入力を受け付けない構成を推奨します。

Animation Clip Generator

Unity Editorの Tools > SabaShader > Transformation Bank Clip Generator から、衣装A、衣装B、VFX Styleを 指定して双方向のAnimation Clipを生成できます。Avatar RootはAnimation bindingの相対パスを計算するために 使用します。

入力パラメータ

衣装A／Bは遷移中に同時表示されます。AとBへ同じGameObjectを指定したり、同じAnimation binding pathを持つ Rendererを含めたりすると、1本のClipから安全に制御できないため生成を拒否します。

Material互換性の修復

生成前に、両衣装の SkinnedMeshRenderer と MeshRenderer が使用する全MaterialでTransformation Bankが 有効になっていることを確認します。対応していないMaterial SlotやAvatar Root外の衣装がある場合は、生成せず 対象のRendererとSlotを表示します。

Material互換性 には、選択した衣装で対応していないRenderer、Slot、不足Propertyと、現在Projectで利用可能な Transformation Bank対応Shader／Materialが表示されます。対応Shaderがない場合は Tools > SabaShader > Select Modules で __TransformationBank を有効にし、ApplyとShaderコンパイルの完了後に再スキャンします。

各Slotは次のいずれかで修復できます。

• 互換Materialを生成して割当: 現Materialの互換Propertyを引き継いだ新規Materialアセットを PreparedMaterials に生成し、選択した対応Shaderへ切り替えてSlotへ割り当てます。
• 選択Materialを割当: Project内の既存対応MaterialをSlotへ割り当てます。

どちらも元MaterialアセットのShaderやPropertyを変更しません。明示的な割当操作だけがSceneまたはPrefab instanceの Renderer Slotを変更し、UnityのUndoに対応します。Material配列が空のRendererにはSlot 0を追加します。

互換Materialを生成して割当 は、現Materialに同名Propertyがあれば値とTextureを新Materialへ引き継ぎ、選択した 対応Shaderへ切り替えます。新Materialは通常表示を維持できるよう Role = Incoming、Progress = 1 で初期化します。 異なるShader間ではProperty名や描画方式が一致しない場合があるため、割当後にBase Texture、Cull、Render Queue、 透過設定を確認してください。

生成物と変更範囲

生成物は次の通りです。

• 衣装Aから衣装B、衣装Bから衣装Aへの2本のAnimation Clip
• 元Materialを複製したIncoming／Outgoing Material
• 入力条件と生成Assetを記録する TransformationBankGenerationReport.asset

<出力先>/<衣装A>_<衣装B>_<Style>/
├─ Clips/
│  ├─ <衣装A>_To_<衣装B>_<Style>.anim
│  └─ <衣装B>_To_<衣装A>_<Style>.anim
├─ Materials/
│  └─ 各元MaterialのIncoming／Outgoing複製
└─ TransformationBankGenerationReport.asset

<出力先>/PreparedMaterials/
└─ Material互換性セクションで生成した修復Material

Clip生成自体は元Material、Scene上のRenderer、GameObjectの有効状態を変更しません。Animation Clip内のMaterial reference curveで 複製Materialへ切り替え、両衣装を遷移中に有効化します。Outgoing衣装はProgressが1になり完全に非表示となる 最終frameで無効化されるため、衣装間に空白frameを作りません。既存Folderを上書きせず、再生成時は一意なFolderへ 出力します。

Clip GeneratorはAnimation Clip生成までを対象とします。Animator Controller、FX Layer、Parameter、Particle Systemの Avatarへの組み込みは別工程です。

Material Inspectorパラメータ

進行と表示区間

Progress はAnimation Controllerから動かす主制御値です。Costume Windows はその0～1内のどこで衣装を 出し始め、消し終えるかを決めます。遷移を長く見せたい場合はClipの遷移時間を伸ばし、衣装同士の重なりだけを 増やしたい場合はIncoming開始を早めるかOutgoing終了を遅らせます。

境界、変位、表面pattern

Effect Intensity を上げる場合はSkinnedMeshRendererのboundsも広げ、カメラ角度によるcullingを 確認してください。

目的別の調整例

Style選択ガイド

Shatterはgeometry shaderでtriangleを分離する方式ではなく、object-space cellとTriangle／Quadの mesh particleを組み合わせます。そのためNonToonと同じShader Core経路を維持できます。Meltは Outgoingを横方向へ波打たせながら下へ垂らし、液滴と水玉が落ちる区間で消去します。Incomingには 同じ液体境界・表面pattern・頂点変位を時間反転して適用し、下方の液体片から新衣装へ復元します。

Particle System

Package ManagerのSamplesから Transformation Bank Demo をImportすると、12 Styleの表面shaderと Particle Systemを同期再生できます。

DemoのParticleは2系統です。

• Primary: 炎片、破片、pixel、液滴、裂け目、霧など主要形状
• Accent: 火の粉、細かな破片、星、sparkleなど装飾

各Particleは汎用Quadではなく、Styleごとの手続き生成meshを使用します。Flameは小さな火の粉、Umbraは 霧粒、ShatterはTriangleとQuad片、Glitchは横長pixel片、Meltは液滴と水玉を使います。AstralとGaiaは 表面shaderだけで構成し、Particleを停止します。UmbraとMana Mistはsoft radial textureとalpha blendを 使用し、輪郭のある破片ではなく半透明の霧として合成します。 PrimaryとAccentのEmissionはStyleごとに異なるProgress区間へ同期し、変身前後の端点では停止・消去します。 生成済み形状は TransformationBankParticleMeshes.asset に永続化されているため、Sample Controllerを外しても Particle SystemのMesh参照は維持されます。

Inspectorの Particle Intensity と Particle Size で調整できます。実AvatarではAnimation Clipから Particle SystemのEmissionまたはGameObject有効状態を制御します。Particleは衣装の描画状態を置き換える ものではなく、表面shaderの外側へ演出を追加する用途です。

よくある問題

NonToon

NonToonはShader Coreの morph、base、postpixel phaseを持つため、同じモジュールを追加できます。 Forward、ForwardAdd、Outline、ShadowCasterで同じ表示判定を使用します。本リポジトリではNonToon 0.1.3（130bea3e6be5183b4fceb60df0062d38ef98067c）を固定依存としてコンパイルしています。