Expressions: Difference between revisions

From VRChat Wiki
m (Text replacement - "\[\[(?!(Special:|File:|Media:))([^\|\]]+)\]\]" to "$2")
m (Bonked Category:Avatar features to lowercase; Manual of Style)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Stub}}
{{Noticebox/Official}}


[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in 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]].


[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in 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 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
'''Expressions''' are a feature of [[Special:MyLanguage/avatars|avatars]].
They allow you to run various actions on your avatar.


They can be used mainly through the [[Special:MyLanguage/Action Menu|Action Menu]].
==Expressions menu==


Expressions are user customized menus and actions meant to allow flexibility and easy access to avatar features.
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.


You can find more information at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
==Expressions in the SDK ==


==In-game menu==
Expressions are edited, using parameters in the [[VRChat SDK]].
 
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.
 
Those information are 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===
===Base expressions===
 
When no expressions are configured, a default expression menu with base animations is added to the avatar, which contain the following animations:
When no expressions are configured, a default expression menu with base animations is added to the avatar.
 
It contains the following entries:  


*Wave
*Wave
Line 40: Line 28:
===Custom expressions===
===Custom expressions===


To add custom expressions, you need to create a '''Expression Menu''' file and a '''Expression Parameter''' file, then add them to the VRChat Avatar Descriptor.
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.
 
====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=====
[[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.
 
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.
 
==Official resources==
 
*{{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/playable-layers Playable Layers] on Creator Docs


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


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.
* [[Avatars]]
* [[Action Menu]]


[[Special:MyLanguage/Category:Stubs|Category:Stubs]]
== References ==
[[Category:Proofread]]
[[Category:Avatar features]]

Latest revision as of 21:42, 13 September 2024

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

Expressions are a feature of VRChat avatars. They allow you to run various actions or toggles on your avatar. They can be used mainly through the Action Menu, or the Expressions wing on the Quick Menu or Main 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.

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.

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, which contain the following animations:

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

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

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.

Official resources

See also

References

Retrieved from "https://wiki.vrchat.com/index.php?title=Expressions&oldid=7428"