Kuyuri ドキュメント

Metamo(メタモ)説明書

Metamo(メタモ)は、パーティクルを使った変身・お着替えエフェクト(登場・退場と衣装チェンジ)を、VRChat アバターに簡単に入れられるシステムです。細かい仕様と制限は、パッケージ直下の README.md にあります。

1. 導入

VCC で VRChat SDK Avatars・lilToon・NDMF・Modular Avatar を入れてから、本パッケージをインポートします。Runtime/Prefabs/Metamo.prefab をアバターのルート直下にドラッグすれば導入は完了です。ビルド時に NDMF が自動で設定します(元のマテリアル・アニメーターは変更しません)。

衣装チェンジを使うときは、続けて次の 3 つを行います。

  1. 着替え先の衣装を、先にアバターへ着せておきます。Modular Avatar に対応した衣装は、衣装の Prefab をアバターの下に置くだけです。対応していない衣装は、アバターの下に置いてから、右クリックの Modular Avatar > Setup Outfit で着せます。
  2. アバターに置いた Metamo のオブジェクトを選び、Add Component から Kuyuri > Metamo Outfits を足します。
  3. 「衣装セット」(Sets)に、セットの名前と、そのセットで表示するオブジェクトを登録します。先頭のセットが、アップロードしたときの状態です。体・顔・髪のように、どの衣装でも出したままのものは登録しません。

すでに Modular Avatar で衣装の切り替えメニューを作ってある場合は、3 の代わりに「MA のメニューから取り込む」が使えます(「4. 設定項目」)。

2. メニューの使い方(登場/退場・強度・衣装)

Metamo の項目は Ex メニューのいちばん上に 1 つだけ出ます(項目が 2 つ以上なら「メタモ」サブメニューにまとまり、1 つならその項目が直接出ます)。「登場・退場」トグルを ON にすると足元から現れ、OFF にすると頭から消えます。「強度」ラジアル(既定は使わない)で境界の発光・頂点の揺れ・パーティクルの強さを変えられます。「パーティクル OFF」と「ジェスチャー」は、Installer で使うようにしたときだけ出ます。 衣装チェンジを設定した場合は「衣装」サブメニューにセットが並びます。選ぶと、境界で入れ替わる(既定)か、いったん消えてから新しい衣装で現れます。消えている間に選ぶと演出なしで切り替わり、次の登場で新しい衣装が出ます。

3. 境界のパーティクルは 2 種類

境界(消える部分と残る部分の境目)から出るパーティクルは、仕組みの違う 2 種類を重ねています。どちらも既定で ON で、別々に OFF にできます。

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 で操作します。

  1. Look の下の 「既定のデザインを複製して編集」 を押します。Assets/Metamo_User/ に Look が作られ、欄に自動で入ります。同名のファイルは上書きせず連番になります。
  2. 「色・幅・ノイズを編集」 を開きます。Edge Use Gradient が ON なら Edge Gradient で色を変えます。左端は境界、右端は帯の外側、アルファは光の強さです。Edge Gradient Width は体の帯の幅、Geometry Particle Gradient Width はジオメトリパーティクルが色を拾う範囲です。
  3. 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)

7. 更新履歴

CHANGELOG.md を参照。