VRChat/Unity制作のためのエージェントスキルカタログ ― シェーダーからワールドSDKまで
VRChatのアバター改変やワールド制作をコーディングエージェントに手伝わせると、汎用のUnity知識だけでは足りない場面が多い。シェーダーのプロパティ名、FXコントローラーでのアニメーションのバインディング規則、Udonの同期まわりの作法など、ドメイン固有の決まり事が大量にあるからだ。
そこで、自分のスキル置き場(複数のAIエージェントで共有している agent-cortex)には、VRChat/Unity系のスキルをまとめて入れてある。今回はそのうち12本を、用途別にカタログとして紹介する。いずれも「どういう知識とルールを外付けしているか」の紹介で、各ツールの解説そのものではない点はご容赦を。
アバターのマテリアルとシェーダー
liltoon
VRChatアバターの定番トゥーンシェーダー lilToon を扱うためのスキル。プロパティ名の一覧(_Color、_EmissionColor、_UseEmission、影色、MatCap、リムライト、アウトライン、ディゾルブ、AudioLinkまわり)と、Opaque/Cutout/Transparent/TwoPassといったレンダリングモードの整理が中心になる。実務で効くのはFXコントローラー側のバインディング規則で、Floatやトグルは material._UseEmission のようなパスで書き、色はRGBAチャンネル別に分ける、といった表記法を明文化している。マテリアルをプログラムから生成・変換するためのC#ヘルパーのテンプレートも同梱されている。
poiyomi
Poiyomi Toon/Pro向けのスキル。ライティング、影、エミッション、MatCap、リム、溶解などのモジュラーなサブシステム構成とプロパティ名が整理されている。核になるのはThry Editorのマテリアルロック(最適化)の扱いで、「ロックしたマテリアルでアニメーションさせたいプロパティは、事前にAnimatedとして指定しておかないと定数に焼き込まれて動かなくなる」という落とし穴がはっきり書かれている。ギミックで発光や溶解をアニメーションさせる前に必ず確認する類の知識だ。
アバター改変の仕組み
modular-avatar
NDMF(Non-Destructive Modular Framework)ベースの非破壊改変ツール、Modular Avatarのスキル。MergeAnimator、Parameters、MenuItem/MenuInstaller、BlendshapeSync、MergeArmature/BoneProxyといったコンポーネントの役割と設定項目を押さえている。代表的なルールは「MenuItemだけ付けてもダメで、MenuInstallerが併せて必要」というもので、メニューが反映されない系の事故を未然に防ぐ。エディタ拡張を書くときの作法(UndoとSetDirtyを必ず使う)まで含めてあるので、自作ギミックの開発支援に向く。
ワールド制作
unity-vrc-world-sdk-3
ワールド側のシーン構築を担当するスキルで、スクリプトではなくシーン設定・コンポーネント配置・最適化・アップロードが守備範囲。VRC_SceneDescriptorやスポーン地点の設定、レイヤーとコリジョンマトリクス、Quest/Android向けのパフォーマンス予算、ベイクドライティング、Build Panelに出る警告(赤・黄・白)の切り分けまでをカバーする。次のUdonSharpスキルとは「シーンはこっち、コードはあっち」と役割分担が明示されているのが特徴。
unity-vrc-udon-sharp
UdonSharp(VRChat SDK 3.10.4を対象として検証)のスクリプティングスキル。このスキルの前提は「UdonSharpは通常のC#に見えて、使えない機能がエラーではなく静かに失敗する」という点にある。List<T> やLINQなどがコンパイルできなかったり、所有権なしに同期変数を書き換えても何も起きなかったりする。そのため、同期モードを選ぶ前に「誰が状態を持つのか」「所有権はいつ移るのか」「後から入った人に何が見えるのか」「所有者が抜けたらどうするのか」という設計判断を先に固める手順が核になっている。ネットワークコードを書く・レビューするときの必読事項集だ。
モバイル/Quest向けのシェーダー最適化
mobile-shader-optimization
モバイルGPUのタイルベースレンダリングを前提に、シェーダーのハードルールを集めたスキル。half 精度をデフォルトにすること、discard(アルファテスト)が早期深度判定を壊すので避けること、テクスチャサンプル数や分岐・ループの制限、スカラーとベクトルの演算順序まで細かく決まっている。Mali/Adreno/PowerVR/AppleといったGPUファミリーごとの注意点や、帯域こそがボトルネックだという考え方が土台にある。Quest向けワールドやモバイル対応のシェーダーを書くときに効く。
mobile-post-processing
モバイル向けポストプロセスのスキル。ポストプロセスはパスごとに画面全体の読み書きが発生し、タイル型GPUでは特に高くつく。そこで、ビネットとカラーグレーディングなどを単一パスにまとめる方針と、そのまま使えるシェーダーテンプレートが用意されている。Bloomは最も高コストな部類であること、Motion BlurとDepth of Fieldはモバイルでは使わないという線引き、URPのRenderer Featureとして実装する手順も含む。
texture-packing-variant-stripping
テクスチャのチャンネルパッキングと、シェーダーバリアント削減の2本柱のスキル。前者はMask Map(R=Metallic、G=AO、A=Smoothnessなど)のように複数のグレースケールマップを1枚のRGBAに詰める手法で、サンプル数とメモリ帯域を同時に減らす。後者は multi_compile の組み合わせ爆発への対策で、shader_feature との使い分けや、不要なキーワードをビルド時に剥がす方法を扱う。ビルドサイズとシェーダーのコンパイル時間に悩んだときのスキルだ。
シェーダーを書く
urp-hlsl-templates
URPでHLSL/ShaderLabを直接書くときのテンプレート集。SRP Batcher互換のためにプロパティを UnityPerMaterial のCBUFFERに置くこと、URP用のincludeと変換マクロを使うことなど、「URPの作法」をルールとして固定し、UnlitとLitの実用テンプレート、Built-inパイプラインからの変換チートシートを持つ。コードでシェーダーを書く作業の出発点として使う。
shader-graph-best-practices
Shader Graph向けのベストプラクティス。モバイルではノード数を100以下に抑えること、グラフ全体の精度をHalfにすること、Sub Graphは整理のためのもので命令数を減らすわけではないこと、複雑な処理はCustom FunctionノードのHLSLに逃がすこと、といった指針が並ぶ。カスタムライティング用のサブグラフ(Cyaniluxのもの)の導入と使い方も扱っている。
water-fluid-shaders
水や液体のシェーダーをURPで作るためのスキルで、モバイル最適化が前提。深度による色付け、波打ち際のフォーム、Gerstner波による頂点変位、屈折、コースティクスといった要素を、テクスチャサンプルは4つまで、波の計算は頂点シェーダーで、といった制約と一緒に整理している。機能ごとのコストをTier分けしてあるので、対象デバイスに合わせて引き算しながら組める。最小構成のテンプレート付き。
テキスト
optimize-text-mesh-pro
TextMeshProの最適化スキル。フォントスタックの設計(本体は静的フォントアセット、不足分は動的フォールバックで補う)、動的アトラスのサイズ上限、Paddingとサンプリングポイントサイズの比率をフォント間で揃えること、SDF16の使いどころ、AutoSizeはレイアウト確定後に切ることなど。CJKフォントのサンプリングサイズの目安も含まれる。冒頭に症状別のトリアージ表があり、「メモリ膨張か、品質か、CPUか、ローカライズか」から原因の切り分けに入れる構成になっているのが実務的だ。
おわりに
12本を通して見ると、役割は大きく「ドメイン知識の辞書」(liltoon、poiyomi、World SDK)、「失敗パターンの先回り」(UdonSharp、Modular Avatar)、「制約の明文化」(モバイル最適化系)に分かれる。エージェントの生成物が安定するかどうかは、結局のところこの3種類をどれだけ具体的に渡せるかにかかっている、というのが運用してみての実感だ。