Expressions

From VRChat Wiki
Revision as of 04:55, 26 August 2024 by ~Pausbe (talk | contribs) (Removed puppet menu example from action menu page and moved it here.)
Vrrat posed-right.png
V · EThis page is a stub.
You can help the VRChat Wiki by improving it.
[Reason: No reason provided.]


An example of Expressions menu in Action Menu

Expressions are a feature of avatars. They allow you to run various actions on your avatar.

They can be used mainly through the Action Menu.

Expressions are user customized menus and actions meant to allow flexibility and easy access to avatar features.

You can find more information at Official VRChat source Avatar Creators Docs.

In-game menu

The in-game Expressions menu is accessible through the Action Menu and is usable as well on desktop or in VR. It's made of all the different kind of buttons that the menu can have, and each type of menu will transfer an information to the avatar controllers to execute actions.

This information is transferred through network to others users, so information is synchronized.

Unity

The expressions are edited with the rest of the avatar in the Unity Editor.

Base expressions

When no expressions are configured, a default expression menu with base animations is added to the avatar.

It contains the following entries:

  • Wave
  • Clap
  • Point
  • Cheer
  • Dance
  • Backflip
  • Die
  • Sadness

Custom expressions

To add custom expressions, you need to create an Expression Menu file and an Expression Parameter file, then add them to the VRChat Avatar Descriptor.

The menu will allow you to create the entries that will translate into in game menus for your avatar.

The parameters are the variables that are controlled by the menu. You will also define technical information about those variables, like if they need to be synchronized for other users.

Controls

You can create a maximum of 8 controls per page. When creating a control, you choose the type of the control. These control types include:

  • Button
  • Toggle
  • Sub Menu
  • Two Axis Puppet
  • Four Axis Puppet
  • Radial Puppet
Puppet Menu Example
Example of the action menu in use

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.

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.

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.

To back out after making a selection in the Expressions menu, pull the trigger. Pull the trigger again to return to the main menu.