Expressions: Difference between revisions

From VRChat Wiki
DAG-XR (talk | contribs)
m Bonked Category:Avatar features to lowercase; Manual of Style
Hackebein (talk | contribs)
Proofread
Line 1: Line 1:
{{Noticebox/Official}}
{{Noticebox/Official}}


[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in 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 allow you to run various actions or toggles on your avatar. They can be used mainly through the [[Special:MyLanguage/Action Menu|Action Menu]], or the Expressions wing on the [[Quick Menu]] or [[Main 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 user-customized menus and actions meant to allow flexibility and easy access to avatar features. You can find more information 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}}.


==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 on any version of VRChat. This information is transferred globally to others users, so information is synchronized.
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.


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


Expressions are edited, using parameters in the [[VRChat SDK]].
Expressions are edited using 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, which contain the following animations:


*Wave
When no expressions are configured, a default expression menu with base animations is added to the avatar, containing:
*Clap
* Wave
*Point
* Clap
*Cheer
* Point
*Dance
* Cheer
*Backflip
* Dance
*Die
* Backflip
*Sadness
* Die
* Sadness


===Custom expressions===
===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 parameter entries, that will compile on the Expression 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.
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.


====Controls====
====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:  
You can create up to 8 controls per page. When creating a control, choose its type:
 
* Button
*Button
* Toggle
*Toggle
* Sub Menu
*Sub Menu
* Two Axis Puppet
*Two Axis Puppet
* Four Axis Puppet
* Four Axis Puppet
*Radial Puppet
* Radial Puppet


=====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.]]
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.
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.
 
Anything that is set as a parameter 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.
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==
==Official resources==


*{{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://creators.vrchat.com/avatars/playable-layers Playable Layers] on Creator Docs
* [https://creators.vrchat.com/avatars/playable-layers Playable Layers] on Creator Docs


== See also ==
== See also ==
Line 60: Line 58:


== References ==
== References ==
[[Category:Proofread]]
<references/>
 
[[Category:Avatar features]]
[[Category:Avatar features]]

Revision as of 20:51, 12 April 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. They let you run actions or toggles on your avatar, mainly through the action Menu or the Expressions wing on the quick menu or main menu. They are user-customized menus and actions designed for flexible, easy access to 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 or Main Menu in any version of VRChat. Changes are transferred globally to other users, ensuring synchronization.

Expressions in the SDK

Expressions are edited using 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:

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

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.

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