VRChat Wiki - User contributions [en]

Expressions/zh-hans

2026-06-10T12:06:51Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "每页最多可以有 8 个控制项。当创建时，可选择以下 Type（类型）： * '''Button'''（按钮）：按下时设定值，并在 VRChat 发送变更后重置。 * '''Toggle'''（开关）：开启时设定值，关闭时重置值。 * '''Sub Menu'''（子菜单）：打开另一个模型功能菜单。该项可在打开子菜单时设定值（可选）。 * '''Two Axis Puppet'''：水平和垂直方向的两个浮点数输入，范围在<code>-1.0</code..."

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过[[Special:MyLanguage/Contacts|Contact Receivers]]、[[Special:MyLanguage/parameter drivers|parameter drivers]]、[[Special:MyLanguage/physbones|PhysBones]]或[[Special:MyLanguage/Open Sound Control|OSC]]更改。

SDK 也包括了一个 ''Default Parameters''（默认参数）按钮。它用于还原 VRChat 默认 AV3 控制器使用的三个参数别名：<code>VRCEmote</code>, <code>VRCFaceBlendH</code>以及<code>VRCFaceBlendV</code>。

<span id="Controls"></span>
====控制项（Controls）====

每页最多可以有 8 个控制项。当创建时，可选择以下 Type（类型）：
* '''Button'''（按钮）：按下时设定值，并在 VRChat 发送变更后重置。
* '''Toggle'''（开关）：开启时设定值，关闭时重置值。
* '''Sub Menu'''（子菜单）：打开另一个模型功能菜单。该项可在打开子菜单时设定值（可选）。
* '''Two Axis Puppet'''：水平和垂直方向的两个浮点数输入，范围在<code>-1.0</code>到<code>1.0</code>之间。
* '''Four Axis Puppet'''：对应四个方向的四个浮点数输入，范围在<code>0.0</code>到<code>1.0</code>之间。
* '''Radial Puppet'''：单个浮点数输入，范围在<code>0.0</code>到<code>1.0</code>之间。

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/13/zh-hans

2026-06-10T12:06:48Z

每页最多可以有 8 个控制项。当创建时，可选择以下 Type（类型）：
* '''Button'''（按钮）：按下时设定值，并在 VRChat 发送变更后重置。
* '''Toggle'''（开关）：开启时设定值，关闭时重置值。
* '''Sub Menu'''（子菜单）：打开另一个模型功能菜单。该项可在打开子菜单时设定值（可选）。
* '''Two Axis Puppet'''：水平和垂直方向的两个浮点数输入，范围在<code>-1.0</code>到<code>1.0</code>之间。
* '''Four Axis Puppet'''：对应四个方向的四个浮点数输入，范围在<code>0.0</code>到<code>1.0</code>之间。
* '''Radial Puppet'''：单个浮点数输入，范围在<code>0.0</code>到<code>1.0</code>之间。

Expressions/zh-hans

2026-06-10T12:06:46Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "====控制项（Controls）===="

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过[[Special:MyLanguage/Contacts|Contact Receivers]]、[[Special:MyLanguage/parameter drivers|parameter drivers]]、[[Special:MyLanguage/physbones|PhysBones]]或[[Special:MyLanguage/Open Sound Control|OSC]]更改。

SDK 也包括了一个 ''Default Parameters''（默认参数）按钮。它用于还原 VRChat 默认 AV3 控制器使用的三个参数别名：<code>VRCEmote</code>, <code>VRCFaceBlendH</code>以及<code>VRCFaceBlendV</code>。

<span id="Controls"></span>
====控制项（Controls）====

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/12/zh-hans

2026-06-10T12:06:42Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "====控制项（Controls）===="

====控制项（Controls）====

Expressions/zh-hans

2026-06-10T12:06:40Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "SDK 也包括了一个 ''Default Parameters''（默认参数）按钮。它用于还原 VRChat 默认 AV3 控制器使用的三个参数别名：<code>VRCEmote</code>, <code>VRCFaceBlendH</code>以及<code>VRCFaceBlendV</code>。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过[[Special:MyLanguage/Contacts|Contact Receivers]]、[[Special:MyLanguage/parameter drivers|parameter drivers]]、[[Special:MyLanguage/physbones|PhysBones]]或[[Special:MyLanguage/Open Sound Control|OSC]]更改。

SDK 也包括了一个 ''Default Parameters''（默认参数）按钮。它用于还原 VRChat 默认 AV3 控制器使用的三个参数别名：<code>VRCEmote</code>, <code>VRCFaceBlendH</code>以及<code>VRCFaceBlendV</code>。

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/48/zh-hans

2026-06-10T12:06:39Z

SDK 也包括了一个 ''Default Parameters''（默认参数）按钮。它用于还原 VRChat 默认 AV3 控制器使用的三个参数别名：<code>VRCEmote</code>, <code>VRCFaceBlendH</code>以及<code>VRCFaceBlendV</code>。

Expressions/zh-hans

2026-06-10T12:06:13Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过Contact Receivers、parameter drivers、PhysBones或OSC更..."

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过[[Special:MyLanguage/Contacts|Contact Receivers]]、[[Special:MyLanguage/parameter drivers|parameter drivers]]、[[Special:MyLanguage/physbones|PhysBones]]或[[Special:MyLanguage/Open Sound Control|OSC]]更改。

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/47/zh-hans

2026-06-10T12:06:11Z

每一个自定义参数都可被标记为 ''Saved''（储存）和 ''Synced''（同步）。标记为同步的自定义参数计入模型的 256 比特（bit）同步配额。一个虚拟形象最多可以定义 8192 个自定义参数。资产中的参数也可通过[[Special:MyLanguage/Contacts|Contact Receivers]]、[[Special:MyLanguage/parameter drivers|parameter drivers]]、[[Special:MyLanguage/physbones|PhysBones]]或[[Special:MyLanguage/Open Sound Control|OSC]]更改。

Expressions/zh-hans

2026-06-10T12:05:57Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/11/zh-hans

2026-06-10T12:05:51Z

欲添加自定义模型功能，可以在 Unity 中创建 '''Expression Menu'''（模型功能目录）资产（Asset）和 '''Expression Parameters'''（模型功能参数）资产，并将它们指定到 VRChat Avatar Descriptor 脚本的 ''Expressions'' 部分。Expression Menu 控制游戏菜单中显示哪些控制功能，而 Expression Parameters 则定义这些控制功能所改变的值的名称、类型、默认值以及同步行为。

Expressions/zh-hans

2026-06-10T12:04:53Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "===自定义模型功能==="

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<span id="Custom_expressions"></span>
===自定义模型功能===

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/10/zh-hans

2026-06-10T12:04:52Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "===自定义模型功能==="

===自定义模型功能===

Expressions/zh-hans

2026-06-10T12:04:50Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含： * Wave（挥手） * Clap（鼓掌） * Point（指差） * Cheer（欢呼） * Dance（跳舞） * Backflip（后空翻） * Die（死亡） * Sadness（伤心）"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/9/zh-hans

2026-06-10T12:04:48Z

当没有配置任何模型功能时，包含一些基础动画的默认模型功能菜单会被自动添加到虚拟形象之中。这些动画包含：
* Wave（挥手）
* Clap（鼓掌）
* Point（指差）
* Cheer（欢呼）
* Dance（跳舞）
* Backflip（后空翻）
* Die（死亡）
* Sadness（伤心）

Expressions/zh-hans

2026-06-10T12:04:46Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "===基础模型功能==="

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<span id="Base_expressions"></span>
===基础模型功能===

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/8/zh-hans

2026-06-10T12:04:43Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "===基础模型功能==="

===基础模型功能===

Expressions/zh-hans

2026-06-10T12:04:41Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "模型功能可通过 VRChat SDK 中的各种参数来编辑。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/7/zh-hans

2026-06-10T12:04:40Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "模型功能可通过 VRChat SDK 中的各种参数来编辑。"

模型功能可通过 [[Special:MyLanguage/VRChat SDK|VRChat SDK]] 中的各种参数来编辑。

Expressions/zh-hans

2026-06-10T12:04:34Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "==SDK 中的模型功能=="

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<span id="Expressions_in_the_SDK"></span>
==SDK 中的模型功能==

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/6/zh-hans

2026-06-10T12:04:33Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "==SDK 中的模型功能=="

==SDK 中的模型功能==

Expressions/zh-hans

2026-06-10T12:04:29Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "游戏内的模型功能菜单可在圆盘菜单中找到，也可从快捷菜单或主菜单中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一平台上的全部玩家，并可配置为跨平台同步。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/5/zh-hans

2026-06-10T12:04:27Z

游戏内的模型功能菜单可在[[Special:MyLanguage/Action Menu|圆盘菜单]]中找到，也可从[[Special:MyLanguage/Quick Menu|快捷菜单]]或[[Special:MyLanguage/Main Menu|主菜单]]中的模型功能侧边栏打开。该操作适用于所有 VRChat 版本。对虚拟形象的模型功能的操作将会全局同步到同一[[Special:MyLanguage/Platforms|平台]]上的全部玩家，并可配置为跨平台[[Special:MyLanguage/Guides:Synchronization|同步]]。

Expressions/zh-hans

2026-06-10T12:03:59Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "==模型功能菜单=="

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<span id="Expressions_menu"></span>
==模型功能菜单==

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/4/zh-hans

2026-06-10T12:03:54Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "==模型功能菜单=="

==模型功能菜单==

Expressions/zh-hans

2026-06-10T12:03:52Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions menu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/3/zh-hans

2026-06-10T12:03:51Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。"

更多信息请参阅 {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}。

Expressions/zh-hans

2026-06-10T12:03:47Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "'''模型功能'''是 VRChat 虚拟形象的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

<div lang="en" dir="ltr" class="mw-content-ltr">
More information is available at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions menu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/2/zh-hans

2026-06-10T12:03:46Z

'''模型功能'''是 VRChat [[Special:MyLanguage/avatars|虚拟形象]]的特性之一。它由自定义菜单组成，允许玩家在自己的虚拟形象上使能动作或开关，以便灵活便捷地访问虚拟形象的特有功能。

Expressions/zh-hans

2026-06-10T12:03:36Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "圆盘菜单中的模型功能示例。"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|圆盘菜单中的模型功能示例。]]

<div lang="en" dir="ltr" class="mw-content-ltr">
'''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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
More information is available at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions menu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/1/zh-hans

2026-06-10T12:03:32Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "圆盘菜单中的模型功能示例。"

圆盘菜单中的模型功能示例。

Expressions/zh-hans

2026-06-10T12:03:31Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "模型功能"

<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">An example of Expressions menu in the Action Menu.</span>]]

<div lang="en" dir="ltr" class="mw-content-ltr">
'''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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
More information is available at {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Avatar Creators Docs}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions menu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expressions in the SDK==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expressions are edited using various parameters in the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Base expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Custom expressions===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Controls====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can create up to 8 controls per page. When creating a control, choose its type:
* '''Button''' sets a value while pressed, then resets after VRChat sends the change.
* '''Toggle''' sets a value when enabled and resets it when disabled.
* '''Sub Menu''' opens another Expressions menu, and can optionally set a parameter while that submenu is open.
* '''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''' drives four float parameters, one for each direction, usually in the range <code>0.0</code> to <code>1.0</code>.
* '''Radial Puppet''' drives one float parameter from <code>0.0</code> to <code>1.0</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=====Puppet Menu Example=====
</div>

[[File:PuppetMenu.gif|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">Example of the Action Menu and Face Mirror in use. ''(Animated GIF)''</span>]]
<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Expression Parameter ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Settings ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
By default, custom parameter sync uses VRChat's ''Playable'' sync mode. Puppet controls temporarily use faster ''IK'' sync while they are actively open.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Built-in parameters ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Network synchronization ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gestures and facial expressions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Expression Parameter Mismatching==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Bool===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = False</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Expression Bool = True</span>
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Int===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Int → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Int value that isn't 0 sets bool to True</span>
|-
|Int → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|-
|Int → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Straight Conversion: e.g. Int = 2 → Float = 2.0</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
===Expression Parameter Float===
</div>
{| class="wikitable"
|+<span lang="en" dir="ltr" class="mw-content-ltr">Animator Controller Parameter</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Type</span>
!<span lang="en" dir="ltr" class="mw-content-ltr">Behaviour</span>
|-
|Float → Bool
|<span lang="en" dir="ltr" class="mw-content-ltr">Any Float value that isn't 0 sets bool to True</span>
|-
|Float → Int
|<span lang="en" dir="ltr" class="mw-content-ltr">Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0</span>
|-
|Float → Float
|<span lang="en" dir="ltr" class="mw-content-ltr">Expected Behaviour</span>
|}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Resources==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*{{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://docs.vrchat.com/docs/action-menu#expression-menu Action Menu - Expression Menu] 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/state-behaviors/ State Behaviors] on Creator Docs
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See also==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
*[[Special:MyLanguage/Avatars|Avatars]]
**[[Special:MyLanguage/Avatar Dynamics|Avatar Dynamics]]
*[[Special:MyLanguage/Action Menu|Action Menu]]
*[[Special:MyLanguage/VRChat SDK|VRChat SDK]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==References==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [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]
</div>

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

Translations:Expressions/Page display title/zh-hans

2026-06-10T12:03:27Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Created page with "模型功能"

模型功能

Getting Started/zh-hans

2026-06-02T13:27:31Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: format

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

<span id="Account_creation"></span>
==创建账号==

[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY|title=登录问题与账户管理|thumb=File:YTThumb_gXTe3GhWebY_SignIn.webp}}}}

当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/Impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/Controls|操控]]，调整[[Special:MyLanguage/Settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[[Special:MyLanguage/Avatars#Cloning|克隆]]他们的虚拟形象（如果可以的话）或屏蔽他们。

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/55/zh-hans

2026-06-02T13:27:24Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: format

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]以获得更好的视频播放支持。

Getting Started/zh-hans

2026-06-02T13:25:49Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

<span id="Account_creation"></span>
==创建账号==

[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY|title=登录问题与账户管理|thumb=File:YTThumb_gXTe3GhWebY_SignIn.webp}}}}

当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/Impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/Controls|操控]]，调整[[Special:MyLanguage/Settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[[Special:MyLanguage/Avatars#Cloning|克隆]]他们的虚拟形象（如果可以的话）或屏蔽他们。

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/42/zh-hans

2026-06-02T13:25:45Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[[Special:MyLanguage/Avatars#Cloning|克隆]]他们的虚拟形象（如果可以的话）或屏蔽他们。

Translations:Getting Started/40/zh-hans

2026-06-02T13:25:42Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/Controls|操控]]，调整[[Special:MyLanguage/Settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。

Getting Started/zh-hans

2026-06-02T13:24:01Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

<span id="Account_creation"></span>
==创建账号==

[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY|title=登录问题与账户管理|thumb=File:YTThumb_gXTe3GhWebY_SignIn.webp}}}}

当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/Impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/37/zh-hans

2026-06-02T13:23:53Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/Impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki

Getting Started/zh-hans

2026-06-02T13:23:53Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

<span id="Account_creation"></span>
==创建账号==

[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY|title=登录问题与账户管理|thumb=File:YTThumb_gXTe3GhWebY_SignIn.webp}}}}

<div class="mw-translate-fuzzy">
当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki
</div>

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/60/zh-hans

2026-06-02T13:23:50Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY|title=登录问题与账户管理|thumb=File:YTThumb_gXTe3GhWebY_SignIn.webp}}}}

Getting Started/zh-hans

2026-06-02T13:18:20Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: update link

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

<span id="Account_creation"></span>
==创建账号==

<div class="mw-translate-fuzzy">
[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY}}}}
</div>

<div class="mw-translate-fuzzy">
当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki
</div>

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/64/zh-hans

2026-06-02T13:18:03Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: update link

===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apps.apple.com/app/vrchat/id6448578770 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。

Getting Started/zh-hans

2026-06-02T13:15:53Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

<div class="mw-translate-fuzzy">
===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apple.co/4hxSKrK 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。
</div>

<span id="Account_creation"></span>
==创建账号==

<div class="mw-translate-fuzzy">
[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY}}}}
</div>

<div class="mw-translate-fuzzy">
当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki
</div>

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/24/zh-hans

2026-06-02T13:15:44Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928: Marked translation unit as no longer outdated with no changes

VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。

Getting Started/zh-hans

2026-06-02T13:15:30Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

<div class="mw-translate-fuzzy">
VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。
</div>

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

<div class="mw-translate-fuzzy">
===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apple.co/4hxSKrK 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。
</div>

<span id="Account_creation"></span>
==创建账号==

<div class="mw-translate-fuzzy">
[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY}}}}
</div>

<div class="mw-translate-fuzzy">
当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki
</div>

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/63/zh-hans

2026-06-02T13:15:28Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/Avatars|虚拟形象]]及[[Special:MyLanguage/Worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。

Translations:Getting Started/66/zh-hans

2026-06-02T13:15:24Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

* '''处理器：'''Intel® i5-4590 或 AMD FX 8350 或同等性能的设备
* '''内存：'''4GB
* '''显卡：'''NVIDIA GeForce® GTX 970 或 AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：'''31.5GB 存储空间（游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 30GB 用于缓存）
* '''网络连接：'''必需（推荐下载速度大于 25Mbps）
* '''系统：'''Windows 10, Windows 11

Getting Started/zh-hans

2026-06-02T13:15:21Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

<languages/>
{{Noticebox/Official}}
{{VisitorsIndicator}}

{{#description2:本页将会教你如何入门 VRChat。你将很快就会上手！}}
本页将会教你如何'''入门''' [[Special:MyLanguage/VRChat|VRChat]]。你将很快就会上手！

阅读本页即可轻松了解：

* 哪些[[Special:MyLanguage/Platforms|设备]]可以运行 VRChat？
* 从何处安装 VRChat
* 刚开始游玩 VRChat 时需要注意什么？
* 为你的初次体验提供帮助的额外视频指南

如果你对任何[[Special:MyLanguage/Community:Terminology|术语]]或主题抱有疑惑，可以随时点击蓝色高亮显示的超链接，这些链接可指向 VRChat Wiki 的其他页面。

<span id="System_requirements_/_recommendations"></span>
==系统要求 / 推荐配置==

<span id="Standalone_devices"></span>
===一体机设备===

VRChat 可以在以下一体机设备上运行：

* Meta Quest 2
* Meta Quest 3
* Meta Quest 3S
* Meta Quest Pro
* Vive Focus Vision
* Vive XR Elite
* Pico 4
* Pico 4 Pro
* Pico 4 Ultra

<span id="Mobile_devices"></span>
===移动设备===

VRChat 可在任何系统内存至少为 6GB，并连接至 Wi-Fi 或 4G/5G 蜂窝网络的安卓 10+ 以及 iOS 17.0+ 设备上运行。

任何最近发布的中端或更高配置的安卓以及 iOS 设备都应该满足这些要求。

===Steam Deck===

Valve 的测试表明，VRChat 已在 Steam Deck 上通过兼容性验证。它与 Steam Deck 的原生控制器和显示屏兼容良好。

*使用默认的控制器配置时，所有功能都可以访问。
*VRChat 将会显示 Steam Deck 的控制器图标。
*游戏内界面的文字在 Steam Deck 上清晰可见。
*VRChat 的默认图形设置在 Steam Deck 上运行良好。

===PC===

游戏的最低配置要求<ref>VRChat Help, 系统要求, https://help.vrchat.com/hc/en-us/articles/1500002378722-System-Requirements</ref><ref>Steam Store, VRChat, https://store.steampowered.com/app/438100/VRChat/</ref>基于 SteamVR 的最低配置要求<ref>Steam Store, SteamVR, https://store.steampowered.com/app/250820/SteamVR/</ref>。

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。

<div class="mw-translate-fuzzy">
* '''处理器：''' Intel® i5-4590 or AMD FX 8350 或同等性能的设备
* '''内存：''' 4GB
* '''显卡：''' NVIDIA GeForce® GTX 970 or AMD Radeon™ R9 290 或同等性能的设备
* '''硬盘空间：''' 21.5GB 存储空间 (游戏占用约 1.5GB<ref>SteamDB, VRChat, Depot https://steamdb.info/depot/438101/</ref>，最低 20GB 用于缓存)
* '''网络连接：''' 必需 (推荐下载速度大于 25Mbps)
* '''系统：''' Windows 10, Windows 11
</div>

<div class="mw-translate-fuzzy">
这是在桌面模式与 VR 模式下运行 VRChat 的<u>绝对最低</u>配置要求。
尽管应用程序可以运行，但你可能会遇到性能问题。
VRChat 中有大量用户创建的内容，有些[[Special:MyLanguage/avatars|虚拟形象]]及[[Special:MyLanguage/worlds|世界]]可能会导致超出正常预期的性能下降！建议调整[[Special:MyLanguage/Safety|安全设置]]以获得最佳体验。
</div>

<div class="mw-translate-fuzzy">
VRChat 可从 AMD X3D 系列 CPU 的大缓存中获益。至于图形处理器，选择拥有更多显存的显卡将为您带来高性能体验。不过，在某些情况下（包括 VR），仍建议您优先选择性能更高的显卡。
</div>

===PC (云游戏)===
====GeForce NOW====

VRChat 现已在 [https://www.nvidia.com/en-us/geforce-now/ GeForce NOW] 正式可用<ref>于 X - https://x.com/VRChat/status/1854237896707899862 发布的公告</ref>

<span id="Installing_VRChat"></span>
==安装 VRChat==

===在 Meta Quest 上安装===
''包括 Meta Quest 2, Meta Quest 3(S), Meta Quest 3S, Meta Quest Pro''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/1856672347794301 这里]安装。

===在 Pico 上安装===
''包括 Pico 4, Pico 4 Pro, Pico 4 Ultra''

你可以在 Pico 商店搜索 '''VRChat'''，或者从[https://store-global.picoxr.com/global/detail/1/7288745304105664518 这里]安装。

===在 Vive 上安装===
''包括 Vive XR Elite, Vive Focus Vision''

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/4b5187b8-004c-473c-9219-258c3ea8e255 这里]安装。

===在 PC 上安装===
建议安装 [https://apps.microsoft.com/detail/9nmzlz57r3t7 HEVC 视频扩展]
以获得更好的视频播放支持。

<span id="Via_Steam"></span>
==== 通过 Steam ====

你可以在 Steam 商店搜索 '''VRChat'''，或者从[https://store.steampowered.com/app/438100/VRChat 这里]安装。

<span id="Via_Viveport"></span>
====通过 Viveport====

你可以在 Viveport 商店搜索 '''VRChat'''，或者从[https://www.viveport.com/apps/469fbcbb-bfde-40b5-a7d4-381249d387cd/ 这里]安装。

====通过 Meta Store====
''包括 Meta Rift, Meta Rift S''

你可以在 Meta 商店搜索 '''VRChat'''，或者从[https://www.meta.com/experiences/pcvr/vrchat/997678176960598/ 这里]安装。

<span id="On_Android"></span>
===在安卓设备上安装===

你可以在 Google Play 商店搜索 '''VRChat'''，或者从[https://play.google.com/store/apps/details?id=com.vrchat.mobile.playstore 这里]安装。

<div class="mw-translate-fuzzy">
===在 iOS 设备上安装===
你可以在 iOS / iPadOS 的 App Store 搜索 '''VRChat'''，或者从[https://apple.co/4hxSKrK 这里]安装。
要安装并运行该应用，你的设备需要是运行 iOS 17 或更高版本、且拥有至少 6GB 内存的 iPhone 或 iPad 机型。
</div>

<span id="Account_creation"></span>
==创建账号==

<div class="mw-translate-fuzzy">
[[File:LoginPage.webp|thumb|VRChat 的登陆页面]]
{{Thumb|{{YouTube|gXTe3GhWebY}}}}
</div>

<div class="mw-translate-fuzzy">
当你启动 VRChat 时，你将会看到登录页面。你可以在这里更改语言设置，阅读[[Special:MyLanguage/Terms of Service|服务条款]]及[[Special:MyLanguage/Privacy Policy|隐私政策]]，通过 VRChat 账号登录，或根据使用的设备，通过 Steam、Meta、Google、Pico 或 VIVE 创建设备帐户。在登录 VRChat 之前，你需要先在 VRChat 的网站上[https://vrchat.com/home/register 注册]。创建 VRChat 账号后，你就可以访问 VRChat 应用程序、网页版 VRChat 个人资料、好友列表、浏览世界以及生成[[Special:MyLanguage/impostors|模型替身]]。除此之外，你还可以访问 [[Special:MyLanguage/VRChat_SDK|VRChat SDK]]，[https://feedback.vrchat.com 反馈论坛], [https://ask.vrchat.com 咨询论坛], 报名参加[[Special:MyLanguage/Creator Economy|创作者经济]]计划，及编辑 VRChat Wiki
</div>

通过 Steam, Meta, Google, Pico, 或 VIVE 创建的设备账号仅能访问 VRChat 应用程序。当然，如果你想先使用设备账号游玩游戏，之后再[[Special:MyLanguage/Account Merging|合并]]到你创建的 VRChat 账号也是完全没问题的。在合并的你的账户后，在登陆时选择你的设备账号，将会登录你的 VRChat 账号。

<span id="Learning_how_to_use_VRChat"></span>
==学习如何游玩 VRChat==

<div class="mw-translate-fuzzy">
在你登录 VRChat 后，你将出生在一个私人的主世界！在这里，你可以按照自己的节奏学习[[Special:MyLanguage/controls|操控]]，调整[[Special:MyLanguage/settings|设置]]，挑选你的第一个虚拟形象，并前往下一个世界！默认的主世界是 [[Special:MyLanguage/VRChat Home|VRChat Home]]，一个开始你美好一天的好地方。你可以随时打开快速菜单，点击'''回家'''按钮，返回你的主世界。
</div>

在 VRChat 中与其他用户见面时，你可以打开[[Special:MyLanguage/Quick Menu|快速菜单]]，了解用户的更多信息。要在 VR 模式中这样做，请使用你手中的激光对准他们，这时会出现一个胶囊，按下扳机键即可打开一个单独的菜单。在桌面模式上，你可以点击'''选择用户'''按钮，或者按住 Shift 键并将鼠标悬停在胶囊上，点击鼠标左键以打开新菜单。在移动设备上，只需点击用户即可打开菜单。

<div class="mw-translate-fuzzy">
快速菜单中还有一个'''当前所在位置'''选项卡，可以显示当前实例中的用户列表。通过点击列表中的用户昵称，你可以：阅读他们的个人简介、申请加为好友、更改麦克风音量、将他们静音、隐藏他们的虚拟形象、[https://wiki.vrchat.com/wiki/Avatars#Cloning 克隆]他们的虚拟形象（如果可以的话）或屏蔽他们。
</div>

== 更改游戏显示语言 ==
如果 VRChat 正在使用的是你无法理解的语言，你可以通过以下的方式修改它：
*图标可用于识别需点击的按钮。
<gallery widths="260" heights="150">
File:How to change UI Language1.webp|1. 打开快速菜单并'''双击'''图示的'''齿轮'''图标.
File:How_to_change_UI_Language2.webp|2. 选择'''夹在镜子和控制分类中间'''的用户界面分类，然后点击被'''绿色高亮圈出'''的按钮。
File:How_to_change_UI_Language3.webp|3. 选择 '''English''' 或者你的 '''首选语言'''.
</gallery>此外，你也可以在'''登陆页面'''修改语言设置'''.

<span id="Community_resources"></span>
==社区资源==

{{Noticebox/Community}}
我们的社区创建了许多关于 VRChat 的入门指南。以下是一些视频，你可以通过观看这些视频来学习如何游玩 VRChat，此外还有一些其他指南和内容。

<span id="Articles"></span>
=== 文章 ===

* [https://spritesanddice.com/features/vrchat-survival-pack/ The VRChat Survival Guide], 作者 Adam Factor - 一份关于 VRChat 的简介，推荐的头显设备，以及适合新手参与的“入门社区”合集。

=== 视频 ===
感谢 PHIA 和 [[Community:The Virtual Reality Show|The Virtual Reality Show]] 团队制作以下视频。

*[https://www.youtube.com/watch?v=Bm8quWg_wig <nowiki>VRCHAT BEGINNERS GUIDE [2024] - Introduction for New Players!</nowiki>] - 本指南是如何开始游玩 VRChat 的入门指南。

*[https://www.youtube.com/watch?v=4UBmmpt5iJ8 Best Places to see in VRChat! Quest & PC feat. Thrillseeker] - 现在你已经学会了如何游玩 VRChat，下面是一些可供探索的世界。

*[https://www.youtube.com/watch?v=vWr4diTDqJM How to upload a VRChat Avatar - Complete Guide! PC, Quest & VRoid] - 果你想知道如何创建和上传虚拟形象，这段视频是一个很好的起点。

*[https://www.youtube.com/watch?v=DomfNq0vNCk The Best VR Setup for YOU!] - 这篇指南介绍了 2024 年的 VR 硬件状况，并给想要升级设备的 VRChat 玩家做了详尽的设备推荐。

*[https://www.youtube.com/watch?v=QSyS4HSaFPA Derafrog's Ultimate A to Z Guide to VRChat] - 介绍有关 VRChat 多个部分的综合视频。

<span id="Official_resources"></span>
==官方资源==

*位于 ''help.vrchat.com'' 上的 {{VRC link|https://vrch.at/getting-started | VRChat 入门}}

==引用==
{{Reflist}}

{{Start-navbox}}
[[Category:Needs images{{#translation:}}]]

Translations:Getting Started/65/zh-hans

2026-06-02T13:15:16Z

Usr 7f3afbe5-16f1-4e56-b895-13aedc5ed928:

如果你想了解自己的 PC 是否可以运行 VRChat，可以将你的 PC 的配置与下方列出的最低需求进行比较。