VRC Menu Creator

VRChat Avatar SDK3 向けの非破壊 Toggle / Button 自動生成ツールです。
NDMF (Non-Destructive Modular Framework) を利用し、シーン上のアバターを一切変更せずにビルド時・Play Mode 突入時に自動でセットアップします。

必要環境

使い方

1. コンポーネントを追加する

Hierarchy でアバター配下の任意の GameObject を右クリックし、
VRCTools > Menu Creator を選択すると VRCMenuItem コンポーネントが追加されます。

アバター (VRCAvatarDescriptor) の配下でない場合はメニュー項目がグレーアウトします。

2. Inspector で設定する

共通設定

項目説明
デフォルト ONToggle のデフォルト状態を ON にする
パラメータ保存 (Saved)Expression Parameter を Saved にする
Write DefaultsFX レイヤーの Write Defaults を有効にする

アイテム一覧

各エントリに以下を設定します。

項目説明
パラメータ名FX レイヤー名・Expression Parameter 名（空欄で自動生成）
種別Toggle または Button
対象 Object表示 / 非表示を切り替える GameObject
メニュー表示名VRC Expressions Menu 上の名前（空欄でパラメータ名を使用）
メニューパスSubMenu のパス（例: Outfit/Tops → Root > Outfit > Tops）
アイコンメニューアイコン（省略可）

3. Play Mode またはビルドで自動生成

Play Mode を押すか、VRChat SDK でアバターをビルドすると自動的に以下が生成されます。

  • FX Animator Controller へのレイヤー追加
  • Expression Parameters への登録
  • Expressions Menu への Toggle / Button コントロール追加

シーン上のアバターは変更されません。

Toggle と Button の違い

ToggleButton
パラメータ型BoolBool
挙動ON/OFF を維持する押している間 true、離すと false
Saved共通設定に従う常に false
メニュー種別ControlType.ToggleControlType.Button

パラメータ名の注意

  • 空欄の場合、対象 Object 名 + _Toggle または _Button で自動生成されます
  • スペースは自動的にアンダースコア (_) に変換されます（例: My Item → My_Item）

ライセンス

MIT License

パッケージ名

com.m4rshal.vrc-menu-creator

ドキュメント

未設定

リポジトリ

バージョン

1.0.1

Unityバージョン

2022.3 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

MIT

作者

m4rshal

リポジトリ内のパッケージJSON

{
  "name": "com.m4rshal.vrc-menu-creator",
  "version": "1.0.1",
  "displayName": "VRC Menu Creator",
  "description": "VRChat Avatar SDK3 向けの非破壊 Toggle / Button 自動生成ツール。NDMFを使用。",
  "unity": "2022.3",
  "license": "MIT",
  "author": {
    "name": "m4rshal",
    "email": "m4rshal@m4rshal.com",
    "url": "https://github.com/m4rshal"
  },
  "url": "https://vpm.m4rshal.com/packages/vrc-menu-creator/1.0.1/vrc-menu-creator-1.0.1.zip",
  "repo": "https://vpm.m4rshal.com/vpm.json",
  "vpmDependencies": {
    "com.vrchat.avatars": ">=3.1.0",
    "nadena.dev.ndmf": ">=1.0.0"
  }
}