Expressions: Difference between revisions

From VRChat Wiki
(Add information for in game and unity edition + link to docs)
m (Bonked Category:Avatar features to lowercase; Manual of Style)
 
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== Expressions ==
{{Noticebox/Official}}


Expressions are a feature of {{VRC link/Wiki|Avatars}} .
[[File:Action_Menu_Expressions.png|thumb|An example of Expressions menu in Action Menu.]]
They allow you to run various Actions on your avatar.
'''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]].


They can be used mainly through the {{VRC link/Wiki|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 player customized menus and actions meant to allow flexibility and easy access to avatar features.
==Expressions menu==


You can find more information at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}
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.


=== In Game Menu ===
==Expressions in the SDK ==


The in game Menu expression is accessible through the Action Menu and is usable as well on desktop or in VR.
Expressions are edited, using parameters in the [[VRChat SDK]].
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.
===Base expressions===
When no expressions are configured, a default expression menu with base animations is added to the avatar, which contain the following animations:


=== Unity ===
*Wave
*Clap
*Point
*Cheer
*Dance
*Backflip
*Die
*Sadness


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


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


When no expressions are configured, a default expression menu with base animations is added to the avatar.
====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:


It contains the following entries :
*Button
*Toggle
*Sub Menu
*Two Axis Puppet
* Four Axis Puppet
*Radial Puppet


* Wave
=====Puppet Menu Example=====
* Clap
[[File:PuppetMenu.gif|thumb|Example of the Action Menu and Face Mirror in use.]]
* Point
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.
* Cheer
* Dance
* Backflip
* Die
* Sadness


==== Custom Expressions ====
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.


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


The Menu will allow you to create the entries that will translate into in game menus for your avatar.
==Official resources==


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


[[Category:Stubs]]
== See also ==
 
* [[Avatars]]
* [[Action Menu]]
 
== 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 Wiki Maintainers and VRChat Staff.
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"