Expression Menu Builder

License

このスクリプトはMITライセンスで提供致します。

This script is provided under the MIT license.
LICENSE:https://github.com/ShoninVRC/ShoninAssets/blob/master/LICENSE

Background

VRChat内で大量のポーズを切り替えるメニューを自動で作りたいので実装しました。多分他にもっと凝ったツールはあります。

I implemented this because I wanted to automatically generate a menu for switching between a large number of poses within VRChat. There are probably other, more sophisticated tools out there.

Usage

エディタ画面上部のShoninAssets/Expression Menu Builderからウィンドウを開きます。

■ 基本設定

• Animator Controller: 手順 2 で設定した Animator Controller をセットします。
• Target State Machine: 対象のステートマシンを選択します。

■ トランジション出発点設定

• Source Type: 手順 2 で作成したトランジションの出発点（Entry, Any State, Specific State）と揃えます。
  • Entry, Any Stateはそれぞれステートマシンにデフォルトで配置されているステートです。Specific Stateを選択すると自分で配置した任意のステートを選択できます。
  • サブステートマシンでAny Stateを選択すると同レイヤー内の他ステートマシンからも遷移してしまうのでご注意ください。

■ 生成設定

• Base Asset Name: 生成されるアセット名および保存先フォルダ名を指定します（初期値はステートマシン名）。
• Max Items Per Page: 1 ページあたりの最大項目数（1〜8）を指定します。
  • 項目数がこれを超える場合、自動的に Page 1, Page 2... という階層構造（SubMenu）付きで分割生成されます。

■ 対象パラメータ選択

出発点のトランジションで使用されているパラメータの一覧が表示されます。メニュー項目に組み込みたいパラメータにチェックを入れます。

■ メニューの生成

• Expression Menu を生成: ボタンをクリックするとアセットが生成されます。
• 生成アセットの保存先パス：
  Assets/VRCExpressionMenuCreator/Generated/<BaseAssetName>/...

Open the window from ShoninAssets/Expression Menu Builder at the top of the editor screen.

■ Basic Settings

• Animator Controller: Set the Animator Controller configured in Step 2.
• Target State Machine: Select the target state machine.

■ Transition Starting Point Settings

• Source Type: Match this to the transition starting point (Entry, Any State, Specific State) you created in Step 2.
  • Entry and Any State are states placed in the state machine by default. If you select Specific State, you can choose any state you have placed yourself.
  • Please note that selecting Any State in a sub-state machine will allow transitions from other state machines within the same layer.

■ Generation Settings

• Base Asset Name: Specify the name of the generated asset and the destination folder (the default is the state machine name).
• Max Items Per Page: Specify the maximum number of items per page (1–8).
  • If the number of items exceeds this limit, they will automatically be split into separate assets with a hierarchical structure (SubMenu) labeled Page 1, Page 2, and so on.

■ Select Target Parameters

A list of parameters used in the starting transition is displayed. Check the boxes next to the parameters you want to include in the menu items.

■ Generating the Menu

• Generate Expression Menu: Click this button to generate the asset.
• Save path for the generated asset: Assets/VRCExpressionMenuCreator/Generated/<BaseAssetName>/...