Action Menu: Difference between revisions

From VRChat Wiki
(Added various internal links. Added categories)
(Updated section on emoji & stickers.)
 
(3 intermediate revisions by the same user not shown)
Line 3: Line 3:
The '''Action Menu''' is the primary way to access controls for your avatar and various other quick-access functions. When using an Avatars 3.0 avatar, these controls can be fully customized and can be one of many types. This menu allows you to drive various parameters, informing your avatar on how to react based on how you've set up your animators.
The '''Action Menu''' is the primary way to access controls for your avatar and various other quick-access functions. When using an Avatars 3.0 avatar, these controls can be fully customized and can be one of many types. This menu allows you to drive various parameters, informing your avatar on how to react based on how you've set up your animators.


== Using the Action Menu ==
You can open up a max of 2 action menus to control your experience with more flexibility.<small>*</small>
=== Controller ===
To open the Action Menu, hold down the "Menu" button that usually pulls up your [[Quick Menu]]. A new menu will pop up—this is the Action Menu. It provides quick access to items like emotes, emojis, avatar features, and more.


Use your joystick to move the cursor. Select items by moving to them and releasing the joystick—similar to "flicking" to the item. You can change the settings to confirm selections with a trigger pull in the Action Menu settings.
==Opening the Action Menu==
Opening the Action Menu varies on which control type you are using.  


=== Desktop ===
*'''Keyboard/Mouse:''' Press '''R''' to open.
Press '''R''' to open the Action Menu. You can only open one menu in Desktop mode, and you must click to confirm your choices.
*'''VR Controller:''' Hold down the button that opens up your [[Quick Menu]]. Depending on which hand you open the Action Menu with, it will either open up the left or right one.
*'''Gamepad:''' Press in on the right thumbstick to open.
*'''Mobile:''' Hold down on the menu button.


=== Settings ===
<sup>*The Keyboard/Mouse, Gamepad, and Mobile control types only opens one action menu (left), using both action menus is not possible using these control types.</sup>
Using the "Bindings" button in the [[Settings]] menu, you can change how you pull up the Action Menu. For instance, you can set it to open by clicking the joystick on your controller.


''Note: The Quest Hand Tracking Beta does not have access to the Action Menu yet. To control your avatar, use a Quick Menu wing instead.''
==Layout==
When first opening the Action Menu it is separated into 4 sections: Expressions, Emojis, Tools, and Options.


== Selection Methods ==
===Expressions===
=== Flick Select ===
In Flick mode, push the joystick in the direction of the pie slice you want to trigger. Pushing part way shows an indicator of the selection. Pushing all the way triggers the selection.
 
=== Pick Select ===
Pick mode involves pushing the joystick towards the pie slice and confirming the selection with the trigger on the controller (or mouse click on Desktop). The default mode is Flick, except for Vive controllers. You can switch to Pick mode in Action Menu > Settings > Flick enabled setting.
 
== Layout ==
The UI consists of three levels: the Action Menu, the Expression Menu, and the Puppet Menu.
 
=== Action Menu ===
The root menu includes Gesture Toggle, Config (for the UI), Emojis, Expression Menu, and Close.
 
=== Expression Menu ===
{{Main|Expressions}}
{{Main|Expressions}}
This menu can have various widgets, including stages. Entering a stage with puppets switches you to that stage's puppet mode. You can have multiple stages in each expression menu and a menu open in each hand.
This menu is used to change different features on your avatar, each avatar's expression menu is different.
==== Quick Actions====
Quick Actions is a menu under the Expression menu that lets you control various parts of your avatar, the options in this menu are:
*Avatar Height : changes the height of your avatar between 0.20M - 5.00M
* Reset Height : Sets the height of your avatar back to the default
*Release poses : Resets poses for [[Physbones]]
*Reset Avatar : Resets all parts of your avatar including Physbones and saved toggles
*Legacy Fingers : Avatars fingers will be animated by SteamVR skeletal data if Disabled
=== Widgets===
Widgets include Button, Toggle, and other control types, which can be configured to act in various ways.


===Puppet Menu===
===Quick Actions===
The Puppet Menu allows you to drive various values/parameters for your avatar. When building an Avatars 3.0 avatar, you can map these out. In this mode, you can move the joysticks, touch the Vive touchpad, or use your mouse to control the puppet.
Quick Actions is a menu under the Expression menu that lets you control various parts of your avatar, the options in this menu are: 
*'''Avatar Height:''' changes the height of your avatar between 0.20M - 5.00M
*'''Reset Height:''' Sets the height of your avatar back to the default set in Unity.
*'''Release Poses:''' Resets poses for [[Physbones]]
*'''Reset Avatar:''' Resets all parts of your avatar, including Physbones and saved toggles
*'''Legacy Fingers:''' Avatars fingers will be animated by SteamVR skeletal data if Disabled


To return to the Expression Menu from a Puppet Menu, pull the trigger with the stick centered.
===Emojis & Stickers===
The emoji & stickers sub-menu is for emojis; which appear in the surrounding air, or [[VRChat+#Stickers|stickers]]; which you can place within the [[Worlds|world]] you are in.


== Closing and Saving==
====Tools====
To close the Action or Expression Menu or any of their folders, choose the Back option at the top of the radial menu. Clicking the joystick (holding down the Vive button or pressing '''R''' on the keyboard) will close the menu but remember your place. Reverse this process to return to where you left off.
The tools sub-menu is the home of commonly used features, these tools include:


==Puppet Menu Example==
*[[Mirrors#Personal Mirror|Personal Mirror]]
[[File:PuppetMenu.webp|thumb|The Puppet Menu in action]]
*[[Mirrors#Face Mirror|Face Mirror]]
As you move your joystick/touchpad/mouse in various directions, you drive animation parameters to different values. This setup allows blending between various "moods," such as "happy" and "surprised," or other adjacent moods.
*[[Chatbox]]
*[[Camera]]


This is one way to use the Puppet Menu. Anything that can be parameterized can be controlled from this menu. There are also toggle buttons and other types of UI elements still in development.
====Options====
The options sub-menu hosts a plethora of options consisting of Action Menu, nameplates, avatar options and more.


You can pull up one menu on either hand (or both simultaneously). By default, you "flick" to select an option. In the Action Menu settings, you can choose to use the Trigger to select an option.
==Using the Action Menu==
[[File:PuppetMenu.gif|thumb|Example of the action menu in use]]
===Selection Methods===
You can toggle on and off section methods by opening up your Action Menu > Options > Action Menu > Flick Select.


To back out after making a selection in the Expressions menu, pull the trigger. Pull the trigger again to return to the main menu.
====Flick Select====
 
In Flick mode, push the joystick in the direction of the pie slice you want to trigger. Pushing part way shows an indicator of the selection. Pushing all the way triggers the selection.
==Accessing the Action Menu==
=== Valve Index Controllers ===
* Pull up the Action Menu by clicking the joystick on the corresponding hand.
*Back out of menus (or select an option when "Flick Select" is disabled) with the trigger.
 
===Oculus Touch Controllers===
*Pull up the Action Menu by clicking the joystick on the corresponding hand.
*Back out of menus (or select an option when "Flick Select" is disabled) with the trigger.
 
===Vive Wand Controllers ===
*Pull up the Action Menu by clicking and holding the Menu button at the top of the controller.
 
===Other Controllers===
* If there's a joystick, clicking it inward should bring up the Action Menu.
*Back out of menus (or select an option when "Flick Select" is disabled) with the trigger.


=== All Controllers===
====Pick Select====
*Pull up the UI by holding down the Quick Menu button.
Pick mode involves pushing the joystick towards the pie slice and confirming the selection with the trigger on the controller (or mouse click on Desktop).


===Desktop Mode===
===Closing and Saving===
*Press '''R''' to pull up the Action Menu.
To close the Action or Expression Menu or any of their folders, choose the Back option at the top of the radial menu. Doing the inverse of opening the action menu will close the menu but remember your place. Reverse this process to return to where you left off.
*Move the mouse to select items, and click to confirm selections.
*Click '''R''' or '''Esc''' to back out of the menu.


==Debug Menu==
==Gallery==
The [[Debug Menu|debug menu]] in the Action Menu is a powerful tool. It displays the current animator state of your avatar, including parameter values, tracking states, and current motion states. It is useful for debugging.
<gallery heights="100">
File:Action Menu.png|Action Menu main page
File:Action Menu Emojis.png|Action Menu emojis page
File:Action Menu Tools.png|Action Menu tools page
File:Action Menu Quick Actions.png|Action Menu quick actions page
File:Action Menu Expressions.png|Action Menu expressions page
File:Action Menu Nameplates.png|Action Menu nameplates page
File:Action Menu Personal Mirror.png|Action Menu personal mirror page
</gallery>


==Resources==
==Resources==


*[https://docs.vrchat.com/docs/action-menu Action Menu] page on docs.vrchat.com
*[https://www.youtube.com/shorts/PZsOQTLvPAc What is the Action Menu?] on YouTube
*[https://www.youtube.com/shorts/PZsOQTLvPAc What is the Action Menu?] on YouTube


[[Category:User Interface]]
[[Category:User Interface]]
[[Category:Menus]]
[[Category:Menus]]

Latest revision as of 02:01, 11 October 2024

VRLogo.png
V · EThis is an official VRChat information page!
It is written and maintained by VRCWiki Team.
An image of the Action Menu

The Action Menu is the primary way to access controls for your avatar and various other quick-access functions. When using an Avatars 3.0 avatar, these controls can be fully customized and can be one of many types. This menu allows you to drive various parameters, informing your avatar on how to react based on how you've set up your animators.

You can open up a max of 2 action menus to control your experience with more flexibility.*

Opening the Action Menu

Opening the Action Menu varies on which control type you are using.

  • Keyboard/Mouse: Press R to open.
  • VR Controller: Hold down the button that opens up your Quick Menu. Depending on which hand you open the Action Menu with, it will either open up the left or right one.
  • Gamepad: Press in on the right thumbstick to open.
  • Mobile: Hold down on the menu button.

*The Keyboard/Mouse, Gamepad, and Mobile control types only opens one action menu (left), using both action menus is not possible using these control types.

Layout

When first opening the Action Menu it is separated into 4 sections: Expressions, Emojis, Tools, and Options.

Expressions

Primary Page: Expressions

This menu is used to change different features on your avatar, each avatar's expression menu is different.

Quick Actions

Quick Actions is a menu under the Expression menu that lets you control various parts of your avatar, the options in this menu are:

  • Avatar Height: changes the height of your avatar between 0.20M - 5.00M
  • Reset Height: Sets the height of your avatar back to the default set in Unity.
  • Release Poses: Resets poses for Physbones
  • Reset Avatar: Resets all parts of your avatar, including Physbones and saved toggles
  • Legacy Fingers: Avatars fingers will be animated by SteamVR skeletal data if Disabled

Emojis & Stickers

The emoji & stickers sub-menu is for emojis; which appear in the surrounding air, or stickers; which you can place within the world you are in.

Tools

The tools sub-menu is the home of commonly used features, these tools include:

Options

The options sub-menu hosts a plethora of options consisting of Action Menu, nameplates, avatar options and more.

Using the Action Menu

Example of the action menu in use

Selection Methods

You can toggle on and off section methods by opening up your Action Menu > Options > Action Menu > Flick Select.

Flick Select

In Flick mode, push the joystick in the direction of the pie slice you want to trigger. Pushing part way shows an indicator of the selection. Pushing all the way triggers the selection.

Pick Select

Pick mode involves pushing the joystick towards the pie slice and confirming the selection with the trigger on the controller (or mouse click on Desktop).

Closing and Saving

To close the Action or Expression Menu or any of their folders, choose the Back option at the top of the radial menu. Doing the inverse of opening the action menu will close the menu but remember your place. Reverse this process to return to where you left off.

Gallery

Resources