LACE - Logic-driven Avatar Costume Engine

VRChat アバター向けの NDMF プラグイン。
衣装パーツの ON/OFF トグルと、パラメータの論理演算に基づく条件付き制御（素体シェイプキー・オブジェクト表示）を1つのプラグインで完結させます。

機能

LACE Costume Item

メインコンポーネント。空の GameObject にアタッチし、ターゲットオブジェクト で制御対象を指定します。

  • Expression Menu トグル自動生成: パラメータ名・初期値・インストール先メニュー・サブメニューパスを設定可。親ヒエラルキーからの自動サブメニュー生成にも対応
  • パラメータ設定: 同期（Synced）・保持（Saved）を個別に設定可
  • 制御対象: GameObject の ON/OFF または BlendShape の値制御（複数シェイプキー選択可）
  • ターゲットオブジェクト: 制御したい GameObject を複数指定可。BlendShape モードでは各 GO の SkinnedMeshRenderer からシェイプキーを和集合で表示
  • 条件式: パラメータの AND/OR/NOT の論理演算で制御。自身のパラメータは自動で含まれるため、追加条件のみ設定すればOK
  • 条件式サマリー: 有効な条件式を「インナーがON かつ シャツがOFF」のような日本語で表示
  • 同一 GameObject に複数配置可: 条件別のシェイプキーグループ等を設定可能
  • AAO 互換: CostumeItem は制御対象の GO にアタッチしないため、AAO Trace and Optimize のメッシュ自動マージを阻害しません

LACE Dashboard

Tools/LACE/Dashboard から開く統合設定ウィンドウです。

  • 一覧 + 詳細の2ペインUI: 左で CostumeItem を選択し、右側で全設定を編集
  • 新規作成フロー統合: Hierarchy で選択中のオブジェクト一覧を確認しながら CostumeItem を作成
  • 自然言語ベースの条件編集: 固定条件をグレーアウト表示しつつ、追加条件を「すべて満たす / いずれかを満たす」で編集
  • BlendShape 値編集: BlendShape モード時のみ、条件成立時/不成立時の値を制御対象セクション内で設定
  • Inspector 最小化: CostumeItem の Inspector はサマリーとダッシュボード起動導線のみ

その他

  • 非破壊: NDMF ビルドフェーズで処理。元のアバターデータは変更しません
  • Modular Avatar 統合: メニュー・パラメータ・アニメータの統合に MA を使用
  • DNF 変換: 条件式を加法標準形に変換し、最適な Animator Transition を生成
  • ビルド時バリデーション: 設定ミスや不整合を自動検出（NDMF ErrorReport 対応）

使い方

推奨ワークフロー

  1. Tools/LACE/Dashboard を開く
  2. 左側一覧で既存の CostumeItem を選択、または下部の「新規作成」から追加
  3. 右側でメニュー設定、制御対象、切り替え条件を編集

Inspector からも最低限の情報確認はできますが、通常の編集はダッシュボード利用を推奨します。

基本（衣装パーツのトグル）

  1. アバター配下に空の GameObject を作成（例: LACE_Jacket）
  2. LACE Costume Item コンポーネントを追加（パラメータ名はオブジェクト名で自動設定）
  3. Tools/LACE/Dashboard を開き、対象アイテムを選択
  4. ターゲットオブジェクト に制御したい衣装 GameObject を追加
  5. ビルドするだけで Expression Menu にトグルが追加されます

複数オブジェクトの同時トグル

  1. 1つの CostumeItem の ターゲットオブジェクト に、同時にトグルしたい全 GameObject を追加
  2. 全ターゲットが同一条件で ON/OFF されます

条件付きシェイプキー制御（シュリンク等）

  1. 空 GameObject に CostumeItem を追加
  2. ダッシュボードで メニュー生成 = OFF、制御対象 = BlendShape に設定
  3. ターゲットオブジェクト に素体メッシュ等の SkinnedMeshRenderer を持つ GO を追加
  4. 「選択…」ボタンで全レンダラーのシェイプキーをまとめて選択
  5. 条件を満たした時の値 / 条件を満たさない時の値 を設定
  6. 切り替え条件に上着等のパラメータを設定

サブメニューパス

サブメニューパスはインストール先メニュー直下を基準に指定します。
例えばインストール先が Costume メニューの場合、パス Upper/Inner で Costume/Upper/Inner に配置されます。

親ヒエラルキーからの自動生成

親階層から自動生成 を有効にすると、CostumeItem 自身の親 GameObject 名を上から順に使ってサブメニューを非破壊生成します。
例えば Avatar/Costumes/Tops/Jacket に CostumeItem がある場合、Costumes/Tops が自動作成され、その中に Jacket トグルが配置されます。

要件

  • Unity 2022.3
  • VRChat Avatars SDK 3.x
  • NDMF 1.11.0+
  • Modular Avatar 1.16.0+

ライセンス

MIT License

Package Name

tool.hellcat.lace

Documentation

Undefined

Repositories

Version

0.3.3

Unity version

2022.3 or later

Dependencies

VPM Dependencies

Legacy Packages

No legacy packages

License

MIT

Author

Hellcat

Package JSON from Repository

{
  "name": "tool.hellcat.lace",
  "displayName": "LACE - Logic-driven Avatar Costume Engine",
  "version": "0.3.3",
  "unity": "2022.3",
  "description": "VRChatアバター向けNDMFプラグイン。ダッシュボード中心のUIで、衣装トグルと論理条件ベースの制御を非破壊で構築できます。",
  "dependencies": {
    "com.unity.modules.animation": "1.0.0"
  },
  "vpmDependencies": {
    "com.vrchat.avatars": ">=3.10.0",
    "nadena.dev.ndmf": ">=1.11.0 <2.0.0-a",
    "nadena.dev.modular-avatar": ">=1.16.0"
  },
  "author": {
    "name": "Hellcat",
    "url": "https://github.com/hellcat-M18"
  },
  "keywords": [
    "vrchat",
    "avatar",
    "costume",
    "ndmf",
    "non-destructive"
  ],
  "license": "MIT",
  "zipSHA256": "100694df0746dd98cdc7e875e7b548de8f6a005c8b90aded51c0a82c82b8caa3",
  "url": "https://github.com/hellcat-M18/LACE/releases/download/v0.3.3/tool.hellcat.lace-0.3.3.zip"
}