Controls: Difference between revisions

From VRChat Wiki
m (fixed headers)
m (→‎VR controls: Added "(S)" to Quest 3.)
 
(18 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Noticebox/Official}}
'''Controls''' are arrays of inputs on controllers and devices to navigate [[Special:MyLanguage/VRChat|VRChat]]. VRChat supports several operating systems, with multiple combinations of devices and controllers. Some of these controls can be configured in the [[Special:MyLanguage/Settings#Controls|Settings]] Menu. Depending on the platform you are using VRChat on, you may be able to customize controls further by using the Settings menu in VRChat, or your device's dashboard.


{{noticebox/official}}
The Settings Menu within VRChat details the button mappings for the device you’re currently using. Below are the default configurations:
You may customize your controls in the Settings menu. Depending on the platform you are using VRChat on, you may be able to customize controls further by using the settings menu for your device.


The Settings menu also documents the button mappings for the device you’re currently using.
==Primary controls==
These are the basic controls for navigating and interacting within VRChat that apply to the different input types:
{| class="wikitable" style="text-align:center;"
! style="text-align:center;" |Action
! style="text-align:center;" |Keyboard/Mouse
! style="text-align:center;" |VR Controller
! style="text-align:center;" |Gamepad (Xbox)
! style="text-align:center;" |Mobile
|-
! scope="row" style="text-align:center;" |Move
|WASD
| colspan="2" |Left Thumbstick
|Virtual Thumbstick
|-
! scope="row" style="text-align:center;" |Turn
|Mouse Move
| colspan="2" | Right Thumbstick
|Hold and drag screen
|-
! scope="row" style="text-align:center;" |Jump
|Space
|A (right hand, bottom button)
|A
|Jump Button
|-
! scope="row" style="text-align:center;" |Crouch
|C
| colspan="1" rowspan="2" |''−−''
| rowspan="1" |Left Thumbstick (Click)
| rowspan="2" |Jump Button (Hold)
|-
! scope="row" style="text-align:center;" |Prone / Crawl
|Z
|Left Thumbstick (Hold)
|-
! scope="row" style="text-align:center;" |Sprint
|Left Shift
| colspan="3" |''−−''
|-
! scope="row" style="text-align:center;" |Use / Interact
|E
|Trigger / Index finger pull
| rowspan="2" |Trigger
| rowspan="2" | Tap
|-
! scope="row" style="text-align:center;" |Grab / Pick Up
|Left Mouse Button
|Grip / Middle finger pull
|-
! scope="row" style="text-align:center;" |Quick Menu
|Escape
|B / Y (either hand, top button)
| colspan="2" |Menu Button
|-
! scope="row" style="text-align:center;" | Action Menu
|R
|B / Y (Hold) (either hand, top button)
| Right Thumbstick (Press)
|Menu Button (Hold)
|-
! scope="row" style="text-align:center;" |Mute/Unmute
|V
|X (left hand, bottom button)
|Y
| Microphone Button
|}


== VR Controls ==
==Additional controls==
===VR controls===
VRChat officially supports the following headsets and their corresponding control schemes.
VRChat officially supports the following headsets and their corresponding control schemes.


*Meta Quest headsets
*Meta Quest headsets
**Meta Quest 2
**Meta Quest 2
**Meta Quest 3
**Meta Quest 3(S)
**Meta Quest Pro
**Meta Quest Pro
*HTC Vive XR Elite
* HTC Vive XR Elite
*Pico 4
*Pico 4


Line 22: Line 89:
**Bigscreen Beyond
**Bigscreen Beyond
**Tethered Pimax HMDs
**Tethered Pimax HMDs
**Any Steam Link compatible HMD (Meta Quest series)
**Any Steam Link-compatible HMD (Meta Quest series)
**Any Virtual Desktop compatible HMD
**Any Virtual Desktop-compatible HMD
**Most ALVR compatible HMDs
**Most ALVR-compatible HMDs


On PC, we also support gamepad input via Steam’s Input manager.
On PC, we also support gamepad input via Steam’s Input Manager.


=== Controller Buttons ===
====Controller buttons====
Most VR controllers are laid out similarly. Each controller has a joystick and two main buttons, a system button, a trigger, and a grip button.
Most VR controllers are laid out similarly. Each controller has a joystick and two main buttons, a system button, a trigger, and a grip button.
{| class="wikitable"
{| class="wikitable"
Line 38: Line 105:
|-
|-
|B - right hand, top button
|B - right hand, top button
|Press: Quick Menu Hold: Action Menu
| Press: Quick Menu Hold: Action Menu  
|-
|-
|X - left hand, button button
|X - left hand, button button
Line 44: Line 111:
|-
|-
|Y - left hand, top button
|Y - left hand, top button
|Press: Quick Menu Hold: Action Menu
| Press: Quick Menu Hold: Action Menu  
|-
|-
|Grip - Middle finger pull
|Grip - Middle finger pull
|Pick up  
 
|Pick up
|-
|-
|Trigger - Index finger pull
|Trigger - Index finger pull  
|Use
|Use
|-
|-
|Right Thumbstick
|Right Thumbstick
|Turn
| Turn
|-
|-
|Left Thumbstick
|Left Thumbstick
Line 59: Line 127:
|-
|-
|Both Triggers + Both Menu Buttons
|Both Triggers + Both Menu Buttons
|Enable Safe Mode
| Enable Safe Mode
|}
|}


=== Hand Tracking ===
====Hand tracking====
There is a {{VRC link|https://vrchat.com/home/world/wrld_8bcf07ab-5f8f-40cb-9289-b2eaad15ab98|tutorial world}} to learn hand tracking in a kinesthetic environment!
There is a {{VRC link|https://vrchat.com/home/world/wrld_8bcf07ab-5f8f-40cb-9289-b2eaad15ab98|tutorial world}} to learn hand tracking in a kinesthetic environment!


To use hand tracking, just put down your controllers and put your hands out so the Quest hand tracking system kicks in. Of course, make sure you have the system enabled in the Quest settings.
To use hand tracking, just put down your controllers and put your hands out so the Quest hand tracking system kicks in. Of course, make sure you have the system enabled in the Quest settings.


To move around the world, hold your left hand up, palm facing your face. Touch your middle finger to your thumb in a “pinch” motion, and a small blue sphere will appear. While still pinching, move your fingers away from that sphere, and you'll move in that direction!
To move around the [[Special:MyLanguage/Worlds|world]], hold your left hand up, palm facing your face. Touch your middle finger to your thumb in a “pinch” motion, and a small blue sphere will appear. While still pinching, move your fingers away from that sphere, and you'll move in that direction!


To turn left and right, do the same motion with your middle finger to your thumb, but with your right hand. While still pinching, move your fingers left or right. You'll turn!
To turn left and right, do the same motion with your middle finger to your thumb, but with your right hand. While still pinching, move your fingers left or right. You'll turn!
Line 77: Line 145:
You can mute yourself by holding your thumb and ring finger together for a moment on your left hand.
You can mute yourself by holding your thumb and ring finger together for a moment on your left hand.


==Desktop Controls==
===Desktop controls===
You can play VRChat using a keyboard and mouse.
You can play VRChat using a keyboard and mouse.


Movement is handled via the standard FPS “WASD” setup. Your mouse adjusts your view position. Your head points in the direction you’re looking.
Movement is handled via the standard FPS “WASD” setup. Your mouse adjusts your view position. Your head points in the direction you’re looking.
{| class="wikitable"
{| class="wikitable"
!Key
! Key
!What it does
!What it does  
|-
|-
|W
|W
|Moves player forward
| Moves user forward
|-
|-
|A
| A
|Moves player left
|Moves user left
|-
|-
|S
|S
|Moves player back
|Moves user back
|-
|-
|D
|D
|Moves player right
|Moves user right
|-
|-
|Space
|Space
|Makes player jump (if it is enabled in the room)
|Makes user jump (if it is enabled in the room)
|-
|-
|Z
|Z
Line 124: Line 192:
|Drop pickup
|Drop pickup
|-
|-
|Right Click + F (Hold)
| Right Click (Hold) (Pickups)
|Allows you to throw held pickups
|Allows you to throw held pickups. The longer you hold, the further the object goes.
|-
|-
|V (Hold) (If using push to talk)
| V (Hold) (If using push to talk)
|Enables microphone as long as it’s held
|Enables microphone as long as it’s held
|-
|-
|V (If using toggle talk)
| V (If using toggle talk)
|Enables / Disables microphone
|Enables / Disables microphone
|-
|-
Line 136: Line 204:
|Opens chatbox text input
|Opens chatbox text input
|-
|-
|End
|Tab (Hold)
|Allows you to move your mouse around the screen without moving your avatar. (Useful for clicking UI elements)
|-
| End
|Toggles AFK mode
|Toggles AFK mode
|-
|-
|Control + N
|Control + N
|Toggles visibility of player nametags
|Cycles through visibility options of [[Special:MyLanguage/Nameplates|nameplates]]
|-
|-
|Control + H
|Control + H
|Toggles visibility of the HUD (microphone and notification icons)
|Toggles visibility of the [[Special:MyLanguage/HUD|HUD]] (microphone and notification icons)
|-
|-
|Control + \
|Control + \
|Local switch to default robot avatar (good for when unable to access menu or see out of avatar)
|Local switch to default [[Special:MyLanguage/Robot|Robot]] [[Special:MyLanguage/avatar|avatar]] (good for when unable to access menu or see out of avatar)
|-
|-
|RShift + Backtick + 1 †
|RShift + Backtick + 1<sup></sup>
|Toggles visibility of trigger debug menu
|Toggles visibility of trigger debug menu
|-
|-
|RShift + Backtick + 2 †
|RShift + Backtick + 2<sup></sup>
|Toggles visibility of information debug menu
|Toggles visibility of information debug menu
|-
|-
|RShift + Backtick + 3 †
|RShift + Backtick + 3<sup></sup>
|Toggles visibility of console debug menu
|Toggles visibility of console debug menu
|-
|-
|RShift + Backtick + 4 †
|RShift + Backtick + 4<sup></sup>
|Toggles visibility of networking debug menu
|Toggles visibility of networking debug menu
|-
|-
|RShift + Backtick + 5 †
|RShift + Backtick + 5<sup></sup>
|Toggles visibility of networking graph debug menu
|Toggles visibility of networking graph debug menu
|-
|-
|RShift + Backtick + 7 †
|RShift + Backtick + 7<sup></sup>
|Toggles visibility of networking debug overlay
|Toggles visibility of networking debug overlay
|-
|-
|RShift + Backtick + 8 †
|RShift + Backtick + 8<sup></sup>
|Toggles visibility of event debug overlay
|Toggles visibility of event debug overlay
|-
|-
|RShift + Backtick + 9 †
|RShift + Backtick + 9<sup></sup>
|Toggles visibility of user networking debug overlay
|Toggles visibility of user networking debug overlay
|-
|-
Line 187: Line 258:
|Hand gesture - Open Hand
|Hand gesture - Open Hand
|-
|-
|Shift + F4*
|Shift + F4*  
|Hand gesture - Point
|Hand gesture - Point
|-
|-
Line 200: Line 271:
|-
|-
|Shift + F8*
|Shift + F8*
|Hand gesture - Thumbs up  
|Hand gesture - Thumbs up
|-
|-
|Shift + F11*
|Shift + F11*
Line 206: Line 277:
|-
|-
|< and >
|< and >
|Rotate the player left and right in.
|Rotate the user left and right in.  
|-
|-
|I / K
|I / K
|Adjusts pitch of the held object (rotate along X axis)
| Adjusts pitch of the held object (rotate along X axis)
|-
|-
|J / L
|J / L
|Adjusts yaw of the held object (rotate along Y axis)
|Adjusts yaw of the held object (rotate along Y axis)
|-
|-
|U / O
| U / O
|Adjusts roll of the held object (rotate along Z axis)
|Adjusts roll of the held object (rotate along Z axis)
|-
|-
Line 226: Line 298:
<nowiki>*</nowiki> Use left shift to control your left hand, use right shift to control your right hand.
<nowiki>*</nowiki> Use left shift to control your left hand, use right shift to control your right hand.


† On a standard English US QWERTY layout keyboard, “backtick” is the key in the top left, next to the <code>1</code> key. It shares a key with the tilde (<code>~</code>) character.
<sup></sup> On a standard English US QWERTY layout keyboard, “backtick” is the key in the top left, next to the <code>1</code> key. It shares a key with the tilde (<code>~</code>) character.


Debug options are disabled unless you launch VRChat with the <code>--enable-debug-gui</code> launch option.
Debug options are disabled unless you launch VRChat with the <code>--enable-debug-gui</code> launch option.


==Mobile Controls==
===Mobile controls===
On the left side of the screen is a virtual joystick, which will move your avatar around. Tapping and dragging on the screen will move your point of view. Double tapping and holding anywhere on the screen will let you walk around and move your viewpoint simultaneously.
On the left side of the screen is a virtual joystick, which will move your avatar around. Tapping and dragging on the screen will move your point of view. Double tapping and holding anywhere on the screen will let you walk around and move your viewpoint simultaneously.


The right side of the screen has buttons for jumping, picking up items, and interacting with the world. Holding down the button will allow for further options, such as an action menu, or crouching.
The right side of the screen has buttons for jumping, picking up items, and interacting with the world. Holding down the button will allow for further options, such as an action menu, or crouching.


Tapping on a player or a portal will instantly bring up a secondary [[Menus|menu]].
Tapping on another user or a [[Special:MyLanguage/portals|portal]] will instantly bring up a secondary [[Special:MyLanguage/Menus|menu]].


== Gamepad Controls ==
===Gamepad controls ===
You can play VRChat using a gamepad on PC and Mobile.
You can play VRChat using a gamepad on PC and Mobile.


Typical controllers supported include Xbox controllers, Playstation controllers, and Nintendo Switch controllers.
Typical controllers supported include Xbox controllers, PlayStation controllers, and Nintendo Switch controllers. The below table uses the "Xbox" controller layout for reference.
{| class="wikitable"
{| class="wikitable"
!Buttons (Based on Xbox Controller)
!Buttons (Based on Xbox Controller)  
!Assignment
!Assignment
|-
|-
|A
|A
|Makes player jump (if it is enabled in the room)
|Makes user jump (if it is enabled in the room)
|-
|-
|B / X
| B / X
|Drop pickup
|Drop pickup
|-
|-
Line 257: Line 329:
|Enables / Disables microphone
|Enables / Disables microphone
|-
|-
|D-pad Up  
|D-pad Up
|Toggles visibility of player nametags
|Toggles visibility of user nametags
|-
|-
|D-pad Down
|D-pad Down
Line 270: Line 342:
|-
|-
|RB (Hold) + Left Joystick
|RB (Hold) + Left Joystick
|Select left hand gesture (Only Available on Steam)
 
|Select left hand gesture (Only Available on Steam)  
|-
|-
|RB (Hold) + Right Joystick
|RB (Hold) + Right Joystick
Line 279: Line 352:
|-
|-
|Left Joystick
|Left Joystick
|Moves player
|Moves user
|-
|-
|Left Joystick Click
|Left Joystick Click
Line 303: Line 376:
|-
|-
|B (In Menu)
|B (In Menu)
|Closes Menu
|Closes Menu  
|}
|}


=== VRChat camera ===
VRChat camera allows users to take photos to capture their experiences in VRChat. For more information about controlling the camera, please view the [[Special:MyLanguage/Camera|Camera]] article.


TODO: short info about the camera here. ~DAG-XR 2024/06/03 03:55 UTC
==Resources==
*[https://www.youtube.com/watch?v=F0I2Ec4JsrE "Quest 2 Finger Tracking"] by VRChat on ''YouTube''
*[https://docs.vrchat.com/docs/vrchat-202241 "VRChat 2022.4.1"] on Hand Tracking
{{Start-navbox}}


== Resources ==
[[Category:Needs images]]
*[https://www.youtube.com/watch?v=F0I2Ec4JsrE "Quest 2 Finger Tracking" by VRChat on YouTube]
*[https://docs.vrchat.com/docs/vrchat-202241 "VRChat 2022.4.1" on Hand Tracking at docs.vrchat.com]
 
{{Start-navbox}}

Latest revision as of 03:09, 2 October 2024

VRLogo.png
V · EThis is an official VRChat information page!
It is written and maintained by VRCWiki Team.

Controls are arrays of inputs on controllers and devices to navigate VRChat. VRChat supports several operating systems, with multiple combinations of devices and controllers. Some of these controls can be configured in the Settings Menu. Depending on the platform you are using VRChat on, you may be able to customize controls further by using the Settings menu in VRChat, or your device's dashboard.

The Settings Menu within VRChat details the button mappings for the device you’re currently using. Below are the default configurations:

Primary controls

These are the basic controls for navigating and interacting within VRChat that apply to the different input types:

Action Keyboard/Mouse VR Controller Gamepad (Xbox) Mobile
Move WASD Left Thumbstick Virtual Thumbstick
Turn Mouse Move Right Thumbstick Hold and drag screen
Jump Space A (right hand, bottom button) A Jump Button
Crouch C −− Left Thumbstick (Click) Jump Button (Hold)
Prone / Crawl Z Left Thumbstick (Hold)
Sprint Left Shift −−
Use / Interact E Trigger / Index finger pull Trigger Tap
Grab / Pick Up Left Mouse Button Grip / Middle finger pull
Quick Menu Escape B / Y (either hand, top button) Menu Button
Action Menu R B / Y (Hold) (either hand, top button) Right Thumbstick (Press) Menu Button (Hold)
Mute/Unmute V X (left hand, bottom button) Y Microphone Button

Additional controls

VR controls

VRChat officially supports the following headsets and their corresponding control schemes.

  • Meta Quest headsets
    • Meta Quest 2
    • Meta Quest 3(S)
    • Meta Quest Pro
  • HTC Vive XR Elite
  • Pico 4

In addition, VRChat supports these headsets in PCVR mode, where your headset is connected to a Windows gaming PC.

  • All SteamVR-compatible headsets, including (but not limited to)
    • Valve Index
    • HTC Vive series
    • Bigscreen Beyond
    • Tethered Pimax HMDs
    • Any Steam Link-compatible HMD (Meta Quest series)
    • Any Virtual Desktop-compatible HMD
    • Most ALVR-compatible HMDs

On PC, we also support gamepad input via Steam’s Input Manager.

Controller buttons

Most VR controllers are laid out similarly. Each controller has a joystick and two main buttons, a system button, a trigger, and a grip button.

Button Assignment
A - right hand, bottom button Jump
B - right hand, top button Press: Quick Menu Hold: Action Menu
X - left hand, button button Press: Mute/Unmute
Y - left hand, top button Press: Quick Menu Hold: Action Menu
Grip - Middle finger pull Pick up
Trigger - Index finger pull Use
Right Thumbstick Turn
Left Thumbstick Move / Locomote
Both Triggers + Both Menu Buttons Enable Safe Mode

Hand tracking

There is a Official VRChat source tutorial world to learn hand tracking in a kinesthetic environment!

To use hand tracking, just put down your controllers and put your hands out so the Quest hand tracking system kicks in. Of course, make sure you have the system enabled in the Quest settings.

To move around the world, hold your left hand up, palm facing your face. Touch your middle finger to your thumb in a “pinch” motion, and a small blue sphere will appear. While still pinching, move your fingers away from that sphere, and you'll move in that direction!

To turn left and right, do the same motion with your middle finger to your thumb, but with your right hand. While still pinching, move your fingers left or right. You'll turn!

You can turn with Comfort Turning (snap turning) on or off. If you have Comfort Turning on, you'll need to move your pinched finger “past” the turn point each time you turn. It might be easier to use this locomotion method with Comfort Turning disabled in your settings.

Pull up your VRChat Quick Menu by “pinching” your index finger and your thumb on your left hand. This is a “default” Oculus gesture, you'll see a little menu icon float over your hand and “fill up” as you long-pinch. To interact with the UI, point at it with your hand, and select things by pinching your index and thumb together.

You can mute yourself by holding your thumb and ring finger together for a moment on your left hand.

Desktop controls

You can play VRChat using a keyboard and mouse.

Movement is handled via the standard FPS “WASD” setup. Your mouse adjusts your view position. Your head points in the direction you’re looking.

Key What it does
W Moves user forward
A Moves user left
S Moves user back
D Moves user right
Space Makes user jump (if it is enabled in the room)
Z Crawl/Go Prone
C Crouch
R Opens Action Menu
Escape Opens Quick Menu
Shift Sprint
Left Click Interact / Pickup
Right Click (Hold) Shows interaction mouse
Right Click Drop pickup
Right Click (Hold) (Pickups) Allows you to throw held pickups. The longer you hold, the further the object goes.
V (Hold) (If using push to talk) Enables microphone as long as it’s held
V (If using toggle talk) Enables / Disables microphone
Y Opens chatbox text input
Tab (Hold) Allows you to move your mouse around the screen without moving your avatar. (Useful for clicking UI elements)
End Toggles AFK mode
Control + N Cycles through visibility options of nameplates
Control + H Toggles visibility of the HUD (microphone and notification icons)
Control + \ Local switch to default Robot avatar (good for when unable to access menu or see out of avatar)
RShift + Backtick + 1 Toggles visibility of trigger debug menu
RShift + Backtick + 2 Toggles visibility of information debug menu
RShift + Backtick + 3 Toggles visibility of console debug menu
RShift + Backtick + 4 Toggles visibility of networking debug menu
RShift + Backtick + 5 Toggles visibility of networking graph debug menu
RShift + Backtick + 7 Toggles visibility of networking debug overlay
RShift + Backtick + 8 Toggles visibility of event debug overlay
RShift + Backtick + 9 Toggles visibility of user networking debug overlay
F12 Takes screenshot, saved to the folder VRChat is installed
Control + F12 Takes screenshot at double the normal resolution, by default 4K (3840 × 2160), saved to the User’s Pictures/VRChat folder
Shift + F1* Hand gesture - Idle
Shift + F2* Hand gesture - Fist
Shift + F3* Hand gesture - Open Hand
Shift + F4* Hand gesture - Point
Shift + F5* Hand gesture - Victory (Peace)
Shift + F6* Hand gesture - Rock ’n Roll
Shift + F7* Hand gesture - Finger-gun
Shift + F8* Hand gesture - Thumbs up
Shift + F11* Enables Safe Mode.
< and > Rotate the user left and right in.
I / K Adjusts pitch of the held object (rotate along X axis)
J / L Adjusts yaw of the held object (rotate along Y axis)
U / O Adjusts roll of the held object (rotate along Z axis)
Mouse Wheel Moves the held object forward/back (translate along Z axis)
Middle Mouse Button (Hold) Adjusts object rotation by moving the mouse

* Use left shift to control your left hand, use right shift to control your right hand.

On a standard English US QWERTY layout keyboard, “backtick” is the key in the top left, next to the 1 key. It shares a key with the tilde (~) character.

Debug options are disabled unless you launch VRChat with the --enable-debug-gui launch option.

Mobile controls

On the left side of the screen is a virtual joystick, which will move your avatar around. Tapping and dragging on the screen will move your point of view. Double tapping and holding anywhere on the screen will let you walk around and move your viewpoint simultaneously.

The right side of the screen has buttons for jumping, picking up items, and interacting with the world. Holding down the button will allow for further options, such as an action menu, or crouching.

Tapping on another user or a portal will instantly bring up a secondary menu.

Gamepad controls

You can play VRChat using a gamepad on PC and Mobile.

Typical controllers supported include Xbox controllers, PlayStation controllers, and Nintendo Switch controllers. The below table uses the "Xbox" controller layout for reference.

Buttons (Based on Xbox Controller) Assignment
A Makes user jump (if it is enabled in the room)
B / X Drop pickup
Y (Hold) (If using push to talk) Enables microphone as long as it’s held
Y (If using toggle talk) Enables / Disables microphone
D-pad Up Toggles visibility of user nametags
D-pad Down Toggles visibility of the HUD (microphone and notification icons)
LB (Hold) + Left Joystick Moves the held object forward/back (translate along Z axis)
LB (Hold) + Right Joystick Rotates the held object
RB (Hold) + Left Joystick Select left hand gesture (Only Available on Steam)
RB (Hold) + Right Joystick Select right hand gesture (Only Available on Steam)
LT/RT Interact / Pickup
Left Joystick Moves user
Left Joystick Click Crouch
Left Joystick Hold Crawl/Go Prone
Right Joystick Looks around
Right Joystick Click Opens Action Menu
View Takes screenshot, saved to the folder VRChat is installed
Menu Opens Quick Menu
A / RT (In Menu) Click in Menu
B (In Menu) Closes Menu

VRChat camera

VRChat camera allows users to take photos to capture their experiences in VRChat. For more information about controlling the camera, please view the Camera article.

Resources

VRLogo.png
V · EGetting Started in VRChat
Getting StartedControlsSafetyVRChat+TroubleshootingResourcesFAQ