kieMergeableToggle

VRChat アバター用の NDMF プラグイン。

0.2.0-alpha — 動作は実測で確認していますが、実機での検証はまだ十分ではありません。

何をするもの

手書きアニメーターレイヤーで GameObject のオンオフをしているメッシュトグルを、 ビルド時に別の隠しかたへ機械的に変換します。

AAO (Avatar Optimizer) の自動メッシュ統合は「アクティブ状態のアニメーション」で メッシュをグルーピングするため、トグルが違うメッシュ同士は統合されません。 本ツールで変換するとメッシュ側は常時アクティブになり、表示切替は別の機構が担うので、 トグル挙動を保ったまま AAO がメッシュを統合できるようになります。

ポリゴン数は削減ツールで、マテリアル数は統合ツールで、いずれも非破壊で減らせます。 表示切替条件が一致しない SkinnedMeshRenderer だけは他のどのツールでも統合できません。 そこがこのツールの担当範囲です。

使い方

  1. アバタールートに Kie/kieMergeableToggle コンポーネントを追加
  2. 検出されたトグル一覧から変換したいものを選ぶ (クリーンな候補は初期状態でオン)
  3. 「自動で割り当てる」 を押す
  4. そのままビルドするだけ

レイヤー構造・パラメータ・メニューは一切変更しません。非破壊 (ビルド時のみ)。

隠しかた

機構ボーンコンストレイントマテリアル消えかたMobile
シェイプ(関節)±0±0統合される骨格上へ畳まれる可
シェイプ(軸)±0±0統合される骨格上へ畳まれる可
UVタイル破棄±0±0統合される完全に消える不可
NaNimation増える±0統合される完全に消える可
  • シェイプ(関節) — 全頂点をボーンの原点へ寄せるブレンドシェイプを生成します。 ランクの計上項目を一切増やしませんが、隠した形状は消滅せず骨格上へ畳まれるため、 体で覆われない部位では畳まれた面が見えることがあります。
  • シェイプ(軸) — 寄せ先をボーンの軸線分にします。関節へ集めると隣り合う関節を 結ぶ帯が親ボーンの座標系に固定されて動かず、周囲の体表がポーズで逃げるぶんだけ 帯が露出します。軸へ吸着させれば畳まれた面が手足の内部に沿って残ります。 タイツ・スラックスなど、肌に密着して関節を跨ぐ衣装向け。
  • UVタイル破棄 — lilToon の UDIM Discard を使い、頂点シェーダで座標を NaN に します。ボーンもコンストレイントも増やさずに完全に消えます。畳んでも面が残る スカート・ドレス・コート向け。lilToon 系シェーダ専用・PC 限定・15 枠まで。
  • NaNimation — ボーンを複製してスケールを NaN にします。boneCount が増えるので、 UVタイル破棄が使えない場合 (Mobile ビルド / 非 lilToon マテリアル) の退避先です。

自動割り当て

「自動で割り当てる」は、畳んだあとに実際どれだけ面が見えるかを静止時と着座ポーズの 両方で実測して機構を決めます (ポーズは一時的に付けて元へ戻します)。

  • 静止時に大きな面が残る → 畳んでも隠れないので UVタイル破棄
  • 静止時は消えているのにポーズで出てくる → シェイプ(軸)
  • どちらでもない → シェイプ(関節)

判定の根拠と閾値は Docs/hiding-mechanisms.md にあります。

注意点

  • インスペクタの一覧は参考表示です。ビルド結果とは一致しません。 正はビルドログです。
    • ビルド時にトグルを生成するツールのぶんは一覧に出ませんが、変換はされます。 編集時にはまだクリップが存在しないためです。実測では Avatar Menu Creator (Narazaka) が該当し、衣装アバターで一覧 8 件に対しビルド 18 件になりました。 MA Object Toggle も同様です。m_IsActive を生成しうる NDMF ツールは無数に あるため、一覧を完全にすることは原理的にできません。
    • 逆に、一覧に出ても変換されないものがあります。 ビルド中に階層を張り替える パッケージ (AvatarPoseSystem など) では、編集時とビルド時でパスが別物になるためです。
  • 「要注意」と表示される候補は、非表示中も止められないコンポーネントがトグル配下に あります。挙動を確認のうえ手動でオンにしてください。
  • 「適用不可」と表示される候補は、選んだ機構の条件を満たしていません。別の機構を 選んでください (放置するとビルド時に変換対象から外れます)。
  • 衣装の PhysBone は隠しても止まりません。 アーマチュア側に付いているため、 元のトグル (m_IsActive を 0 にする) でも同じです。本ツールによる変化では ありません。

依存

  • VRChat SDK - Avatars 3.7 以上
  • NDMF (nadena.dev.ndmf) 1.14 以上

効果を出すには Avatar Optimizer が必要です (依存には入れていません。本ツールは 「AAO が統合できる状態にする」だけで、統合するのは AAO です)。 UVタイル破棄を使う場合は lilToon が必要です。

Modular Avatar は必須ではありませんが、入っている場合は MA Merge Animator が 持ち込むトグルも扱います。本ツールは MA より後に走るので、ビルド時にトグルを生成する ツール (MA Object Toggle、Avatar Menu Creator など) のぶんも変換対象になります。

ライセンス

MIT

Package Name

com.kie.kie-mergeable-toggle

Documentation

Undefined

Repositories

Version

0.4.0-alpha (Changelog)

Unity version

2022.3 or later

Dependencies

No dependencies

VPM Dependencies

Legacy Packages

No legacy packages

License

MIT

Author

Kie

Package JSON from Repository

{
  "name": "com.kie.kie-mergeable-toggle",
  "displayName": "kieMergeableToggle",
  "version": "0.4.0-alpha",
  "unity": "2022.3",
  "description": "Converts existing hand-written animator mesh toggles into blend shapes, lilToon UV tile discard, or NaNimation at build time and normalizes renderer settings, so Avatar Optimizer can merge the toggled meshes while keeping the original toggle behavior.",
  "vpmDependencies": {
    "com.vrchat.avatars": "^3.7.0",
    "nadena.dev.ndmf": "^1.14.0"
  },
  "changelogUrl": "https://github.com/Kie610/kie-mergeable-toggle/blob/main/CHANGELOG.md",
  "author": {
    "name": "Kie",
    "email": "64377537+Kie610@users.noreply.github.com",
    "url": "https://github.com/Kie610"
  },
  "license": "MIT",
  "zipSHA256": "9b2a6decbb78cc0a7a06b0b2207138c77ffee081972cd47cf69c017e346efe7b",
  "url": "https://github.com/Kie610/kie-mergeable-toggle/releases/download/0.4.0-alpha/com.kie.kie-mergeable-toggle-0.4.0-alpha.zip"
}