Expression Menu Builder - ShoninVRC/ShoninAssets GitHub Wiki

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>/...