Metamo(メタモ)説明書
Metamo(メタモ)は、パーティクルを使った変身・お着替えエフェクト(登場・退場と衣装チェンジ)を、VRChat アバターに簡単に入れられるシステムです。細かい仕様と制限は、パッケージ直下の README.md にあります。
1. 導入
VCC で VRChat SDK Avatars・lilToon・NDMF・Modular Avatar を入れてから、本パッケージをインポートします。Runtime/Prefabs/Metamo.prefab をアバターのルート直下にドラッグすれば導入は完了です。ビルド時に NDMF が自動で設定します(元のマテリアル・アニメーターは変更しません)。
衣装チェンジを使うときは、続けて次の 3 つを行います。
- 着替え先の衣装を、先にアバターへ着せておきます。Modular Avatar に対応した衣装は、衣装の Prefab をアバターの下に置くだけです。対応していない衣装は、アバターの下に置いてから、右クリックの
Modular Avatar > Setup Outfitで着せます。 - アバターに置いた
Metamoのオブジェクトを選び、Add ComponentからKuyuri > Metamo Outfitsを足します。 - 「衣装セット」(
Sets)に、セットの名前と、そのセットで表示するオブジェクトを登録します。先頭のセットが、アップロードしたときの状態です。体・顔・髪のように、どの衣装でも出したままのものは登録しません。
すでに Modular Avatar で衣装の切り替えメニューを作ってある場合は、3 の代わりに「MA のメニューから取り込む」が使えます(「4. 設定項目」)。
2. メニューの使い方(登場/退場・強度・衣装)
Metamo の項目は Ex メニューのいちばん上に 1 つだけ出ます(項目が 2 つ以上なら「メタモ」サブメニューにまとまり、1 つならその項目が直接出ます)。「登場・退場」トグルを ON にすると足元から現れ、OFF にすると頭から消えます。「強度」ラジアル(既定は使わない)で境界の発光・頂点の揺れ・パーティクルの強さを変えられます。「パーティクル OFF」と「ジェスチャー」は、Installer で使うようにしたときだけ出ます。 衣装チェンジを設定した場合は「衣装」サブメニューにセットが並びます。選ぶと、境界で入れ替わる(既定)か、いったん消えてから新しい衣装で現れます。消えている間に選ぶと演出なしで切り替わり、次の登場で新しい衣装が出ます。
3. 境界のパーティクルは 2 種類
境界(消える部分と残る部分の境目)から出るパーティクルは、仕組みの違う 2 種類を重ねています。どちらも既定で ON で、別々に OFF にできます。
- ジオメトリパーティクル: ジオメトリシェーダーを使い、メッシュの面から直接出すパーティクルです。Unity の Particle System は使いません。境界が通った面そのものから出るので体の形に沿い、パフォーマンスランクは変わりません(境界の向きを横や斜めにしたときだけ、向きを合わせるための Constraint が 1 つ増えます)。
- パーティクル(Particle System): Unity 標準の Particle System で出すパーティクルです。境界の高さに合わせて動く楕円体の中から出て、空中を漂います。アバターに Particle System が 1 つ増え、既定の最大パーティクル数(2500)ではパフォーマンスランクが Poor 以下になります(下げ方は「6. よくある質問」)。
4. 設定項目
Metamo Installer: メニュー(登場・退場を使うか〔既定 ON〕・強度を使うか〔既定 OFF・使わないときは強度の値で固定〕・各項目とまとめるサブメニューの名前。使わない項目はパラメータも作らない)/登場・退場の秒数/境界の進む向き(Vector3・アバターの向きに付いていく・既定 上。横や斜めにすると演出の対象のメッシュの Root Bone を付け替える。顔の SDF 影のメッシュなどは付け替えない)/退場の向き/掃引範囲の自動設定(OFF なら Sweep Start・Sweep End を手で入れる。単位は Hips からのアバター相対 m)/境界の色。 Metamo Outfits(衣装チェンジ): サブメニュー名/衣装セット(Sets。名前と表示する GameObject。先頭がアップロード時の状態。最大 8・推奨 2〜4)/切替方式(Mode。境界で = At Boundary・消えてから = While Gone)/境界モードの秒数/境界の向き/選択を保存(Save Selection)。登録したオブジェクトは、他のトグル(アバターに最初から付いている部位ごとのトグルを含む)で表示を切り替えないでください。衣装セットの表示が優先され、そのトグルは登録したオブジェクトに効かなくなります(ビルド時に警告が出ます。くわしくは README.md の「衣装チェンジの制限」)。セットごとに、着ている間の値(シェイプキー・マテリアルの float)と切り替える秒数・切り替え中の値を登録できます(マテリアルの差し替えは連動しません)。 Metamo Outfits(MA のメニューから取り込む): すでに Modular Avatar で衣装の切り替えメニューを作ってある場合は、Inspector のいちばん下の「MA のメニューから取り込む」を押すと、登録し直さずに衣装セットへ取り込めます。対象は、同じパラメータ名を持つトグルの Menu Item が 2 つ以上あり、それぞれに Object Toggle が付いている組です(値は自動でも手入力でもかまいません)。1 項目が 1 セットになり、既定の項目(Is Default)が先頭に入ります。既定の項目が無いときは、どの項目も選んでいないときに見えているものが「既定」という名前で先頭に入ります。同じ項目に Shape Changer があれば、「値を設定」の指定もセットの値として取り込みます。組が複数あるときは一覧から選びます。取り込むと今の衣装セットは置き換わります(Undo で戻せます)。元の MA の設定は書き換えず、ビルドのときだけ Metamo の「衣装」メニューに置き換えます。取り込み元は Inspector に表示され、「関連付けを外す」を押すと、衣装セットを残したままビルド時の置き換えをやめられます。上着や帽子のような、1 つずつ独立したトグルは対象外です。くわしい条件は README.md にあります。 Metamo Installer(境界のジオメトリパーティクル): ON/OFF(Use Geometry Particles)/テクスチャ/密度・大きさ・飛ぶ距離・上がる距離・寿命の長さ/ジオメトリパーティクルの描き方(加算・既定/不透明ディザー)/Geometry Particle Raise Queue(加算のときだけ有効・既定 ON。詳しくは「6. よくある質問」)。 Metamo Installer(境界のパーティクル〔Particle System〕): ON/OFF(Use Particle System)/雛形(Particle System Template。寿命・大きさ・初速・動きは雛形の Particle System で決めます。空なら同梱の既定)/放出数(Particle System Rate・既定 2000/秒)・最大同時数(Particle System Max・既定 2500)/楕円体の厚さ・横の余白・進行方向のずれ・殻の厚さ/楕円体の幅を測るメッシュ(Particle System Renderer・任意)。 Metamo Installer(メニューからパーティクルを切る): Use Particle Off Menu(既定 OFF)を ON にすると、Ex メニューに「パーティクル OFF」が出て、VRChat の中でパーティクルを止められます(同期 1 bit)。 Metamo Installer(ハンドジェスチャー): Use Gesture Trigger(既定 OFF)/左手・右手の形(既定は両手ともロックンロール)/起こすこと(次の衣装へ・登場・退場の切り替え)/メニューの名前。両手がその形になった瞬間に 1 回だけ変身します。Ex メニューの「ジェスチャー」で止められます。同期するパラメータは増えません。 Metamo Installer(対象の確認): 「対象を調べる」を押すと、演出に乗るマテリアルと、消えている間だけ隠すものが一覧で出ます。マテリアルが入っていないスロット(Missing・None)も別に出ます。そのスロットは演出に乗らず、消えている間も隠れないので、先にマテリアルを入れてください。 派生マテリアル(lilToon のインスペクタ「Metamo › Dissolve」): 方向プリセット、Sweep、Noise、Edge(グラデーションまたは 2 色。ジオメトリパーティクルが色を拾う範囲 Geometry Particle Gradient Width もここ)、Vertex Scatter、Mask。ジオメトリパーティクルの密度や大きさは Installer がビルド時に書くので、ここには出ません。
5. 色やデザインを変える
アバターに置いた Metamo の Inspector で操作します。
Lookの下の 「既定のデザインを複製して編集」 を押します。Assets/Metamo_User/に Look が作られ、欄に自動で入ります。同名のファイルは上書きせず連番になります。- 「色・幅・ノイズを編集」 を開きます。
Edge Use Gradientが ON なら Edge Gradient で色を変えます。左端は境界、右端は帯の外側、アルファは光の強さです。Edge Gradient Width は体の帯の幅、Geometry Particle Gradient Width はジオメトリパーティクルが色を拾う範囲です。 - 2 色で調整するなら
Edge Use Gradientを OFF にし、Edge Glow Color(内側)と Edge Remains Color(外側)を変えます。それぞれの Width は幅です。Noise Scale / Strength / Speed はノイズの細かさ/揺れ幅/速さ、Vertex Scatter は頂点の散らばりとその帯の幅です。
ジオメトリパーティクルとパーティクル(Particle System)の色は、どちらも境界の色から決まります。 Installer の Override Edge Colors が ON なら、Look の色より Edge Color 1 / 2 が優先されます。Look の色を使う場合は OFF にしてください。同じ Look を使う Installer にも変更が反映され、実際の演出にはビルド時に適用されます。
ジオメトリパーティクルの画像を変えるには、「ジオメトリパーティクルのテクスチャ」 に自分のテクスチャを入れます。空なら元マテリアルの設定、元にもなければ同梱の画像を使います。
パーティクル(Particle System)の動き・画像を変える場合は、Particle System Template の下の 「既定のパーティクルを複製して編集」 を押します。Prefab とマテリアルが Assets/Metamo_User/ に複製され、欄に入ります。Project でこの Prefab を開き、Particle System の Start Lifetime(寿命)・Start Size(大きさ)・Start Speed(初速)・Noise を編集してください。画像は Renderer の Material を開いて Texture で変更します。Soft Disc = 0 で画像の形をそのまま使います。画像ファイル自体は複製しないので、画像を加工する場合は自分用の画像を Assets に保存して指定してください。
放出数・最大数は Installer の Particle System Rate/Particle System Max で変えます。色・発生形状・放出数・最大数・Trigger/Sub Emitters はビルド側で設定するため、雛形で変えても採用されません。Particle System は 1 つです。別シェーダーの材質・テクスチャも引き継ぎますが、境界色の自動反映には、Metamo の Custom1 HDR 色の読み取りへの対応が必要です。
パッケージに同梱された資産を直接書き換えないでください。版の入れ替えでフォルダーを削除する際、一緒に消えます。 欄にパッケージ内の Look/パーティクルの雛形を指定している場合は「このデザイン/このパーティクルを複製して編集」を使います。Undo で欄への割り当てを戻せます(複製したファイルは残ります)。何も複製せず使う場合は既定のデザインのままです。
6. よくある質問(対応シェーダー・パフォーマンスランク・Quest)
- 対応は lilToon の Opaque/Cutout/Transparent(OnePass/TwoPass 含む)とその Outline 付き、Fur/FurOnly、Gem、Refraction です。それ以外は消えている間だけ非表示になります。
- パフォーマンスランク: パーティクル(Particle System・既定 ON)を使うと、既定のままでは PC のランクは Poor 以下になります。増えるのは Particle System +1・最大パーティクル数 2500(既定)・Constraint +1 です(Physics Collider は増えません)。最大パーティクル数の合計の上限は Good 300・Medium 1000・Poor 2500 で、アバターが元から Particle System を持っていると合計が 2500 を超えて Very Poor になります。ランクを保ちたいときは Installer の
Particle System Max(最大同時数)を下げ、それに合わせてParticle System Rate(放出数)も下げてください(例: 最大 300・放出 300/秒 で Good の範囲)。Use Particle Systemを OFF にすればランクは変わりません(ジオメトリパーティクルだけならランク不変です)。Expression Parameters は既定で 1 bit(KY_Fx)で、強度のラジアルを使うと +8 bit、衣装チェンジを使うと +8 bit(全部使うと 17 bit)です。「パーティクル OFF」をメニューに出すと +1 bit です。 - ジオメトリパーティクルの描き方と描画順: 既定は「加算」+
Geometry Particle Raise QueueON です。光を重ねて明るくし、ジオメトリパーティクルが壁・床・空に隠れないよう、演出中だけアバターの描画順(Render Queue)を 2501 に上げます。その数秒間は、髪などがワールドの半透明な物と重なったときに前後が狂ったり、カメラの深度テクスチャ(奥行きの情報)から外れて、被写界深度・SSAO などが素通ししたりします。気になる場合は Installer で次のどちらかを選んでください。- (a)
Geometry Particle Raise Queueを OFF: 元の描画順に戻ります。ただし、ジオメトリパーティクルは自分の体の上にしか見えなくなります。 - (b)「ジオメトリパーティクルの描き方」を「不透明(ディザー)」に変更: 元の描画順のまま、ジオメトリパーティクルの奥行きを書くことで壁・床・空に上書きされるのを防ぎます。薄さは細かい点描になります。HDR の色は保つのでワールドのブルームに反応しますが、加算のような重なりの明るさは出ません。このモードでは
Geometry Particle Raise Queueは効きません。 - 元から半透明のマテリアルを不透明に変える設定ではありません。パーティクル(Particle System)の描き方も変わりません。
- (a)
- 別のアバターへの切替(アバター ID の変更)は VRChat の仕様上アバター側からはできません。衣装チェンジは 1 体の中のセット切替です。
- 衣装セットに登録したら、アバターに付いていた部位のトグル(「コート OFF」など)が効かなくなった: 衣装セットの表示が優先されるためです(ビルド時に警告が出ます。衣装チェンジは動きます)。そのトグルも使いたいときは、トグルをレンダラーの有効・無効(
m_Enabled)で書き直すか、セットには親のオブジェクトを登録して、トグルはその子を動かすようにしてください。くわしくはREADME.mdの「衣装チェンジの制限」。 - Write Defaults: ビルド時にアバターに合わせて自動で決めます(記述子の FX と Modular Avatar の Merge Animator に WD ON があれば WD ON)。これで、WD ON のアバターに入れても表情などの既定値の書き戻しを止めません。Metamo より後に FX を足す他の NDMF プラグインは判定に入らず、ビルド後に Write Defaults を書き換えるツール(VRCFury の自動修正など)との併用は保証しません。衣装セットに登録したオブジェクトを他のトグルで動かすと、Metamo が優先されます。
- Modular Avatar の Material Setter: 演出の対象のマテリアルに当てると、演出中もそのマテリアルが優先され、そのスロットだけ溶けない・消えないことがあります(ビルド時に警告が出ます)。マテリアルの切り替えは、アバターの FX のレイヤーで行ってください。
- Avatar Optimizer(AAO): 併用できます。Merge Skinned Mesh で髪や服をまとめていても、AAO の処理の後にまとめたメッシュの実際の原点で境界の高さを合わせ直すので、設定は要りません(原点が Hips の部品と Hips でない部品を 1 つにまとめると AAO が警告を出すことがありますが、境界は揃います)。
- Quest(Android)には対応しません(VRChat の仕様で、Quest 版のアバターは VRChat/Mobile 系のシェーダーしか使えないため)。Quest のユーザーからは演出も衣装チェンジも見えず、その人には Quest 版の姿が表示されます。PC 版と同じ Blueprint ID で Quest 版を上げるときは、Quest 版に
Metamo_QuestParametersプレハブを置いてください(Sourceに PC 版の Metamo を入れると、パラメータを PC 版と同じに揃えます。パラメータだけを作ります)。
7. 更新履歴
CHANGELOG.md を参照。