Expressions: Difference between revisions

From VRChat Wiki
Hackebein (talk | contribs)
add expression parameter limits
DAG-XR (talk | contribs)
Proofread.
Line 2: Line 2:


[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in the Action Menu.]]  
[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in the Action Menu.]]  
'''Expressions''' are a feature of VRChat [[Special:MyLanguage/avatars|avatars]]. They let you run actions or toggles on your avatar, mainly through the [[Special:MyLanguage/Action Menu|action Menu]] or the Expressions wing on the [[Special:MyLanguage/Quick Menu|quick menu]] or [[Special:MyLanguage/Main Menu|main menu]]. They are user-customized menus and actions designed for flexible, easy access to avatar features.
'''Expressions''' are a feature of VRChat [[Special:MyLanguage/avatars|avatars]], consisting of user-customized menus that let you enable actions or toggles on your avatar; designed for flexible, easy access to unique avatar features.


More information is available at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
More information is available at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
Line 8: Line 8:
==Expressions menu==
==Expressions menu==


The in-game Expressions menu is accessible through the Action Menu or the Expressions wing on the Quick Menu or Main Menu in any version of VRChat. Changes are transferred globally to other users, ensuring synchronization.
The in-game Expressions menu is accessible through the [[Special:MyLanguage/Action Menu|Action Menu]], or the Expressions wing on the [[Special:MyLanguage/Quick Menu|Quick Menu]] and [[Special:MyLanguage/Main Menu|Main Menu]]. in any version of VRChat. Changes to an avatar's expressions are networked globally to other users on the same [[Platforms|platform]], and can be set-up for cross-platform [[Guides:Synchronization|synchronization]].


==Expressions in the SDK==
==Expressions in the SDK==


Expressions are edited using parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].


===Base expressions===
===Base expressions===


When no expressions are configured, a default expression menu with base animations is added to the avatar, containing:
When no expressions are configured, a default expression menu with base animations is added to the avatar, containing the following animations:
* Wave
* Wave
* Clap
* Clap
Line 28: Line 28:
===Custom expressions===
===Custom expressions===


To add custom expressions, create an '''Expression Menu''' file and an '''Expression Parameter''' file, then attach them to the VRChat Avatar Descriptor. The menu defines parameter entries shown on your avatar’s Expression menus. The parameters are the '''variables''' the menu controls. You also specify details such as whether parameters must be synchronized for other users. You can set 256 bits to be synced, with in 8192 variables.
To add custom expressions, create an '''Expression Menu''' file and an '''Expression Parameter''' file, then attach them to the VRChat Avatar Descriptor. The menu defines parameter entries shown on your avatar’s expression menus. The parameters are the '''variables''' the menu controls. You also specify details such as whether parameters must be synchronized for other users. You can set 256 bits to be synced, with in 8192 variables.


====Controls====
====Controls====
Line 41: Line 41:
=====Puppet Menu Example=====
=====Puppet Menu Example=====


[[File:PuppetMenu.gif|thumb|Example of the Action Menu and Face Mirror in use.]]
[[File:PuppetMenu.gif|thumb|Example of the Action Menu and Face Mirror in use. ''(Animated GIF)'']]
As you move your joystick, touchpad, or mouse in different directions, you change animation parameters to blend between moods (e.g., "happy" and "surprised"). Any parameter can be controlled from this menu.
As you move your joystick, touchpad, or mouse in different directions, you change animation parameters to blend between moods (e.g., "happy" and "surprised"). Any parameter can be controlled from this menu.


Line 50: Line 50:
* {{VRC link|https://vrchat.com/home/world/wrld_6168d07b-f55c-40bc-8077-749dde39983c|Avatar 3.0 Hub}} world on VRChat
* {{VRC link|https://vrchat.com/home/world/wrld_6168d07b-f55c-40bc-8077-749dde39983c|Avatar 3.0 Hub}} world on VRChat
* [https://creators.vrchat.com/avatars/expression-menu-and-controls/ Expression Menu and Controls] on Creator Docs
* [https://creators.vrchat.com/avatars/expression-menu-and-controls/ Expression Menu and Controls] on Creator Docs
* [https://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] on Creator Docs
* [https://creators.vrchat.com/avatars/animator-parameters/#expression-parameter-aliasing Animator Parameters] on Creator Docs
* [https://creators.vrchat.com/avatars/playable-layers Playable Layers] on Creator Docs
* [https://creators.vrchat.com/avatars/playable-layers Playable Layers] on Creator Docs


Line 55: Line 57:


* [[Avatars]]
* [[Avatars]]
** [[Avatar Dynamics]]
* [[Action Menu]]
* [[Action Menu]]
* [[VRChat SDK]]


== References ==
== References ==

Revision as of 23:14, 6 May 2025

V · EThis is an official VRChat information page!
It is reviewed and approved by the VRCWiki Team. Learn how to contribute to this page by reading the Contribution Guide.
An example of Expressions menu in the Action Menu.

Expressions are a feature of VRChat avatars, consisting of user-customized menus that let you enable actions or toggles on your avatar; designed for flexible, easy access to unique avatar features.

More information is available at Avatar Creators Docs.

Expressions menu

The in-game Expressions menu is accessible through the Action Menu, or the Expressions wing on the Quick Menu and Main Menu. in any version of VRChat. Changes to an avatar's expressions are networked globally to other users on the same platform, and can be set-up for cross-platform synchronization.

Expressions in the SDK

Expressions are edited using various parameters in the VRChat SDK.

Base expressions

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

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

Custom expressions

To add custom expressions, create an Expression Menu file and an Expression Parameter file, then attach them to the VRChat Avatar Descriptor. The menu defines parameter entries shown on your avatar’s expression menus. The parameters are the variables the menu controls. You also specify details such as whether parameters must be synchronized for other users. You can set 256 bits to be synced, with in 8192 variables.

Controls

You can create up to 8 controls per page. When creating a control, choose its type:

  • Button
  • Toggle
  • Sub Menu
  • Two Axis Puppet
  • Four Axis Puppet
  • Radial Puppet
Puppet Menu Example
Example of the Action Menu and Face Mirror in use. (Animated GIF)

As you move your joystick, touchpad, or mouse in different directions, you change animation parameters to blend between moods (e.g., "happy" and "surprised"). Any parameter can be controlled from this menu.

You can open one menu on either hand (or both). By default, flick to select an option. In Action Menu settings, you can choose to use the Trigger. To back out of a selection in the Expressions menu, pull the trigger.

Official resources

See also

References