Expressions - Revision history

Usr c0fd3826-5fbd-465b-869b-142f974af714: undo last edit

2026-05-25T21:53:27Z

undo last edit

← Older revision		Revision as of 21:53, 25 May 2026
Line 218:		Line 218:
	* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]		* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]
	* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]		* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]
	</translate>e		</translate>

	[[Category:Avatar features{{#translation:}}]]		[[Category:Avatar features{{#translation:}}]]

Usr 7b7be7b1-7a2b-4a76-95f9-54a5d9368b6a at 01:05, 24 May 2026

2026-05-24T01:05:37Z

← Older revision		Revision as of 01:05, 24 May 2026
Line 218:		Line 218:
	* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]		* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]
	* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]		* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]
	</translate>		</translate>e

	[[Category:Avatar features{{#translation:}}]]		[[Category:Avatar features{{#translation:}}]]

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: Marked this version for translation

2026-04-04T12:30:05Z

Marked this version for translation

← Older revision		Revision as of 12:30, 4 April 2026
Line 94:		Line 94:
	Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime. They are not set on sub-animators, only on playable-layer animators.		Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime. They are not set on sub-animators, only on playable-layer animators.

			<!--T:59-->
	Additional built-in parameters include:		Additional built-in parameters include:
	* <code>Viseme</code> (Int) — Set by lip sync from <code>0</code> (silence) to <code>14</code> (the "u" vowel) when the Avatar Descriptor's Lip Sync is set to Viseme Blend Shape or Viseme Parameter Only.		* <code>Viseme</code> (Int) — Set by lip sync from <code>0</code> (silence) to <code>14</code> (the "u" vowel) when the Avatar Descriptor's Lip Sync is set to Viseme Blend Shape or Viseme Parameter Only.
Line 105:		Line 106:
	* <code>ScaleFactor</code>, <code>ScaleFactorInverse</code>, <code>EyeHeightAsMeters</code>, <code>EyeHeightAsPercent</code> (Float) — Scaling-related parameters for avatar scaling. <code>EyeHeightAsMeters</code> is recommended for scale-aware systems because it is linear and does not depend on upload height.		* <code>ScaleFactor</code>, <code>ScaleFactorInverse</code>, <code>EyeHeightAsMeters</code>, <code>EyeHeightAsPercent</code> (Float) — Scaling-related parameters for avatar scaling. <code>EyeHeightAsMeters</code> is recommended for scale-aware systems because it is linear and does not depend on upload height.

			<!--T:60-->
	Each built-in parameter has a sync type determining when it is sent to remote users: ''IK'' for tracking-derived values (gestures, velocity, grounded), ''Speech'' for voice-related values (viseme, voice), ''Playable'' for user-state values (mute, earmuffs, tracking type, scale), or ''None'' for local-only values (IsLocal, PreviewMode).		Each built-in parameter has a sync type determining when it is sent to remote users: ''IK'' for tracking-derived values (gestures, velocity, grounded), ''Speech'' for voice-related values (viseme, voice), ''Playable'' for user-state values (mute, earmuffs, tracking type, scale), or ''None'' for local-only values (IsLocal, PreviewMode).

	=== Network synchronization ===		=== Network synchronization === <!--T:61-->

			<!--T:62-->
	Only synced expression parameters and certain built-in parameters are sent over the network. The full list of data sent for each avatar includes:		Only synced expression parameters and certain built-in parameters are sent over the network. The full list of data sent for each avatar includes:
	* '''IK targets''' — Head, jaw, and hands for desktop and 3-point tracking; additionally hip and feet for full-body tracking. Index controller users also sync finger positions.		* '''IK targets''' — Head, jaw, and hands for desktop and 3-point tracking; additionally hip and feet for full-body tracking. Index controller users also sync finger positions.
Line 115:		Line 118:
	* '''PhysBones''' — Pose position data is sent to late joiners.		* '''PhysBones''' — Pose position data is sent to late joiners.

			<!--T:63-->
	For reliable late-joiner support, a recommended pattern is to split animator logic using the <code>IsLocal</code> parameter: local-side layers handle contacts, parameter drivers, and all logic, then set synced parameters, while remote-side layers only read those synced parameters to play the correct visualization.		For reliable late-joiner support, a recommended pattern is to split animator logic using the <code>IsLocal</code> parameter: local-side layers handle contacts, parameter drivers, and all logic, then set synced parameters, while remote-side layers only read those synced parameters to play the correct visualization.

Line 208:		Line 212:
	==References== <!--T:46-->		==References== <!--T:46-->

			<!--T:64-->
	* [https://vrc.school/docs/Avatars/Expressions-Menu-Params VRC School: Expressions Menu and Parameters]		* [https://vrc.school/docs/Avatars/Expressions-Menu-Params VRC School: Expressions Menu and Parameters]
	* [https://vrc.school/docs/Avatars/Gestures VRC School: Hand Gestures/Facial Expressions]		* [https://vrc.school/docs/Avatars/Gestures VRC School: Hand Gestures/Facial Expressions]

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: add details about built-in and sync

2026-03-16T15:38:09Z

add details about built-in and sync

← Older revision		Revision as of 15:38, 16 March 2026
Line 84:		Line 84:

	<!--T:52-->		<!--T:52-->
	By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.		By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.

	=== Built-in parameters === <!--T:53-->		=== Built-in parameters === <!--T:53-->

	<!--T:54-->		<!--T:54-->
	VRChat also provides built-in Animator parameters such as <code>GestureLeft</code>, <code>GestureRight</code>, <code>GestureLeftWeight</code>, <code>GestureRightWeight</code>, <code>IsLocal</code>, <code>AFK</code>, <code>Seated</code>, <code>InStation</code>, and <code>TrackingType</code>. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.		VRChat also provides built-in Animator parameters. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.

	<!--T:55-->		<!--T:55-->
	Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime.		Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime. They are not set on sub-animators, only on playable-layer animators.

			Additional built-in parameters include:
			* <code>Viseme</code> (Int) — Set by lip sync from <code>0</code> (silence) to <code>14</code> (the "u" vowel) when the Avatar Descriptor's Lip Sync is set to Viseme Blend Shape or Viseme Parameter Only.
			* <code>Voice</code> (Float) — Perceived microphone volume from <code>0.0</code> to <code>1.0</code>, affected by distance and earmuff settings.
			* <code>VelocityX</code>, <code>VelocityY</code>, <code>VelocityZ</code>, <code>VelocityMagnitude</code> (Float) — Movement speed in m/s along each axis and total magnitude. Locally, playspace movement does not count; remotely, it does.
			* <code>Upright</code> (Float) — <code>0</code> when prone, <code>1</code> when standing.
			* <code>Grounded</code> (Bool) — Whether the user is touching the ground.
			* <code>MuteSelf</code> (Bool) — Whether the user's microphone is muted.
			* <code>Earmuffs</code> (Bool) — Whether the user has earmuffs enabled.
			* <code>IsOnFriendsList</code> (Bool) — Whether the viewer is friends with the avatar's wearer (shows False locally).
			* <code>ScaleFactor</code>, <code>ScaleFactorInverse</code>, <code>EyeHeightAsMeters</code>, <code>EyeHeightAsPercent</code> (Float) — Scaling-related parameters for avatar scaling. <code>EyeHeightAsMeters</code> is recommended for scale-aware systems because it is linear and does not depend on upload height.

			Each built-in parameter has a sync type determining when it is sent to remote users: ''IK'' for tracking-derived values (gestures, velocity, grounded), ''Speech'' for voice-related values (viseme, voice), ''Playable'' for user-state values (mute, earmuffs, tracking type, scale), or ''None'' for local-only values (IsLocal, PreviewMode).

			=== Network synchronization ===

			Only synced expression parameters and certain built-in parameters are sent over the network. The full list of data sent for each avatar includes:
			* '''IK targets''' — Head, jaw, and hands for desktop and 3-point tracking; additionally hip and feet for full-body tracking. Index controller users also sync finger positions.
			* '''Synced expression parameters''' — Only parameters marked as Synced are transmitted. Values are quantized: Int values sync in the range 0–255, Float values sync as multiples of 1/127 between −1 and 1, and Bools sync as true or false.
			* '''Built-in VRC parameters''' — Including gestures, velocity, voice, and other runtime parameters.
			* '''PhysBones''' — Pose position data is sent to late joiners.

			For reliable late-joiner support, a recommended pattern is to split animator logic using the <code>IsLocal</code> parameter: local-side layers handle contacts, parameter drivers, and all logic, then set synced parameters, while remote-side layers only read those synced parameters to play the correct visualization.

	=== Gestures and facial expressions === <!--T:56-->		=== Gestures and facial expressions === <!--T:56-->
Line 139:		Line 162:
	\|-		\|-
	\|Int → Bool		\|Int → Bool
	\|<translate><!--T:32--> Any Int value that ~~isn’t~~ 0 sets bool to True</translate>		\|<translate><!--T:32--> Any Int value that isn't 0 sets bool to True</translate>
	\|-		\|-
	\|Int → Int		\|Int → Int
Line 156:		Line 179:
	\|-		\|-
	\|Float → Bool		\|Float → Bool
	\|<translate><!--T:39--> Any Float value that ~~isn’t~~ 0 sets bool to True</translate>		\|<translate><!--T:39--> Any Float value that isn't 0 sets bool to True</translate>
	\|-		\|-
	\|Float → Int		\|Float → Int
Line 185:		Line 208:
	==References== <!--T:46-->		==References== <!--T:46-->

			* [https://vrc.school/docs/Avatars/Expressions-Menu-Params VRC School: Expressions Menu and Parameters]
			* [https://vrc.school/docs/Avatars/Gestures VRC School: Hand Gestures/Facial Expressions]
			* [https://vrc.school/docs/Avatars/VRC-Parameters VRC School: Built-In VRC Parameters]
			* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]
			* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]
	</translate>		</translate>
	~~<references />~~

	[[Category:Avatar features{{#translation:}}]]		[[Category:Avatar features{{#translation:}}]]

Usr adbb8876-cc64-48a6-adf5-8ee651bc98f4: Marked this version for translation

2026-03-15T16:12:36Z

Marked this version for translation

← Older revision		Revision as of 16:12, 15 March 2026
Line 37:		Line 37:
	To add custom expressions, create an '''Expression Menu''' asset and an '''Expression Parameters''' asset in Unity, then assign them in the ''Expressions'' section of the VRChat Avatar Descriptor. The menu defines which controls appear in the in-game menu, while the parameters asset defines the names, types, default values, and synchronization behavior of the values those controls change.		To add custom expressions, create an '''Expression Menu''' asset and an '''Expression Parameters''' asset in Unity, then assign them in the ''Expressions'' section of the VRChat Avatar Descriptor. The menu defines which controls appear in the in-game menu, while the parameters asset defines the names, types, default values, and synchronization behavior of the values those controls change.

			<!--T:47-->
	Each custom parameter can be marked as ''Saved'' and ''Synced''. Synced custom parameters count toward the avatar's 256-bit sync budget, while avatars can define up to 8192 total custom parameters. Parameters on this asset can also be changed by [[Special:MyLanguage/Contacts\|Contact Receivers]], [[Special:MyLanguage/parameter drivers\|parameter drivers]], [[Special:MyLanguage/physbones\|PhysBones]], and [[Special:MyLanguage/Open Sound Control\|OSC]].		Each custom parameter can be marked as ''Saved'' and ''Synced''. Synced custom parameters count toward the avatar's 256-bit sync budget, while avatars can define up to 8192 total custom parameters. Parameters on this asset can also be changed by [[Special:MyLanguage/Contacts\|Contact Receivers]], [[Special:MyLanguage/parameter drivers\|parameter drivers]], [[Special:MyLanguage/physbones\|PhysBones]], and [[Special:MyLanguage/Open Sound Control\|OSC]].

			<!--T:48-->
	The SDK also includes a ''Default Parameters'' button. This restores the three alias parameters used by VRChat's default AV3 controllers: <code>VRCEmote</code>, <code>VRCFaceBlendH</code>, and <code>VRCFaceBlendV</code>.		The SDK also includes a ''Default Parameters'' button. This restores the three alias parameters used by VRChat's default AV3 controllers: <code>VRCEmote</code>, <code>VRCFaceBlendH</code>, and <code>VRCFaceBlendV</code>.

Line 63:		Line 65:
	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.		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.

			<!--T:49-->
	When a puppet control is open, VRChat synchronizes its live values with the faster ''IK'' sync mode. After it is closed, the frozen value remains until it is changed again.		When a puppet control is open, VRChat synchronizes its live values with the faster ''IK'' sync mode. After it is closed, the frozen value remains until it is changed again.

Line 70:		Line 73:
	Expression Parameters are used to control avatar features via expression menu, [[Special:MyLanguage/Contacts\|contact receiver]], [[Special:MyLanguage/Open Sound Control\|OSC]], [[Special:MyLanguage/parameter drivers\|parameter drivers]] or [[Special:MyLanguage/physbones\|physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.		Expression Parameters are used to control avatar features via expression menu, [[Special:MyLanguage/Contacts\|contact receiver]], [[Special:MyLanguage/Open Sound Control\|OSC]], [[Special:MyLanguage/parameter drivers\|parameter drivers]] or [[Special:MyLanguage/physbones\|physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.

	=== Settings ===		=== Settings === <!--T:50-->

			<!--T:51-->
	Each entry in the Expression Parameters asset stores:		Each entry in the Expression Parameters asset stores:
	* '''Name''', which must match the Animator parameter name exactly.		* '''Name''', which must match the Animator parameter name exactly.
Line 79:		Line 83:
	* '''Synced''', which controls whether the value is sent to other users.		* '''Synced''', which controls whether the value is sent to other users.

			<!--T:52-->
	By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.		By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.

	=== Built-in parameters ===		=== Built-in parameters === <!--T:53-->

			<!--T:54-->
	VRChat also provides built-in Animator parameters such as <code>GestureLeft</code>, <code>GestureRight</code>, <code>GestureLeftWeight</code>, <code>GestureRightWeight</code>, <code>IsLocal</code>, <code>AFK</code>, <code>Seated</code>, <code>InStation</code>, and <code>TrackingType</code>. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.		VRChat also provides built-in Animator parameters such as <code>GestureLeft</code>, <code>GestureRight</code>, <code>GestureLeftWeight</code>, <code>GestureRightWeight</code>, <code>IsLocal</code>, <code>AFK</code>, <code>Seated</code>, <code>InStation</code>, and <code>TrackingType</code>. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.

			<!--T:55-->
	Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime.		Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime.

	=== Gestures and facial expressions ===		=== Gestures and facial expressions === <!--T:56-->

			<!--T:57-->
	The built-in <code>GestureLeft</code> and <code>GestureRight</code> parameters identify the user's hand gesture, while <code>GestureLeftWeight</code> and <code>GestureRightWeight</code> expose analog trigger pressure. On humanoid avatars, the Gesture playable layer is commonly used for hand poses, while facial expressions are often driven from the FX layer with blendshapes, material properties, or other non-humanoid animations.		The built-in <code>GestureLeft</code> and <code>GestureRight</code> parameters identify the user's hand gesture, while <code>GestureLeftWeight</code> and <code>GestureRightWeight</code> expose analog trigger pressure. On humanoid avatars, the Gesture playable layer is commonly used for hand poses, while facial expressions are often driven from the FX layer with blendshapes, material properties, or other non-humanoid animations.

			<!--T:58-->
	On tracked controllers where finger tracking overrides animation by default, creators can use a Tracking Control state behavior to switch the relevant fingers from ''Tracking'' to ''Animation'' when needed.		On tracked controllers where finger tracking overrides animation by default, creators can use a Tracking Control state behavior to switch the relevant fingers from ''Tracking'' to ''Animation'' when needed.

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: A couple more details

2026-03-14T18:20:56Z

A couple more details

← Older revision		Revision as of 18:20, 14 March 2026
Line 35:		Line 35:

	<!--T:11-->		<!--T:11-->
	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''' asset and an '''Expression Parameters''' asset in Unity, then assign them in the ''Expressions'' section of the VRChat Avatar Descriptor. The menu defines which controls appear in the in-game menu, while the parameters asset defines the names, types, default values, and synchronization behavior of the values those controls change.

			Each custom parameter can be marked as ''Saved'' and ''Synced''. Synced custom parameters count toward the avatar's 256-bit sync budget, while avatars can define up to 8192 total custom parameters. Parameters on this asset can also be changed by [[Special:MyLanguage/Contacts\|Contact Receivers]], [[Special:MyLanguage/parameter drivers\|parameter drivers]], [[Special:MyLanguage/physbones\|PhysBones]], and [[Special:MyLanguage/Open Sound Control\|OSC]].

			The SDK also includes a ''Default Parameters'' button. This restores the three alias parameters used by VRChat's default AV3 controllers: <code>VRCEmote</code>, <code>VRCFaceBlendH</code>, and <code>VRCFaceBlendV</code>.

	====Controls==== <!--T:12-->		====Controls==== <!--T:12-->
Line 41:		Line 45:
	<!--T:13-->		<!--T:13-->
	You can create up to 8 controls per page. When creating a control, choose its type:		You can create up to 8 controls per page. When creating a control, choose its type:
	* Button		* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
	* Toggle		* '''Toggle''' sets a value when enabled and resets it when disabled.
	* Sub Menu		* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
	* Two Axis Puppet		* '''Two Axis Puppet''' drives two float parameters from horizontal and vertical input, usually in the range <code>-1.0</code> to <code>1.0</code>.
	* Four Axis Puppet		* '''Four Axis Puppet''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
	* Radial Puppet		* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.

	=====Puppet Menu Example===== <!--T:14-->		=====Puppet Menu Example===== <!--T:14-->
Line 58:		Line 62:
	<!--T:17-->		<!--T:17-->
	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.		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.

			When a puppet control is open, VRChat synchronizes its live values with the faster ''IK'' sync mode. After it is closed, the frozen value remains until it is changed again.

	==Expression Parameter == <!--T:18-->		==Expression Parameter == <!--T:18-->
Line 63:		Line 69:
	<!--T:19-->		<!--T:19-->
	Expression Parameters are used to control avatar features via expression menu, [[Special:MyLanguage/Contacts\|contact receiver]], [[Special:MyLanguage/Open Sound Control\|OSC]], [[Special:MyLanguage/parameter drivers\|parameter drivers]] or [[Special:MyLanguage/physbones\|physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.		Expression Parameters are used to control avatar features via expression menu, [[Special:MyLanguage/Contacts\|contact receiver]], [[Special:MyLanguage/Open Sound Control\|OSC]], [[Special:MyLanguage/parameter drivers\|parameter drivers]] or [[Special:MyLanguage/physbones\|physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.

			=== Settings ===

			Each entry in the Expression Parameters asset stores:
			* '''Name''', which must match the Animator parameter name exactly.
			* '''Type''', which can be <code>Bool</code>, <code>Int</code>, or <code>Float</code>.
			* '''Default''', which is used when the avatar is reset.
			* '''Saved''', which controls whether the value persists between sessions.
			* '''Synced''', which controls whether the value is sent to other users.

			By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.

			=== Built-in parameters ===

			VRChat also provides built-in Animator parameters such as <code>GestureLeft</code>, <code>GestureRight</code>, <code>GestureLeftWeight</code>, <code>GestureRightWeight</code>, <code>IsLocal</code>, <code>AFK</code>, <code>Seated</code>, <code>InStation</code>, and <code>TrackingType</code>. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.

			Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime.

			=== Gestures and facial expressions ===

			The built-in <code>GestureLeft</code> and <code>GestureRight</code> parameters identify the user's hand gesture, while <code>GestureLeftWeight</code> and <code>GestureRightWeight</code> expose analog trigger pressure. On humanoid avatars, the Gesture playable layer is commonly used for hand poses, while facial expressions are often driven from the FX layer with blendshapes, material properties, or other non-humanoid animations.

			On tracked controllers where finger tracking overrides animation by default, creators can use a Tracking Control state behavior to switch the relevant fingers from ''Tracking'' to ''Animation'' when needed.

	== Expression Parameter Mismatching== <!--T:20-->		== Expression Parameter Mismatching== <!--T:20-->

	<!--T:21-->		<!--T:21-->
	Expression Parameter Mismatching refers to the practice of using different parameter types between your Expression Parameters and your local Animator Controller parameters. While it is recommended to keep parameter types consistent, mismatching is supported and the system will convert values between types according to specific rules. ~~Which~~ can be useful in certain <u>advanced</u> setups.		Expression Parameter Mismatching refers to the practice of using different parameter types between your Expression Parameters and your local Animator Controller parameters. While it is recommended to keep parameter types consistent, mismatching is supported and the system will convert values between types according to specific rules. This can be useful in certain <u>advanced</u> setups. The same conversion behavior can also be used with built-in VRChat Animator parameters.

	<!--T:22-->		<!--T:22-->
	Unity's Animator system uses floats on the backend for all parameter types, while VRChat ~~internally uses SBytes for parameter storage~~. The user interface in Unity and the VRCSDK ~~allows you to select~~ parameter types for convenience, but under the hood, ~~conversions are~~ possible. This means that parameters are not being cast, but rather mismatched. This behavior is also supported by popular tools such as Av3Emulator and Gesture Manager.		Unity's Animator system uses floats on the backend for all parameter types, while VRChat stores synced custom parameters in compact network-friendly formats. The user interface in Unity and the VRCSDK lets creators choose parameter types for convenience, but under the hood, value conversion is possible. This means that parameters are not being cast in the C# sense, but rather mismatched across systems. This behavior is also supported by popular tools such as Av3Emulator and Gesture Manager.

	===Expression Parameter Bool=== <!--T:23-->		===Expression Parameter Bool=== <!--T:23-->
Line 133:		Line 162:
	*[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://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/animator-parameters/ 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
			*[https://creators.vrchat.com/avatars/state-behaviors/ State Behaviors] on Creator Docs

	==See also== <!--T:44-->		==See also== <!--T:44-->

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: Marked this version for translation

2025-12-04T11:40:24Z

Marked this version for translation

Show changes

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: Prepare translations

2025-12-04T11:39:33Z

Prepare translations

← Older revision		Revision as of 11:39, 4 December 2025
Line 61:		Line 61:

	===Expression Parameter Bool===		===Expression Parameter Bool===
			</translate>
	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+<translate>Animator Controller Parameter</translate>
	!Type		!<translate>Type</translate>
	!Expression Bool = False		!<translate>Expression Bool = False</translate>
	!Expression Bool = True		!<translate>Expression Bool = True</translate>
	\|-		\|-
	\|Bool → Bool		\|Bool → Bool
Line 80:		Line 80:
	\|Float = 1.0		\|Float = 1.0
	\|}		\|}
			<translate>
	===Expression Parameter Int===		===Expression Parameter Int===
			</translate>
	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+<translate>Animator Controller Parameter</translate>
	!Type		!<translate>Type</translate>
	!Behaviour		!<translate>Behaviour</translate>
	\|-		\|-
	\|Int → Bool		\|Int → Bool
	\|Any Int value that isn’t 0 sets bool to True		\|<translate>Any Int value that isn’t 0 sets bool to True</translate>
	\|-		\|-
	\|Int → Int		\|Int → Int
	\|Expected Behaviour		\|<translate>Expected Behaviour</translate>
	\|-		\|-
	\|Int → Float		\|Int → Float
	\|Straight Conversion: e.g. Int = 2 → Float = 2.0		\|<translate>Straight Conversion: e.g. Int = 2 → Float = 2.0</translate>
	\|}		\|}
			<translate>
	===Expression Parameter Float===		===Expression Parameter Float===
			</translate>
	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+<translate>Animator Controller Parameter</translate>
	!Type		!<translate>Type</translate>
	!Behaviour		!<translate>Behaviour</translate>
	\|-		\|-
	\|Float → Bool		\|Float → Bool
	\|Any Float value that isn’t 0 sets bool to True		\|<translate>Any Float value that isn’t 0 sets bool to True</translate>
	\|-		\|-
	\|Float → Int		\|Float → Int
	\|Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0		\|<translate>Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</translate>
	\|-		\|-
	\|Float → Float		\|Float → Float
	\|Expected Behaviour		\|<translate>Expected Behaviour</translate>
	\|}		\|}
			<translate>
	==Resources==		==Resources==

Line 132:		Line 132:
	==References==		==References==

			</translate>
	<references />		<references />

	~~</translate>~~
	[[Category:Avatar features{{#translation:}}]]		[[Category:Avatar features{{#translation:}}]]

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: Prepared the page for translation

2025-12-04T11:37:43Z

Prepared the page for translation

← Older revision		Revision as of 11:37, 4 December 2025
Line 1:		Line 1:
			<languages/>
	{{Noticebox/Official}}		{{Noticebox/Official}}
			[[File:Action_Menu_Expressions.png\|thumb\|<translate>An example of Expressions menu in the Action Menu.</translate>]]
	[[File:Action_Menu_Expressions.png\|thumb\|An example of Expressions menu in the Action Menu.]]		<translate>
	'''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.		'''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.

Line 8:		Line 9:
	==Expressions menu==		==Expressions menu==

	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]].		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 [[Special:MyLanguage/Platforms\|platform]], and can be set-up for cross-platform [[Special:MyLanguage/Guides:Synchronization\|synchronization]].

	==Expressions in the SDK==		==Expressions in the SDK==
Line 31:		Line 32:

	====Controls====		====Controls====

	You can create up to 8 controls per page. When creating a control, choose its type:		You can create up to 8 controls per page. When creating a control, choose its type:
	* Button		* Button
Line 41:		Line 43:
	=====Puppet Menu Example=====		=====Puppet Menu Example=====

	[[File:PuppetMenu.gif\|thumb\|Example of the Action Menu and Face Mirror in use. ''(Animated GIF)'']]		</translate>
			[[File:PuppetMenu.gif\|thumb\|<translate>Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</translate>]]
			<translate>
	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 47:		Line 51:

	==Expression Parameter ==		==Expression Parameter ==
	Expression Parameters are used to control avatar features via expression menu, [[Contacts\|contact receiver]], [[Open Sound Control\|OSC]], [[parameter drivers]] or [[physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.
			Expression Parameters are used to control avatar features via expression menu, [[Special:MyLanguage/Contacts\|contact receiver]], [[Special:MyLanguage/Open Sound Control\|OSC]], [[Special:MyLanguage/parameter drivers\|parameter drivers]] or [[Special:MyLanguage/physbones\|physbones]]. These parameters are then mapped to Animator Controller parameters in your avatar's FX, Gesture, or Action controllers.

	== Expression Parameter Mismatching==		== Expression Parameter Mismatching==

	Expression Parameter Mismatching refers to the practice of using different parameter types between your Expression Parameters and your local Animator Controller parameters. While it is recommended to keep parameter types consistent, mismatching is supported and the system will convert values between types according to specific rules. Which can be useful in certain <u>advanced</u> setups.		Expression Parameter Mismatching refers to the practice of using different parameter types between your Expression Parameters and your local Animator Controller parameters. While it is recommended to keep parameter types consistent, mismatching is supported and the system will convert values between types according to specific rules. Which can be useful in certain <u>advanced</u> setups.

Line 55:		Line 61:

	===Expression Parameter Bool===		===Expression Parameter Bool===

	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+Animator Controller Parameter
Line 73:		Line 80:
	\|Float = 1.0		\|Float = 1.0
	\|}		\|}

	===Expression Parameter Int===		===Expression Parameter Int===

	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+Animator Controller Parameter
Line 88:		Line 97:
	\|Straight Conversion: e.g. Int = 2 → Float = 2.0		\|Straight Conversion: e.g. Int = 2 → Float = 2.0
	\|}		\|}

	===Expression Parameter Float===		===Expression Parameter Float===

	{\| class="wikitable"		{\| class="wikitable"
	\|+Animator Controller Parameter		\|+Animator Controller Parameter
Line 114:		Line 125:
	==See also==		==See also==

	*[[Avatars]]		*[[Special:MyLanguage/Avatars\|Avatars]]
	**[[Avatar Dynamics]]		**[[Special:MyLanguage/Avatar Dynamics\|Avatar Dynamics]]
	*[[Action Menu]]		*[[Special:MyLanguage/Action Menu\|Action Menu]]
	*[[VRChat SDK]]		*[[Special:MyLanguage/VRChat SDK\|VRChat SDK]]

	==References==		==References==

	<references />		<references />

	[[Category:Avatar features]]		</translate>
			[[Category:Avatar features{{#translation:}}]]

Usr 40be82e7-f7d5-4548-b314-3fc7b26d22ee: Add information about parameters

2025-05-15T18:18:39Z

Add information about parameters

@@ Line 46: / Line 46: @@
 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==
+==Expression Parameter ==
-* {{VRC link|https://vrchat.com/home/world/wrld_6168d07b-f55c-40bc-8077-749dde39983c|Avatar 3.0 Hub}} world on VRChat
+== Expression Parameter Mismatching==
-* [https://creators.vrchat.com/avatars/expression-menu-and-controls/ Expression Menu and Controls] on Creator Docs
+Expression Parameter Mismatching refers to the practice of using different parameter types between your Expression Parameters and your local Animator Controller parameters. While it is recommended to keep parameter types consistent, mismatching is supported and the system will convert values between types according to specific rules. Which can be useful in certain <u>advanced</u> setups.
-== See also ==
+Unity's Animator system uses floats on the backend for all parameter types, while VRChat internally uses SBytes for parameter storage. The user interface in Unity and the VRCSDK allows you to select parameter types for convenience, but under the hood, conversions are possible. This means that parameters are not being cast, but rather mismatched. This behavior is also supported by popular tools such as Av3Emulator and Gesture Manager.
-* [[Avatars]]
+===Expression Parameter Bool===
-** [[Avatar Dynamics]]
+{| class="wikitable"
-* [[Action Menu]]
+|+Animator Controller Parameter
-* [[VRChat SDK]]
+!Type
-== References ==
+==Resources==
 <references/>
 [[Category:Avatar features]]