VRChat Wiki - User contributions [en]

Guides:SteamVR Bindings

2026-05-19T05:44:00Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: /* Restore posing with grip / Can't pickup Physbones */

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}SteamVR input is a universal keybind system for all [[Special:MyLanguage/Controls|controllers]] usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

* [https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>
* [https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
|Physbone Grab (Left/Right)
|Global
|When bound, Grab will no longer hold Physbones and this will instead.
|boolean
|optional
|-
|Physbone Freeze (Left/Right)
|Global
|When bound, Interact will no longer pose Physbones and this will instead.
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Drone
! colspan="3" |For the [[Camera Drone|VRC Camera Drone]]
|-
|Drone Left Joystick Control
|Drone
|
|vector2
|suggested
|-
|Drone Right Joystick Control
|Drone
|
|vector2
|suggested
|-
|Self-Leveling Modifier
|Drone
|
|boolean
|optional
|-
|Hold Altitude Modifier
|Drone
|
|boolean
|optional
|-
|Toggle First-Person View
|Drone
|
|boolean
|optional
|-
|Flip Drone
|Drone
|
|boolean
|optional
|-
|Take Picture
|Drone
|
|boolean
|optional
|-
|Cycle Flight Preset
|Drone
|
|boolean
|optional
|-
|Toggle Self-Leveling
|Drone
|
|boolean
|optional
|-
|Respawn Drone
|Drone
|
|boolean
|optional
|-
|Select Micro Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Cinematic Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Racing Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Freestyle Flight Preset
|Drone
|
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Actions usable by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |Use Gesture (UG)
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
First, ensure you selected the game or program you wish to edit the bindings of. To create a [[Guides:SteamVR Bindings#Glossary|chord]], select ''Chords'' --> ''Add Chord. S''elect additional input(s) from the dropdown that you would like. These inputs must register at the same time for the output to work. After, select your output you desire.

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>
==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu
</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
You're likely using an old Vive wand binding. You may reset your bindings to the default or manually add <code>Physbone Grab</code> and <code>Physbone Freeze</code> bindings. 

====Unwanted Action (Expression) Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

==== Stick drift mitigations====
If you're struggling with stick drift, adjusting the [[Guides:SteamVR Bindings#Deadzones|Deadzones]] of your joysticks may improve your experience.
<blockquote>
{| class="wikitable"
|+ Recommended Values<ref>[https://x.com/SalbugVR/status/1945611969718853905 https://twitter.com/SalbugVR/status/1945611969718853905]</ref>
|-
! Setting !! Value
|-
| DeadZone || 25
|-
| Max Zone || 90
|-
| Curve Exponent || 1.25
|}
</blockquote>

</blockquote>

===HP Reverb G2===
<blockquote>TODO: More controller types.</blockquote>

== See also ==

* [[Special:MyLanguage/Controls|Controls]]

==References==
<references />
[[Category:Guides]]

Guides:Contact Collision Tags

2025-10-28T18:17:04Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Expanding tag list

{{Noticebox/Community}}
{{Noticebox/wip|World dynamics are still in beta, things may change. Placeholder categories and tables. To be written and expanded soon. |ZenithVal}}

[https://creators.vrchat.com/avatars/avatar-dynamics/contacts/ VRChat Contact Senders & Receivers] can have custom tags. The VRCSDK comes with a [https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags built-in list] of tags and this page is a community driven expansion of them.
[[File:CollisionTags.png|none|thumb|Example usage of custom collision tags]]

==Naming Conventions==

* Use PascalCase
* Avoid spaces, use _ if needed
* Clarity is important but brevity is appreciated
* Avoid using abbreviations/acronyms unless they are widely accepted
* Avoid single letter tags

== Collision Tags ==
Broken down into general categories. Some of these will overlap with the [https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags built-in list.]<ref>https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags/</ref>

You may have up to # Tags on each Contact so using all applicable tags is usually good. (EG: Consumable and ConsumableFood together)

=== Combat ===
Tags used for combat systems, from melee to magic.
{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Damage
|Generic catch all for combat systems. Anything that should cause damage.
|Built-in
|-
|Weapon
|General tag for something usable as a weapon.
|Built-in
|-
|DamageSharp
|A specific variant of Damage for blunt weapons. (Club)
|Built-in
|-
|DamageBlunt
|A specific variant of Damage for sharp weapons. (Sword)
|Built-in
|-
|DamageMagic
|A specific variant of Damage for magic effects.
|
|-
|Shield
|General tag for something that can block/deny damage.
|Built-in
|-
|Armor
|Defense for melee or ranged. Could be literal armor or a force field
|
|-
|Projectile
|An object that moves through the air to deal damage, usually fired from a weapon.
|Built-in
|-
|Bullet
|A specific variant of a Projectile~ something fired from of a ranged weapon.
|
|-
|Laser
|A specific variant of a Projectile~ something fired from of a ranged weapon.
|
|-
|Ammunition
|An object treatable as ammunition for a ranged weapon.
|Built-in
|-
|____________________
|_______________________________________________________________________________________
|______________________________
|}

=== Properties ===
Tags describing elements, physical properties, surface conditions, or forces.

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Hot
|A hot suface
|Built-in
|-
|Cold
|A cold surface
|Built-in
|-
|Fire
|Flames or an object on fire
|Built-in
|-
|Igniter
|Something to light flames. Sparks/Striker
|
|-
|Freezer
|Something that can freeze other things
|Built-in
|-
|Electricity
|Zap! A source for electricity to flow from
|
|-
|Conductor
|Something for electricity to react to/flow into
|
|-
|Wet
|Water or a wet surface
|Built-in
|-
|Water
|Liquid water
|Built-in
|-
|Wind
|An area that's applying wind forces
|Built-in
|-
|____________________
|_______________________________________________________________________________________
|______________________________
|}

=== Interactions ===
Tags used for niche or social interactions

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Cheers
|A glass or can? For drink-clinky stuff!
|
|-
|Consumable
|Consumables of any kind.
|Built-in
|-
|ConsumableFood
|Solid edible consumable
|Built-in
|-
|ConsumableDrink
|Liquid edible consumable
|Built-in
|-
|Edible
|For any consumable
|
|-
|Brush
|A brush that could affect hair, fur, ect
|Built-in
|-
|Dye
|An object that could change the color of another
|Built-in
|-
|DyeColor
|DyeRed, DyeBlue, ect. Specific dye colors.
|
|-
|
|
|
|-
|____________________
|_______________________________________________________________________________________
|______________________________
|}

=== Placeholder ===
Lorum Ipsum

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|
|
|
|-
|
|
|
|-
|
|
|
|-
|
|
|
|-
|____________________
|_______________________________________________________________________________________
|______________________________
|}

=== Specific Community Niche ===
These tags may violate naming conventions but are prevalent enough already to warrant mentioning.

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Parry_Detect
|For weapon clashes in melee combat systems.
|From LiindyVR.
|-
|Blunt
|A specific variant of Damage for blunt weapons. (Club)
|From before built in tags
|-
|Sharp
|A specific variant of Damage for sharp weapons. (Sword)
|From before built in tags
|-
|Magic
|A specific variant of Damage for magic effects.
|From before built in tags
|-
|____________________
|_______________________________________________________________________________________
|______________________________
|}
<references />

Guides talk:Contact Collision Tags

2025-10-28T17:52:51Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: /* Tag Suggestions */ new section

== Tag Suggestions ==

For discussion of possible tags to expand the list with. [[User:Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1|Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1]] ([[User talk:Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1|talk]]) 17:52, 28 October 2025 (UTC)

Guides:Contact Collision Tags

2025-10-27T20:51:30Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Expanding tags list

{{Noticebox/Community}}
{{Noticebox/wip|World dynamics are still in beta, things may change. Placeholder categories and tables. To be written and expanded soon. |ZenithVal}}

[https://creators.vrchat.com/avatars/avatar-dynamics/contacts/ VRChat Contact Senders & Receivers] can have custom tags. The VRCSDK comes with a [https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags built-in list] of tags and this page is a community driven expansion of them.
[[File:CollisionTags.png|none|thumb|Example usage of custom collision tags]]

==Naming Conventions==

* Use PascalCase
* Avoid spaces, use _ if needed
* Clarity is important but brevity is appreciated
* Avoid using abbreviations/acronyms unless they are widely accepted
* Avoid single letter tags

== Collision Tags ==
Broken down into general categories. Some of these will overlap with the [https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags built-in list.]<ref>https://vrc-beta-docs.netlify.app/common-components/contacts/built-in-contact-tags/</ref>

=== Combat ===
Tags used for combat systems, from melee to magic.
{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Damage
|
|Built-in
|-
|Weapon
|General tag for something usable as a weapon.
|Built-in
|-
|DamageSharp
|A specific variant of Damage for blunt weapons. (Club)
|Built-in
|-
|DamageBlunt
|A specific variant of Damage for sharp weapons. (Sword)
|Built-in
|-
|DamageMagic
|A specific variant of Damage for magic effects.
|
|-
|Shield
|General tag for something that can block/deny damage.
|Built-in
|-
|Armor
|
|
|-
|Projectile
|An object that moves through the air to deal damage, usually fired from a weapon.
|Built-in
|-
|Bullet
|A specific variant of a Projectile~ something fired from of a ranged weapon.
|
|-
|Laser
|A specific variant of a Projectile~ something fired from of a ranged weapon.
|
|-
|Ammunition
|An object treatable as ammunition for a ranged weapon.
|Built-in
|-
|____________________
|______________________________________________________________
|______________________________
|}

=== Elements ===
Tags describing surfaces

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Hot
|A hot suface
|Built-in
|-
|Cold
|A cold surface
|Built-in
|-
|Fire
|Flames or an object on fire
|Built-in
|-
|Igniter
|Something to light flames. Sparks/Striker
|
|-
|Freezer
|Something that can freeze other things
|Built-in
|-
|Electricity
|Zap! A source for electricity to flow from
|
|-
|Conductor
|Something for electricity to react to
|
|-
|Wet
|Water or a wet surface
|Built-in
|-
|Water
|Liquid water
|Built-in
|-
|Wind
|An area that's applying wind forces
|Built-in
|-
|____________________
|______________________________________________________________
|______________________________
|}

=== Interactions ===
Tags used purely for niche interactions

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Cheers
|A glass or can? For drink-clinky stuff!
|
|-
|Consumable
|
|Built-in
|-
|ConsumableFood
|
|Built-in
|-
|ConsumableDrink
|
|Built-in
|-
|Edible
|Food
|
|-
|Brush
|A brush that could affect hair, fur, ect
|Built-in
|-
|Dye
|An object that could change the color of another
|Built-in
|-
|DyeColor
|DyeRed, DyeBlue, ect. Specific dye colors.
|
|-
|
|
|
|-
|____________________
|______________________________________________________________
|______________________________
|}

=== Placeholder ===
Lorum Ipsum

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|
|
|
|-
|
|
|
|-
|
|
|
|-
|
|
|
|-
|____________________
|______________________________________________________________
|______________________________
|}

=== Specific Community Niche ===
These tags may violate naming conventions but are prevalent enough already to warrant mentioning.

{| class="wikitable sortable"
!Tag
!Description
!Other Notes
|-
|Parry_Detect
|For weapon clashes in melee combat systems.
|From LiindyVR.
|-
|
|
|
|-
|____________________
|______________________________________________________________
|______________________________
|}
<references />

Guides:Contact Collision Tags

2025-10-22T11:59:07Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Initial page layout & setup

{{Noticebox/Community}}
{{Noticebox/wip|Placeholder categories and tables. To be written and expanded soon.|ZenithVal}}

[https://creators.vrchat.com/avatars/avatar-dynamics/contacts/ VRChat Contact Senders & Receivers] can have custom tags. This page is a community driven effort for standardization.
[[File:CollisionTags.png|none|thumb|Example usage of custom collision tags]]

==Naming Conventions==

* Use PascalCase
* Avoid spaces, use _ if needed
* Clarity is important but brevity is appreciated
* Avoid using abbreviations/acronyms unless they are widely accepted
* Avoid single letter tags

== Collision Tags ==

=== Combat ===
Tags used for combat systems, from melee to magic.
{| class="wikitable sortable"
!Tag
!Description
!Reccomendations
|-
|
|
|
|-
|
|
|
|-
|
|
|
|}

=== Category Title ===
Tags describing surfacess

{| class="wikitable sortable"
!Tag
!Description
!Reccomendations
|-
|
|
|
|-
|
|
|
|-
|
|
|
|}

=== Category Title ===
Lorum Ipsum

{| class="wikitable sortable"
!Tag
!Description
!Reccomendations
|-
|
|
|
|-
|
|
|
|-
|
|
|
|}

=== Category Title ===
Tags used purely for niche interactions

{| class="wikitable sortable"
!Tag
!Description
!Reccomendations
|-
|
|
|
|-
|
|
|
|-
|
|
|
|}

=== Specific Community Niche ===
These tags may violate naming conventions but are prevalent enough already to warrant mentioning.

{| class="wikitable sortable"
!Tag
!Description
!Reccomendations
|-
|
|
|
|-
|
|
|
|-
|
|
|
|}

File:CollisionTags.png

2025-10-22T11:58:23Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Example usage of custom Collision Tags

Guides:SteamVR Bindings

2025-07-22T02:00:54Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Info on Grab/Freeze Bindings added in 1674. (Also some housekeeping)

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
|Physbone Grab (Left/Right)
|Global
|When bound, Grab will no longer hold Physbones and this will instead.
|boolean
|optional
|-
|Physbone Freeze (Left/Right)
|Global
|When bound, Interact will no longer pose Physbones and this will instead.
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Drone
! colspan="3" |For the [[Camera Drone|VRC Camera Drone]]
|-
|Drone Left Joystick Control
|Drone
|
|vector2
|suggested
|-
|Drone Right Joystick Control
|Drone
|
|vector2
|suggested
|-
|Self-Leveling Modifier
|Drone
|
|boolean
|optional
|-
|Hold Altitude Modifier
|Drone
|
|boolean
|optional
|-
|Toggle First-Person View
|Drone
|
|boolean
|optional
|-
|Flip Drone
|Drone
|
|boolean
|optional
|-
|Take Picture
|Drone
|
|boolean
|optional
|-
|Cycle Flight Preset
|Drone
|
|boolean
|optional
|-
|Toggle Self-Leveling
|Drone
|
|boolean
|optional
|-
|Respawn Drone
|Drone
|
|boolean
|optional
|-
|Select Micro Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Cinematic Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Racing Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Freestyle Flight Preset
|Drone
|
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Actions usable by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |Use Gesture (UG)
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu
</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities. You may be dropping Physbones at the moment because fully pulling the trigger activates the <code>interact</code> action, posing the physbone (or dropping it if posing is disabled)
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>(Fixed in Open beta 1647, remove above content when it moves live)

You're likely using an old Vive wand binding. You may reset your bindings to the default or manually add <code>Physbone Grab</code> and <code>Physbone Freeze</code> bindings.

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

==== Stick drift mitigations====
If you're struggling with stick drift, adjusting the [[Guides:SteamVR Bindings#Deadzones|Deadzones]] of your joysticks may improve your experience.
<blockquote>
{| class="wikitable"
|+ Recommended Values<ref>[https://x.com/SalbugVR/status/1945611969718853905 https://twitter.com/SalbugVR/status/1945611969718853905]</ref>
|-
! Setting !! Value
|-
| DeadZone || 25
|-
| Max Zone || 90
|-
| Curve Exponent || 1.25
|}
</blockquote>

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2025-04-01T20:40:18Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Drone Action typos fix.

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Drone
! colspan="3" |For the [[Camera Drone|VRC Camera Drone]]
|-
|Drone Left Joystick Control
|Drone
|
|vector2
|suggested
|-
|Drone Right Joystick Control
|Drone
|
|vector2
|suggested
|-
|Self-Leveling Modifier
|Drone
|
|boolean
|optional
|-
|Hold Altitude Modifier
|Drone
|
|boolean
|optional
|-
|Toggle First-Person View
|Drone
|
|boolean
|optional
|-
|Flip Drone
|Drone
|
|boolean
|optional
|-
|Take Picture
|Drone
|
|boolean
|optional
|-
|Cycle Flight Preset
|Drone
|
|boolean
|optional
|-
|Toggle Self-Leveling
|Drone
|
|boolean
|optional
|-
|Respawn Drone
|Drone
|
|boolean
|optional
|-
|Select Micro Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Cinematic Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Racing Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Freestyle Flight Preset
|Drone
|
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Actions usable by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |Use Gesture (UG)
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities. You may be dropping Physbones at the moment because fully pulling the trigger activates the <code>interact</code> action, posing the physbone (or dropping it if posing is disabled)
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2025-04-01T20:38:01Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Updated Camera Drone Actions

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Drone
! colspan="3" |For the [[Camera Drone|VRC Camera Drone]]
|-
|Drone Left Joystick Control
|Drone
|
|vector2
|suggested
|-
|Drone Right Joystick Control
|Drone
|
|vector2
|suggested
|-
|Self-Leveling Modifier
|Drone
|
|boolean
|optional
|-
|Hold Altitude Modifier
|Drone
|
|boolean
|optional
|-
|Toggle First-Person View"
|Drone
|
|boolean
|optional
|-
|Flip Drone
|Drone
|
|boolean
|optional
|-
|Take Picture
|Drone
|
|boolean
|optional
|-
|Cycle Flight Preset
|Drone
|
|boolean
|optional
|-
|Toggle Self-Leveling"
|Drone
|
|boolean
|optional
|-
|Respawn Drone
|Drone
|
|boolean
|optional
|-
|Select Micro Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Cinematic Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Racing Flight Preset
|Drone
|
|boolean
|optional
|-
|Select Freestyle Flight Preset
|Drone
|
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Actions usable by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |Use Gesture (UG)
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities. You may be dropping Physbones at the moment because fully pulling the trigger activates the <code>interact</code> action, posing the physbone (or dropping it if posing is disabled)
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2025-03-13T02:09:42Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Added VRC Camera Drone Actions

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Drone 
! colspan="3" |For the [[Camera Drone|VRC Camera Drone]]
|-
|Left_Joystick
|Drone
|
|
|suggested
|-
|Right_Joystick
|Drone
|
|
|suggested
|-
|Flight_Mode
|Drone
|
|
|
|-
|Hold_Altitude
|Drone
|
|
|
|-
|Toggle_FPV
|Drone
|
|
|
|-
|Flip
|Drone
|
|
|
|-
|Take_Picture
|Drone
|
|
|
|-
|Toggle_UI_Visibility
|Drone
|
|
|
|-
|Toggle_Audio_Modes
|Drone
|
|
|
|-
|Cycle_Flight_Preset
|Drone
|
|
|
|-
|Toggle_Self_Leveling
|Drone
|
|
|
|-
|Respawn
|Drone
|
|
|
|-
! colspan="2" |Udon
! colspan="3" |Actions usable by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |Use Gesture (UG)
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities. You may be dropping Physbones at the moment because fully pulling the trigger activates the <code>interact</code> action, posing the physbone (or dropping it if posing is disabled)
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-12-10T15:03:37Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Notes about Vive Physbone posing adjusted. (& Canny corrected)

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Restore posing with grip / Can't pickup Physbones====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities. You may be dropping Physbones at the moment because fully pulling the trigger activates the <code>interact</code> action, posing the physbone (or dropping it if posing is disabled)
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Inventory

2024-12-06T05:27:39Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Prints no longer beta content as of 1552

{{Stub}}

The '''Gallery''' is a feature that allows users to save, organize, and share photos, as well as icons, custom emojis and stickers in VRChat. The gallery currently includes four tabs: '''icons''', '''photos''', '''emojis''', and '''stickers'''. It was initially introduced as a [[VRChat+]] exclusive feature on December 3rd, 2020<ref>[https://medium.com/vrchat/vrchat-plus-is-now-live-c8efdf796f2d VRChat Plus is now Live!] on Medium on December 3rd, 2020; retrieved November 14, 2024.</ref><ref>[https://www.youtube.com/watch?v=kc_1IBX8bUw VRChat Plus Early Supporter Launch] on YouTube on December 3rd, 2020; retrieved November 14, 2024</ref>.

==Icons==
[[File:VRChat_Plus_Icons.webp|thumb|right|Icons can be displayed on a user's nameplate if they have access to the gallery.]]'''Icons''' are custom images used as a user's icon on their in-game [[Nameplates|nameplate]]. The Icon feature is available exclusively to active VRChat+ subscribers. When [[Streamer Mode]] is enabled, all other user's icons will be hidden.

Icons can be taken and added to your gallery, by either taking a photo with the [[Camera|camera]], or by manually uploading a picture by logging into your account on [https://vrchat.com/home/gallery/icons| VRChat's website], clicking the Gallery tab, then going to Icons. Manually uploaded icons must be less than 10MB, larger than 64x64 pixels, and smaller than 2048x2048 pixels.
==Photos==
[[File:Gallery_Photos.webp|thumb]]'''Photos''' in this tab can serve multiple purposes, such as an additional profile picture option on a user's profile. They can also be used when sending invites to other users. Photographs can also be used to change the banner for a [[Group|group]], and add to the group's gallery.

Like icons, photos can be taken and added to your gallery, by either taking a photo with the camera, or by manually uploading a picture by logging into your account on [https://vrchat.com/home/gallery/photos| VRChat's website], clicking the Gallery tab, then going to Photos. Manually uploaded photos must be less than 10MB, larger than 64x64 pixels, and smaller than 2048x2048 pixels.

In addition, users who have access to a gallery can share their photos with everyone in the instance using a [[Sharing|sharing]] pedestal. Users can also copy the photograph to their gallery as long as the recipient also has an active VRChat+ subscription.
==Emojis==
[[File:Gallery_Emoji.webp|thumb]]'''Emojis''' in VRChat are custom, user-uploadable emoji. Custom emoji was announced in the June 15, 2023 Developer Update<ref>[https://ask.vrchat.com/t/developer-update-15-june-2023 Developer Update - 15 June 2023] on ask.vrchat.com; retrieved November 14, 2024.</ref>, and then released on June 29, 2023<ref>[https://ask.vrchat.com/t/developer-update-29-june-2023 Developer Update - 29 June 2023] on ask.vrchat.com; retrieved November 14, 2024.</ref> Users with an active VRC+ subscriptions can upload up to nine custom emojis, including the option to create animated emojis using spritesheets. When creating an emoji, you can choose one of several animations.

Like icons and photos, emojis can be taken and added to your gallery, by either taking a photo with the camera, or by manually uploading an emoji by logging into your account on [https://vrchat.com/home/gallery/emoji| VRChat's website], clicking the Gallery tab, then going to Emoji. Manually uploaded emojis must be less than 10MB, larger than 64x64 pixels, and smaller than 1024x1024 pixels.

In addition, users who have access to a gallery can share their emojis with everyone in the instance using a [[Sharing|sharing]] pedestal. Users can also copy the emoji to their gallery as long as the recipient also has an active VRChat+ subscription.

===Animations===
When uploading an emoji, you have to select an animation that fits the emoji.

Fifteen of the animation names are tied to a pre-existing default emoji animations. For example, any emoji using the "Mistletoe" animation will share the same type of animation as the Mistletoe in the Winter page of the Default Emoji pack. However, there are twelve unique animations also added to the emoji creator.

The types of animations to choose from are as follows:
{| class="wikitable"
|Aura
|Bats
|Bees
|-
|Bounce
|Cloud
|Confetti
|-
|Crying
|Dislike
|Fire
|-
|Idea
|Lasers
|Like
|-
|Magnet
|Mistletoe
|Money
|-
|Noise
|Orbit
|Pizza
|-
|Rain
|Rotate
|Shake
|-
|Snow
|Snowball
|Spin
|-
|Splash
|Stop
|ZZZ
|}

===Animated Emoji===
[[File:DancingBirdSprite.png|thumb|right|An example of a sprite sheet for a 10-frame animated emoji.]]
'''Animated emoji''' were introduced later, announced<ref>[https://ask.vrchat.com/t/developer-update-11-april-2024/ Developer Update - 11 April 2024] on ask.vrchat.com; retrieved November 14, 2024.</ref> and released on [[Open Beta]] on April 11, 2024; the feature was fully released in the 2024.2.1<ref>[https://docs.vrchat.com/docs/202421 VRChat 2024.2.1] on docs.vrchat.com; retrieved November 14, 2024.</ref> update on April 24th.

Emojis can also contain a moving picture, similar to that of a GIF. This is possible by uploading your emoji as a sprite sheet, which should be a 1024x1024 image with square frames in a uniform grid, ordered left to right, then top to bottom. You can preset animation values in advance using the file name, like so: CoolEmoji_14frames_10fps.png. In addition, you can have your animated emoji use one of the above animations listed above.

==Stickers==
[[File:Gallery_Sticker.webp|thumb]]'''Stickers''' are placeable images that users can upload and display an instance. Stickers can be placed on almost any surface in a world for all users in the instance to see. Only one sticker may be placed by each user at a time, and stickers will automatically disappear when the user leaves the instance. Stickers can be hidden by selecting them, and blocking a user will also hide any stickers that they have placed. The Sticker feature is exclusive to active VRC+ subscribers.

Like icons, photos, and emojis, stickers can be taken and added to your gallery, by either taking a photo with the [[Camera|camera]], or by manually uploading a sticker by logging into your account on [https://vrchat.com/home/gallery/stickers| VRChat's website], clicking the Gallery tab, then going to Stickers. Manually uploaded photos must be less than 10MB, larger than 64x64 pixels, and smaller than 1024x1024 pixels.

In addition, users who have access to a gallery can share their stickers with everyone in the instance using a [[Sharing|sharing]] pedestal. Users can also copy the sticker to their gallery as long as the recipient also has an active VRChat+ subscription.
==Prints==
[[File:Gallery_Prints.webp|thumb]]
'''Prints''' are photos users can take within VRChat and spawn as an object in-world for other users to share and save. Prints carry metadata of: who took the photo, where, and when a photo was taken. They can also have custom messages written on them. Prints have the same appearance as real-world [[Wikipedia:Instant_film|instant films]]. All prints will always upload in 1080p resolution.
Users can "collect" prints by saving them to their gallery.

== See also ==

* [[VRChat+]]
* [[Camera]]

== References ==

[[Category:Features]]

Community:VRChat Performance Benchmarks

2024-12-06T05:24:44Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: VRC Constraints no longer beta content

{{Noticebox/Community}}

=Introduction=
This is a writeup on the performance (mostly focused on frame time) of components in VRChat.

The general methodology used to generate this data is to not look at the performance of a single instance of a Component, but to add more and more components and extract the formula for the performance from this data. For example: To know how much frame time it costs to have one extra layer on an FX controller, 1, 8, 64 and 256 layers are benchmarked, those times are plotted on a graph, a line is fit to this data, and the formula of this line is used to see how much frame time a single extra layer costs.

The goal of this article is to display the performance of every single component that can be used in VRChat to give a rough estimate of how heavy they are to run compared to each other, to help the community choose more optimized methods of building avatars.

Throughout this article, the results are given in ms of frame time. To interpret this, one way to think about it is like this:

If the goal is to have 90 fps, you have approximately 11 ms (so 0.011 seconds) to render each frame. This is the frame time budget. Some of this time will be spent on PhysBones, some of it will be spent on Animators, some of it will be spent on Materials, etc. So if a component takes 1 ms, you can see this as taking about 9.1% of your “budget”.

Do note that this frame time is used for processing every single avatar and the world, so if something on a single avatar takes 9.1% of the total budget, that is quite a lot, and should probably be a point of optimization.

To have 60 fps, your frame time budget is approximately 16 ms. To have 40 fps, your frame time budget is 25 ms.

The graphs used in this document are generated on a computer with the following specs (though the numbers should mostly be used to compare to other components, so absolute numbers aren't as important):

CPU: AMD Ryzen 7 5800X
Memory: DDR4 2x16GB 3200 MHz CL18
GPU: NVIDIA GeForce RTX 4090

The data used throughout this page is generated using https://github.com/jellejurre/UnityBenchmark

=Animator Controllers=

To put the numbers in this section into perspective, here are two points of clarification:

* Every test here is done without any state behaviours. Having one or more state behaviours on any layer of any controller increases the runtime of all controllers on that avatar by 50%. This happens regardless which state behaviour you are using, and since there are state behaviours on the default Action & Gesture layer, this cost is probably incurred on every single avatar that gets used. Because this cost is always there, they are not included in the tests, since the tests are supposed to be comparative, but do note that if you’re looking at any of the raw numbers, a 50% should be added on top of them to get more accurate numbers.
* Animator controllers don’t scale linearly. This is elaborated upon later, but having two avatars with 100 layers is not as frame time heavy as having a single avatar with 200 layers. It is useful to optimize controllers, since less frametime is still a good thing, but this would explain absurdly high numbers (like the fact that if it scaled linearly, having 40 avatars with 50 layers would take 68 ms, but in reality it takes 6.4 ms).

First, single controller frame time performance will be discussed, and then how this scales with having multiple controllers.

==Single Controller Performance==

===Baseline: Two State Toggle===
For our baseline, we are going to look at the simple 2 state toggle.

[[File:Unity Benchmark Two State Toggle.png|none|frame|alt=An animator controller layer showing a toggle consisting of two states|The default toggle we will be comparing against. Two animations, each with two frames, both with the same value. Write defaults on.]]

In every layer count test, the graph for layers vs frame time is quadratic. this means that the more layers you have, the worse adding an extra layer becomes. However, the quadratic term isn’t very strong, so for low layer counts, it can be approximated by a linear graph. For the basic toggle, this will be 0.01 ms per layer. This is our baseline to compare against.

[[File:Unity Benchmark Two State Toggle Static Graph.png|none|frame|alt=The frame time to layer count graph for the basic toggle without being actively toggled. It shows about 12 ms per 700 layers|The frame time to layer count graph for the basic toggle without being actively toggled]]
If this same benchmark is ran again, but while actively animating the layers, this produces the following graph:

[[File:Unity Benchmark Two State Toggle Active Graph.png|none|frame|alt=The frame time to layer count graph for the basic toggle while being actively toggled. It shows about 15 ms per 700 layers|The frame time to layer count graph for the basic toggle while being actively toggled]]

This graph shows us that there is an approximately 20-30% higher cost for toggles that are constantly toggled, compared to ones that aren’t. This would be the case for face/eye tracking for example. This 20-30% higher cost seems to be consistent with all of the setups (AnyState, AnyState self transition, multiple animators, etc.), except for direct Blend Trees, where it depends on the setup.

===AnyState===
AnyState seems to be similar in performance to non-AnyState toggles, no matter the amount of AnyState toggles. This indicates the amount of transitions checks is not a significant contributing factor to frame time, which is confirmed by other tests.

The only notable exception here is an AnyState toggle with “Can Transition to Self” active, as this does incur a 20% penalty over non-can-transition-to-self, even with the active toggling comparison.

===Direct Blend Trees===
When the surprisingly large cost of layers was first discovered, people called for Direct Blend Trees as the one magical solution that would cut frame time by orders of magnitude. These results indicate that, while they don’t take zero time, they are an excellent tool in reducing frame time.

For a basic Direct Blend Tree setup, a single Direct Blend Tree is used with many 1D Blend Trees as children. All the children have weight one, but the 1D Blend Tree blend value would be the toggle parameter.

[[File:Unity_Benchmark_Two_State_Toggle_Static_Graph.png|frame|none|alt=Direct Blend Tree frame time without active toggling. It shows 4.5 ms for 700 toggles.|Direct Blend Tree frame time without active toggling]]

These results shown a 3/4ths cut to our frame time. Especially with large amounts of toggles, this can help a lot with performance.

To find out how to make one of these Blend Trees, the following article could be useful: [https://vrc.school/docs/Other/DBT-Combining/ VRC School's Direct Blend Trees Layer Combining Article].

===Miscellaneous Layer Information===
* State count per layer and transition count don’t seem to matter much (which might be why AnyState is so cheap)
* Using empty layers on humanoid rigs, using non-humanoid rigs and using no avatar all seem to cut frame time per layer by about 50% compared to the two state setup
* Masking seems to have little to no effect on frame time
* Using sub-state machines seems to have little to no effect on frame time
* Nesting blendtrees for clarity seems to have little to no effect on frame time
* For Direct Blend Trees, WD off seems to not change frame times by much
* For layer toggles, WD off seems to increase frame time by around 50%
* Parameters on the local avatar seem to cost 1.5 ms per 1000, but this cost doesn’t apply to remote avatars

==Multiple Controller Performance==

Having multiple controllers does not scale linearly (that is, having 2 controllers with 100 layers causes a lot less frame time than 1 controller with 200 layers).

The actual relationship is hard to describe, but here is a visual to maybe help with this. Where every line is a constant frame time. So for example 5 controllers with 580 layers are as laggy as 15 controllers with 300 layers.

[[File:Unity Benchmark Multiple Controllers Graph.png|frame|none|alt=Frame time for controllers vs layers per controller with WD on two toggle states without active toggling.|Frame time for controllers vs layers per controller with WD on two toggle states without active toggling.]]

Two observations can be taken from this graph:
* Big controllers cause a lot of frame time compared to many small ones. Optimization is especially necessary if you have many layers. (1 100 layer controller takes as much frame time as 10 30 layer controllers).
* Even with many controllers, if you halve the layer count on all of them, your total frame time still goes down by 50%. So if everyone optimized their layer count/layer setup, this would increase performance for everyone.

This relation seems the same for all controller types/layer configurations.

=Constraints=
Note: VRChat is adding a new component, VRCConstraint, that will replace constraints in VRChat. The section on these components is below this one.

Constraints' frame time behaves quite irregularly, but in a way that is understandable.

[[File:Unity Benchmark Constraints Graph.png|frame|none|alt=Frame time of constraints. It shows many jumps every few 100 constraints.|Frame time of constraints]]

If given the total amount of enabled constraints (type doesn’t matter), this graph can be used to get the frame time. You can see that there are slow inclines, with big jumps inbetween.

An approximation for their performance would be 3 ms per 1000 constraints, though this is assuming there aren't over 1250 constraints total enabled at the same time, since it goes up fast after that.

Disabled constraints do not count towards this total graph. Disabled here means either:
* GameObject is disabled
* Constraint component is disabled
* Constraint is set to “disabled”

However, setting the weight to 0 still makes it count for performance.

=VRC Constraints=
VRC Constraints are components added by VRChat that replace Unity Constraints in VRChat. They are meant to be more optimized and more feature complete versions of Unity Constraints, while still being a drop-in replacement. There is an auto conversion feature at the bottom of the VRCSDK.

Their frame time is a lot worse in the unity editor than in game, which is why there are no graphs shown, since they are generated in editor, but here is the relevant data:

* VRC Constraints cost about 0.25 ms of frame time per 1000 active VRC Constraints, no matter how many sources there are.
** Note that this number is at a depth of 1. At a depth of 20, it would be about 0.27 ms, and at a depth of 100 it would be 0.5 ms. Most people won’t have issues with depth getting this high, but be mindful that high depth can slow things down.
* Unity Constraints that are auto converted to VRC Constraints in game cost about 0.75 ms per 1000 active Constraints. This means they are still better than Unity Constraints without conversion, but converting to VRC Constraints in editor is worth it for the frame time improvement.

=Audio Sources=
Audio Sources don't have much of a performance impact at all, though the audio files themselves can cause a hitch when being loaded due to the file having to be decompressed. This is hard to measure and sadly no numbers on this are known at the time.

=Contact Senders/Receivers=
Contacts have a max limit of 4096 per instance. If you have more than 4096 contacts in one instance, the last enabled ones will stop working.

Contact senders and receivers are pretty straightforward, costing:

* 0.5 ms of frame time for every 1000 senders/receivers while they aren’t actively being toggled
* 0.75 ms of frame time for every 1000 receivers while they are actively being toggled

These values seems to be roughly the same no matter the shape, type, parameter count, and collision tags
caution

Do note that this isn’t factoring in the time of parameters on the local avatar. Parameters on the local avatar have an extra cost of 1.5 ms per 1000 parameters

=Cloth=
Cloth components are very heavy and should be used very sparingly.

For any reasonable amount of vertices (up to ~200k vertices), a cloth component will add around 0.2 ms per 1000 vertices. Above this, the frame time shoots up hard before tapering off.

[[File:Unity Benchmark Cloth Graph.png|frame|none|alt=Frame time of cloth with changing vertex count|Frame time of cloth with changing vertex count]]

Note that this 200k vertices limit is for the entire lobby. The amount of cloth components does not seem to matter for the lag, just the amount of cloth vertices.

Note that due to mirror and shadow clones, the local avatar’s cloth is simulated three times, and therefore its vertices should be counted thrice

Colliders will make a cloth component take about twice as much frame time per 10 colliders. So per collider, it will take about 7% more frame time.

=Physbones=
Physbones are quite well optimized, and within reason can be considered pretty cheap. It seems that the frame time of Physbones is mostly reliant on how many transforms they animate, at a rate of 0.66 ms per 1000 affected Physbone transforms.

The component hierarchy shape (what is parented to what) and amount of components seem to have a slight effect on this, giving me a 33% difference between extremes, where fewer components is better.

Collider count has a very slight impact on frame time, and the other settings seem to have no noticeable effect.

[[File:Unity Benchmarks Physbones Graph.png|frame|none|alt=Frame time of Physbone Transforms|Frame time of Physbone Transforms]]

=Skinned Mesh Renderers=
Skinned Mesh Renderers are quite the important topic for optimization, as material count and vertex count can be one of the most difficult things to optimize on an avatar. They are mostly reliant on the GPU, so it is important to mention that these results have been obtained on a RTX 4090, however the general trends have been verified on a RTX 3080 and a GTX 1080Ti.

Note: These benchmarks only look at frame time, not VRAM, which is another performance metric heavily affected by meshes and their properties (especially blendshapes).

==Materials==

A “Draw Call” is when your CPU tells your GPU to render a mesh. Every material gets seen as a separate mesh and therefore gets its own draw call. 1 mesh with 3 materials is 3 draw calls, and 3 meshes with 1 material is also 3 draw calls.

It is generally understood that more draw calls = more frame time, and these benchmarks seem to support this.

So, 100 skinned mesh renderers using 1 material have about equal frame time as 1 skinned mesh renderer with 100 materials.

As for concrete time numbers: 1000 draw calls seem to take about 2 ms.

[[File:Unity Benchmarks Skinned Mesh Renderer Material Count Graph.png|frame|none|alt=Frame times of Material Count vs Mesh Count. Note that the graph is quite symmetrical across the red line, meaning that 40 meshes with 60 materials has nearly the same frame time as 60 meshes with 40 materials.|Frame times of Material Count vs Mesh Count. Note that the graph is quite symmetrical across the red line, meaning that 40 meshes with 60 materials has nearly the same frame time as 60 meshes with 40 materials.]]

==Bones==

Adding more bones to a skinned mesh renderer showed they seem to take about 0.32 ms per 1000 bones (while moving, however all bones move almost all the time). Do note that if you use Physbones to move that many bones, the Physbones would cost another 0.66 ms per 1000 bones.
tip

Vertex count did not seem to matter much for Bone or Material tests, but the Standard shader was used for all of these, so it might matter more for more intensive shaders that do heavy per-vertex calculations.

[[File:Unity Benchmark Skinned Mesh Renderer Bones Graph.png|frame|none|alt= Frame time of bones on a Skinned Mesh Renderer| Frame time of bones on a Skinned Mesh Renderer]]

==Blendshapes==

Blendshapes are the one test where vertex count mattered, but not by a lot. Blendshapes seem to take 0.005 ms per million vertices per blendshape, if all blendshapes are actively being changed.

Some interesting information:

* For frame time, It doesn’t seem to matter if only one vertex, or all vertices are being changed by a blendshape
* For frame time, Inactive blendshapes seem practically free

Blendshapes still have a VRAM cost, even when not changed, so they should still be eliminated where-ever possible.
[[Category:Resources]]

Guides:SteamVR Bindings

2024-12-06T05:20:05Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Uppercase URLs

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-12-06T05:10:16Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: /* Walkthroughs */

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Guides:SteamVR bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Guides:SteamVR bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR bindings|Overlap percentage]] & [[Guides:SteamVR bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-12-06T05:07:39Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Corrected broken links due to namespace community -> Guides migration

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Guides:SteamVR Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Guides:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Guides:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Guides:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Guides:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Guides:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

=== Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export ====
#Navigate to [[Guides:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Guides:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

=== Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers ===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Guides:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Guides:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Guides:SteamVR Bindings|Overlap percentage]] & [[Guides:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Guides:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

==== Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

====Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-12-01T03:42:52Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Removed side by side notice boxes

{{Noticebox/Community}}
{{Stub|Need input from more popular controller types}}
{{Noticebox/wip|Still creating sections & tutorials}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser ===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input

|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
| Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
| vector2
|
|-
|Close Quick Menu
| Menu
| [[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
| Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources ===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics ===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
#Navigate to [[Community:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
#Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
#Share as needed!

====Import====
#Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
#Navigate to the [[Community:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
#Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes ==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

=== Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping ====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding ====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

==== Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-30T15:45:38Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Typo*

{{Noticebox/Community}}
{|
!{{Noticebox/wip|Still creating sections & tutorials}}
!{{Stub|Need input from more popular controller types}}
|}
SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
# Navigate to [[Community:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
# Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
# Share as needed!

====Import====
# Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
# Navigate to the [[Community:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
# Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

=== Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures ====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

====Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-30T15:44:30Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Stub/WIP Banners

{{Noticebox/Community}}
{|
!{{Stub|Need input from more popular controller types}}
!{{Noticebox/wip|Still creating sections & tutorials.}}
|}
SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
# Navigate to [[Community:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
# Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
# Share as needed!

====Import====
# Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
# Navigate to the [[Community:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
# Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

=== Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures ====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

====Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-28T04:06:05Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Added approved image

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
# Navigate to [[Community:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
# Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
# Share as needed!

====Import====
# Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
# Navigate to the [[Community:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
# Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
<blockquote>[[File:SteamVR Input - Importing Bindings.png|800x800px]] </blockquote>
</blockquote>

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

=== Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures ====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

====Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-28T04:01:50Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Manual import/xxport, disabling pose gestures, & Viveified Index.

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]
</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

===Manual Binding export/import===
Due to how Community Bindings sort by usage time, it can be difficult to share a newly created binding with others. Manual methods use a .json file for sharing.
<blockquote>
====Export====
# Navigate to [[Community:SteamVR Bindings|bindings Editing page]] select <code>Export Binding File</code>
# Navigate to <code>(Your Documents)\steamvr\input\exports</code> to find the .json file.
# Share as needed!

====Import====
# Place the binding .json file in <code>(Your Documents)\steamvr\input\imports</code> (create folder if it doesn't exist)
# Navigate to the [[Community:SteamVR Bindings|Bindings config]] for the app the Binding is for. (VRChat likely in this case)
# Select the binding from the list of <code>"Bindings in the documents directory"</code> (You do not need to close SteamVR)
(Image when approved)
</blockquote>

==Don'ts ==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

==== Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands ===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
==== No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to initially pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit object dropping====
To only drop objects with a specific button add the `Drop` action as an input.

====Disabling pose gestures====
Add the <code>Disable Gesture Tracked</code> action anywhere controller to disable all skeletal hand pose gestures.

====Viveified gestures====
Using the Touchpad of Index Controllers for gestures like Vive is possible with SteamVR bindings.

You'll need to migrate over all of the actions and buttons from Vive's setup to Index and add the <code>Disable Gesture Tracked</code> function. [https://github.com/ZenithVal/SteamVR-Bindings/blob/main/VRChat/VRChat_Index%20-%20Viveified.json Binding File via Github]. (See install guide)

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

File:SteamVR Input - Importing Bindings.png

2024-11-28T03:58:53Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Supplementary image guiding manual binding importing.

Guides:SteamVR Bindings

2024-11-23T11:20:10Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Disable Gesture Tracked action correction

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gestures via pose from running if bound.
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit input Gestures only====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit gesture inputs on these controllers, you'll need to add the <code>Disable Gesture Tracked</code> Action anywhere to your binds. It doesn't matter where.
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit Object dropping====
If you only want to drop objects with a specific button, adding the `Drop` action as an input will achieve this.

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-22T07:32:18Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Index Specific notes & Open Hand Parity

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Explicit Open Hand====
On controllers with Gesture Activators, such as Index, Open hand is triggered by a lack of input. If you want to only do Explicit inputs on these controllers, you'll need to Set Left & Right Hand Skeleton to `Unused`. This will unfortunately also disable finger tracking.
<blockquote>[https://feedback.vrchat.com/bug-reports/p/steamvr-input-20-open-hand-behavior-parity Related Canny]</blockquote>
</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to SteamVR Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 version 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings, navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
To make it easier to grab and or harder to drop, find the `Grip` Control Source then look for `Grab` & [[Community:SteamVR Bindings|adjust the input settings]]. Increasing the Grab Threshold will increase the amount of force you must apply to pick up the object and the Release Threshold will change the amount of force it must be less than to drop.

====Explicit Object dropping====
If you only want to drop objects with a specific button, adding the `Drop` action as an input will achieve this.

</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-20T06:30:02Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Added Approved images

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

[[File:SteamVR Input - New Control Sources.png|1000x1000px]]

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]
====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
TODO</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-11-20T06:25:32Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Additional Input methods & Creating new Control sources

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Additional input methods ===
To use additional [[Community:SteamVR Bindings|input methods]] such as double click, find the input you'd like to configure and hover over it to click the pencil icon for editing. Next click <code>More Options</code> and then you'll have access to additional input methods besides click.

Image when approved*

===Creating new inputs / Control sources===
On any of a controller's existing control sources, you can create new inputs with a specific [[Community:SteamVR Bindings|control source modes]]. To do this, click the plus button to the right of any of the control sources and select a control source mode from the available list.

Image when approved*

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]
====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
TODO</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

File:SteamVR Input - New Control Sources.png

2024-11-20T06:25:00Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Creating new Control Sources in steamVR input

File:SteamVR Input - Additional Input Methods.png

2024-11-20T06:09:19Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Guide on accessing additional Input Methods

Guides:SteamVR Bindings

2024-10-31T19:29:05Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Updated Actions list

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Activate Safe Mode
| Global
|Activates [[Main Menu#Safety|Safe mode]]
|boolean
|suggested
|-
|Toggle HUD
|Global, 1H
|Toggles [[HUD]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global, 1H
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Open Chatbox
|Global, 1H
|Opens [[Chatbox]]
|boolean
|optional
|-
|Open Camera
|Global, 1H
|Toggles [[Camera]]
|boolean
|optional
|-
|Open Stream Camera
|Global, 1H
|Toggles [[Camera#Types|Stream Camera]]
|
|
|-
|Toggle Earmuffs
|Global, 1H
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Personal Mirror Grabbing
|Global
|Toggles grabbing on [[Mirrors#Personal Mirror|Personal Mirror]]
|boolean
|optional
|-
|Toggle Face Mirror
|Global, 1H
|Toggles [[Mirrors|Face Mirror]]
|boolean
|optional
|-
|Confirm FBT Calibration
|Global, 1H
|If bound, replaces the default trigger press to lock FBT binding.
|boolean
|optional
|-
|Toggle Avatar Debug Screen
|Global, 1H
|Toggles [[Debug Menu|Avatar Debug Screen]]
|boolean
|optional
|-
|Toggle OSC Debug Screen"
|Global, 1H
|Toggles [[Debug Menu|OSC Debug Console]]
|boolean
|optional
|-
! colspan="2" |One Handed (1H)
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Adding new inputs===
TODO

===Double tap menu ===
TODO

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]
====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
TODO</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />
[[Category:Guides]]

Guides:SteamVR Bindings

2024-09-01T01:52:40Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Completed some more guides, added images

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
! Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
| (?)
|}

===Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
| Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
| Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
| Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
| Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!

|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
| Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
| Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
| Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
| Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
| vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
| boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
| Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
| Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]].

=== Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

===Binding editing page ===
Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.

[[File:SteamVR Input - Editing Bindings.png|950x950px]]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil you'll find a cogwheel on the right side of the input which will bring up dialogue box with input settings.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

===Adding new inputs===
TODO

===Double tap menu ===
TODO

===Creating Chords===
TODO

===Deadzones===
To change the deadzones on control sources like Trackpads & Joysticks, open their [[Community:SteamVR Bindings#Changing Input Settings|input settings]] and adjust the values to your liking. <code>DeadZone</code> is what you'd expect and <code>Max Zone Percentage</code> determines how far from the center of the control source is 100% value.

[[File:SteamVR Input - Deadzones.png|900x900px]]

<blockquote>
====Curve Exponent====
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone. <code>Speed = Value^Exponent</code>

[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>

===Trigger thresholds===
TODO

===Changing haptics===
Most control sources on the default bindings have an [[Community:SteamVR Bindings#Changing Input Settings|input setting]] for <code>Haptic Amplitude</code>. To turn haptics off, you'll need to go through '''every''' control source [[Community:SteamVR Bindings#Changing Input Settings|input setting]] on the controller and set <code>Haptic Amplitude</code> to '''0'''. Make sure to also check the control sources in other action sets besides global. If you want to remove the haptics upon hovering over menu items in VRChat, select the <code>Haptics</code> button in the center of the Global action set & change <code>Left/Right Hand Haptics</code> to '''Unused.'''

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

=== All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]
====Hard Bindings reset====
In rare cases, a full hard reset of your Bindings for VRChat may help solve unknown issues. Navigating to <code>(username)/Documents/steamvr/input</code> and delete the <code>steam.app.438100_controlType.json</code> of the affected controller type. Restart VRChat to generate new files.
</blockquote>

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving ====
The default thresholds for movement on Vive controllers require you to hit the edges of the touchpad. You can adjust the trackpad [[Community:SteamVR Bindings#Deadzones|Deadzones]] to change this.
====Accidental jumping====
With a mix of adjustments to [[Community:SteamVR Bindings|Overlap percentage]] & [[Community:SteamVR Bindings#Deadzones|Deadzones]] on the Trackpad DPADs, you can restore the pre-Input 2.0 zone for jumping.
====Physbone posing with grip ====
At time of writing (8/30/24) Physbone posing is part to the <code>interact</code> action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====
TODO</blockquote>

===HP Reverb G2===
<blockquote>TODO</blockquote>

TODO: More controller types.

==References==
<references />

File:SteamVR Input - Deadzones.png

2024-09-01T01:31:26Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

How to access Deadzone settings for a trackpad or joystick

File:SteamVR Input - Curve Exponent.png

2024-09-01T01:18:55Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Displays the relationship between input value and output speed when using a Curve Exponent. (For Trackpads/Joysticks)

File:SteamVR Input - Editing Bindings.png

2024-09-01T00:45:48Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

How to access the bindings edit page

File:SteamVR Input - Vive Advanced Controls.png

2024-09-01T00:40:26Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Example showing the two choices available on Vive Advanced Controls.

Guides:SteamVR Bindings

2024-08-31T14:16:51Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Vive Default vs Default Advanced

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|-
|
|
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
| XY Positioning, touches, and presses
|-
| Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
| Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
| A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
| Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
| Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
| optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
| Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
| boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
| Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
| boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
| boolean
| optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
| Global
| Toggles the [[Camera]]
|boolean
|optional
|-
| Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" | One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
| One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
| optional
|-
| Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
| One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
| Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
| optional
|-
| Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
| Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
| Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
| Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
| skeleton
|suggested
|-
| SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
| GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
| optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" | Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
| UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
| Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
| optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
| Global, Act, 1H
| Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
| GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
| Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while rotating)
| boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to first navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

=== Editing Bindings ===
You can enter the bindings editor for a specific controller by selecting <code>Edit</code> on the currently applied Binding.

[TODO Image]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil, to the right side of the input you'll find a cogwheel which will cause a dialogue box with input settings to appear.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

=== Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

== Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Disabling finger tracking ====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]<blockquote>TODO: Image of option with menu location context</blockquote>
====Hard Bindings reset ====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
<blockquote>

====Advanced Controls====
Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''

Default Vive & Default Advanced Vive vary in gesture control & movement. In Advanced mode, you can click the trackpad to move then release click but continue touching the trackpad to continue moving. Advanced Vive also has a different way of handling gestures with support for soft gesture select behavior.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

==== Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone posing with grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-31T14:08:39Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Minor adjustments

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|-
|
|
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
| XY Positioning, touches, and presses
|-
| Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
| Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
| A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
| Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
| Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
| optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
| Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
| boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
| Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
| boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
| boolean
| optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
| Global
| Toggles the [[Camera]]
|boolean
|optional
|-
| Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" | One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
| One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
| optional
|-
| Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
| One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
| Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
| optional
|-
| Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
| Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
| Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
| Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
| skeleton
|suggested
|-
| SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
| GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
| optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" | Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
| UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
| Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
| optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
| Global, Act, 1H
| Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
| GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
| Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while rotating)
| boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to first navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

=== Editing Bindings ===
You can enter the bindings editor for a specific controller by selecting <code>Edit</code> on the currently applied Binding.

[TODO Image]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil, to the right side of the input you'll find a cogwheel which will cause a dialogue box with input settings to appear.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

=== Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

== Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Disabling finger tracking ====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Tracking breaking in SteamVR Dashboard====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''

'''Currently this safety feature can only be disabled in the SteamVR Beta'''. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions]<blockquote>TODO: Image of option with menu location context</blockquote>
====Hard Bindings reset ====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>

====Advanced Controls====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. Try switching.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

==== Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone posing with grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-31T14:00:14Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Completed some more guides

{{Noticebox/Community}}
{{Stub|Still missing guides & need more input from various controller types}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

===Standard method===

#Open SteamVR
#Find '''Settings'''
#Select '''Controllers'''
#Set '''Advanced Setting''' to '''Show'''
#Select '''Show Binding UI'''
#Select '''VRChat''' from the list of applications

[[File:SteamVR Input - Accessing VRChat Bindings.png]]

===Via web browser===

#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
#Select '''<code>VRChat</code>''' from the list of applications

===Via VRChat===

#Open the main menu
#Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
! Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
| A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
| Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.
|-
|Chords
|Bindings that combine two or more inputs to execute one action
|-
|
|
|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

===Control Source Modes===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
|Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
| XY Positioning, touches, and presses
|-
| Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
| Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control

|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

===Input Methods===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
| boolean
|Button
|-
|Double
| A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
| Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
| Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

===Actions===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
| optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
| Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
| boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
| Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
| boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
| boolean
| optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
| Global
| Toggles the [[Camera]]
|boolean
|optional
|-
| Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" | One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
| One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
| optional
|-
| Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
| One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
| Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
| optional
|-
| Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
| Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
| Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
| Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
| Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
| skeleton
|suggested
|-
| SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
| GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
| optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" | Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
| UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
| Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
| optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
| Global, Act, 1H
| Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
| GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
| Global, Act, 1H
| Disables gesture wheel while clicked (prevents emotes while rotating)
| boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
These walkthroughs require you to first navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]].

===Default Bindings===
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]] and select <code>Activate</code> on the official Default Bindings available for your controller.

[[File:SteamVR Input - Default Bindings.png|1100x1100px]]

=== Editing Bindings ===
You can enter the bindings editor for a specific controller by selecting <code>Edit</code> on the currently applied Binding.

[TODO Image]

===Changing input settings===
Almost all inputs can be configured. Find the input you'd like to configure and hover over it, you'll see a pencil icon you can click. After clicking the pencil, to the right side of the input you'll find a cogwheel which will cause a dialogue box with input settings to appear.

[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]

=== Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

===DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

== Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Disabling finger tracking ====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Hands breaking in SteamVR Dashboard is open====
This is due to a SteamVR feature called Keyboard privacy introduced in [https://store.steampowered.com/news/app/250820/view/4371390626087848465 SteamVR 2.7] which restricts applications from seeing device positions while the Steam keyboard is visible. As of time of writing, this safety feature can only be disabled in the SteamVR Beta. [https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD Opt in Instructions] In SteamVR settings navigate to <code>Dashboard</code> and set <code>Keyboard Privacy</code> to '''Disabled.'''<blockquote>TODO: Image of option with menu location context</blockquote>
====Hard Bindings reset ====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>

====Advanced Controls====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. Try switching.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

==== Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone posing with grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

File:SteamVR Input - Default Bindings.png

2024-08-31T13:36:50Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

How to select default bindings after navigating the VRChat SteamVR bindings page.

File:SteamVR Input - Accessing Input Settings.png

2024-08-31T13:23:21Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1:

Guide to accessing Input settings for a specific SteamVR input

File:Multiple actions per controller.png

2024-08-31T13:22:25Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1 moved page File:Multiple actions per controller.png to File:SteamVR Input - Multiple actions per controller.png: Prefix unification

#REDIRECT [[File:SteamVR Input - Multiple actions per controller.png]]

File:SteamVR Input - Multiple actions per controller.png

2024-08-31T13:22:25Z

This can cause issues. In the example displayed, the bad side will prevent auto hold functionality from working.

File:Accessing VRChat Bindings.png

2024-08-31T13:21:25Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1 moved page File:Accessing VRChat Bindings.png to File:SteamVR Input - Accessing VRChat Bindings.png: Prefix unification

#REDIRECT [[File:SteamVR Input - Accessing VRChat Bindings.png]]

File:SteamVR Input - Accessing VRChat Bindings.png

2024-08-31T13:21:25Z

Step by step guide to finding VRChat bindings

Guides:SteamVR Bindings

2024-08-30T20:54:39Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: /* Controller info & fixes */

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>

====Default & Community bindings====
After navigating the [[Community:SteamVR_Bindings#Where|VRChat SteamVR bindings page]]
<blockquote>https://help.steampowered.com/en/faqs/view/4F5E-AD22-7402-2EAD</blockquote>

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Hands breaking when SteamVR Dashboard is open====

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone Posing with Grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T20:11:52Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: More heading fixes (aaaa)

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>
==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

====Reverting to old finger tracking====
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Default & Community bindings====
TODO: guide to the binding select page with an image.
<blockquote>TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)</blockquote>

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone Posing with Grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T19:51:44Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Fixed Vive heading levels

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>
==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

===Disabling finger tracking===
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

===Reverting to old finger tracking===
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Default & Community bindings====
TODO: guide to the binding select page with an image.
<blockquote>TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)</blockquote>

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>

===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

====Physbone Posing with Grip====
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

====Unwanted Action Menu gestures====
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

====Grip isn't doing hand open / Isn't clearing gestures====
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks.
</blockquote>

===Index===
<blockquote>
====Easier Object holding====

</blockquote>

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T08:05:57Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Unwanted Action Menu Gestures & Some formatting

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

===All controllers===
Various fixes that are potentially globally applicable.
<blockquote>
==== Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

===Disabling finger tracking===
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]
<blockquote>TODO: Location of toggle in context</blockquote>

===Reverting to old finger tracking===
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
<blockquote>TODO: GIF navigating to toggle</blockquote>

====Default & Community bindings====
TODO: guide to the binding select page with an image.
<blockquote>TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)</blockquote>

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
<blockquote>TODO: Guide on process</blockquote>
</blockquote>
===Vive Wands===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
<blockquote>
====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.
<blockquote>TODO: Image of bindings page, focusing on Default/Advanced options </blockquote>

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.
<blockquote>TODO: Recommended values for Simple & Advanced</blockquote>

====Accidental jumping ====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
<blockquote>TODO: Recommended values for both</blockquote>

===Physbone Posing with Grip===
At time of writing (8/30/24) posing physbones is tied to the <code>interact</code> functionality and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: image showing what the newly added button should look like.</blockquote>

===Unwanted Action Menu gestures===
This is because the Action Menu action set is a copy of the Global action set. If you wish to keep Fist/Open hand functional but prevent the trackpad from firing emotes, you can migrate the actions of <code>Gesture Wheel - Disable Move</code> And <code>Gesture Wheel - Disable Rotate</code> to Touch on their respective Buttons instead of Click. If you want to disable ALL gestures (including fist/open hand) while the action menu is open, you can delete all Gesture Wheel actions from the Action menu action set all together.
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny]TODO: Image of bind setup</blockquote>

===Grip isn't doing hand open / Isn't clearing gestures===
You're likely missing the <code>Gesture Wheel Cancel Open (Left/Right)</code> actions on your grips as a Button clicks. </blockquote>
===Index===

====Easier Object holding====

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T00:10:56Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Microphone is optional

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|suggested
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|suggested
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|optional
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|________________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>

TODO: GIF navigating to toggle

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

===Reverting to old finger tracking===
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>

TODO: GIF navigating to toggle

====Default & Community bindings====
TODO: guide to the binding select page with an image.

TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.

TODO

===Vive===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.

TODO: Recommended values for Simple & Advanced

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.

TODO: Recommended values for both

====Grip isn't doing hand open / Isn't clearing gestures====
This seems to be an oversight with Vive Advanced Bindings, you'll need to add the Gesture_wheel_cancel_open_left & right actions to your grips as a Button press inputs.

TODO: image showing what the newly added button should look like

===Index===

====Easier Object holding====

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T00:06:59Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Misaligned Header Cell

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions ===
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|
|-
|Drop
|Global, 1H
|Drops held item. Enables Auto Hold. (Prevents item drop unless drop action is triggered)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
|UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|_____________________________
|________________
|
|
|
|}

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>

TODO: GIF navigating to toggle

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

===Reverting to old finger tracking===
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>

TODO: GIF navigating to toggle

====Default & Community bindings====
TODO: guide to the binding select page with an image.

TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.

TODO

===Vive===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.

TODO: Recommended values for Simple & Advanced

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.

TODO: Recommended values for both

====Grip isn't doing hand open / Isn't clearing gestures====
This seems to be an oversight with Vive Advanced Bindings, you'll need to add the Gesture_wheel_cancel_open_left & right actions to your grips as a Button press inputs.

TODO: image showing what the newly added button should look like

===Index===

====Easier Object holding====

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />

Guides:SteamVR Bindings

2024-08-30T00:03:09Z

Usr e7694acc-a0a2-43c0-bb89-7d875f6ed4e1: Text wrapping...

{{Noticebox/Community}}
{{Noticebox/wip|}}

SteamVR input is a universal keybind system for all controllers usable in SteamVR. Instead of binding keys like "space" to jump, VR game developers provide '''actions''' we can directly bind to '''inputs''' on SteamVR controllers. The UI also provides a way for users to find or share community bindings. <ref name=":0">https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md</ref>

[https://docs.vrchat.com/docs/steamvr-input-20 Official VRChat SteamVR Input 2.0 documentation]<ref>https://docs.vrchat.com/docs/steamvr-input-20</ref>

[https://docs.vrchat.com/docs/input-20-faq Official VRChat SteamVR input 2.0 FAQ]<ref>https://docs.vrchat.com/docs/input-20-faq</ref>

==Where==

=== Standard method ===

# Open SteamVR
# Find '''Settings'''
# Select '''Controllers'''
# Set '''Advanced Setting''' to '''Show'''
# Select '''Show Binding UI'''
# Select '''VRChat''' from the list of applications

[[File:Accessing VRChat Bindings.png]]

=== Via web browser ===

# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
# Select '''<code>VRChat</code>''' from the list of applications

=== Via VRChat ===

# Open the main menu
# Navigate to [[Settings]]
#Go to [[Settings#Controls|Controls]]
#Select '''<code>Open SteamVR Input Bindings Panel</code>'''

==Glossary==
{| class="wikitable"
!Terms
!Explanation
|-
|Bindings
|A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
|-
|Action
|Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
|-
|Action set
|A group of actions that corresponds to a specific context, like using the menu or action menu, or global actions that are available in any context.
|-
|Control source
|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
|-
|Control source mode
''(Use control as)''
|A mapping that defines how a control source's movements or sensors are interpreted as inputs.
For example, a trackpad can be mapped as dpad or a button, and a joystick can be mapped as joystick or scroll wheel.
|-
|Input
|A specific movement or sensor reading from a control, interpreted through a control source mode.
For example, a button's control source mode might provide touch, press, hold, or double-press inputs.

|}
Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.

=== Control Source Modes ===
{| class="wikitable mw-collapsible mw-collapsed"
!Control Source Mode
!Provided Inputs
|-
|Button
| Touches, Clicks, Holds, Double clicks, and Long presses
|-
|Trigger
|Touch (or any press), Click if there is a physical click at the end of the trigger, and the ammount (0-1) the trigger is depressed)
|-
|Joystick
|XY Positioning, touches, and presses
|-
|Trackpad
|XY Positioning, touches, and presses
|-
|DPAD
|Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode.
|-
|Grab
|Combines capacitive sensors and force sensors to report a more reliable grab
|-
|Force Sensor
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control
|-
|Set analog Action
|Allows you to use a digital (on/off) control to a set an analog (0-1) value
|-
|Toggle Button
|One press for on, one press for off
|-
|Radial Menu
|(?)
|}

=== Input Methods ===
{| class="wikitable mw-collapsible mw-collapsed"
!Input
!Usage
!Types
!Control Source
|-
|Click
|Pressing the control
|boolean
|Any
|-
|Touch
|Touching the assigned control (If it has a touch sensor)
|boolean
|Any
|-
|Single
|Pressing the control once
|boolean
|Button
|-
|Double
|A quick double press of the control
|boolean
|Button
|-
|Long
|Hold the control for 0.5 seconds (?)
|boolean
|Button
|-
|Held
|Sets the action to true while the button is held after the long duration.
|boolean
|Button
|-
|Pull
|Value 0-1 representing what percentage the trigger is depressed
|vector1
|Trigger
|-
|Position
|The position you are touching on a touchpad or the position you've pushed a joystick to.
|vector2
|Trackpad / Joystick
|}

=== Actions (For VRChat) ===
{| class="wikitable mw-collapsible mw-collapsed"
!Action
!Action Set
!Description
!Type
!Requirement
|-
|Menu
|Global, 1H
|Dual purpose. One activation opens quick menu. Holding it opens the action menu. Double press opens the main menu (If enabled)
|boolean
|suggested
|-
|Main Menu
|Global
|[[Main Menu|Opens the Main Menu]]
|boolean
|optional
|-
|Quick Menu
|Global
|[[Quick Menu|Opens the Quick Menu]]
|boolean
|optional
|-
|Action Menu
|Global
|[[Action Menu|Opens the Action Menu]]
|boolean
|optional
|-
|Interact
|Global, 1H
|Interact with world objects and poses physbones
|boolean
|
|-
|Grab
|Global, 1H
|Picks up grabbable world objects
|boolean
|
|-
|Drop
|Global, 1H
|Drops held item. If bound this will enable auto hold functionality. (Items will not be dropped until this is used)
|boolean
|optional
|-
|Move
|Global, 1H
|Player movement
|vector2
|
|-
|Jump
|Global, 1H
|Jump!
|boolean
|
|-
|Rotate
|Global
|Player rotation
|vector2
|
|-
! colspan="2" |Advanced Controls
! colspan="3" |Alternative movement for touchpads that share the Gesture Wheel
|-
|Start Move (Advanced)
|Global
|When this is clicked, begin moving.
|boolean
|optional
|-
|Start Rotate (Advanced)
|Global
|When this is clicked, begin rotating
|boolean
|optional
|-
|Continue Move (Advanced)
|Global
|If Start move is released, as long as this is active, movement will continue.
|boolean
|optional
|-
|Continue Rotate (Advanced)
|Global
|If Start rotate is released, as long as this is active, rotation will continue.
|boolean
|optional
|-
|No Gesture After Move
|Global
|Prevents Gesture Wheel touches after Start move click is released
|boolean
|optional
|-
|No Gesture After Rotate
|Global
|Prevents Gestures Wheel touches after Start rotate click is released
|boolean
|optional
|-
! colspan="2" |Miscellaneous
! colspan="3" |Other optional functionalities
|-
|Toggle Microphone
|Global, 1H
|Toggles [[Microphone]]
|boolean
|
|-
|Gesture Toggle
|Global, 1H
|Toggles [[Gestures]]
|boolean
|optional
|-
|Cycle Nameplate Mode
|Global
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]]
|boolean
|optional
|-
|Toggle HUD
|Global
|Toggles the [[HUD]]
|boolean
|optional
|-
|Open Chatbox
|Global
|Opens the [[Chatbox]]
|boolean
|optional
|-
|Toggle Personal Mirror
|Global
|Toggles the [[Personal Mirror]]
|boolean
|optional
|-
|Toggle Earmuffs
|Global
|Toggles [[Earmuff Mode|Earmuffs]]
|boolean
|optional
|-
|Open Camera
|Global
|Toggles the [[Camera]]
|boolean
|optional
|-
|Activate Safe Mode
|Global
|Activates [[Safe mode]]
|boolean
|suggested
|-
|Proximity Sensor
|Global
|When active, trigger AFK in VRChat
|boolean
|optional
|-
! colspan="2" |One Handed
! colspan="3" |Specifically for the one handed action set
|-
|Move & Rotate
|One_Hand
|Combined movement & rotation
|vector2
|suggested
|-
|Start Move & Rotate
|One_Hand
|When clicked begin Move & Rotate
|boolean
|optional
|-
|Continue Move & Rotate
|One_Hand
|When Start Move & Rotate released, continue as long as this is active.
|boolean
|optional
|-
|No Gesture After Move & Rotate
|One_Hand
|Prevents gestures afterMove & Rotate is released
|boolean
|optional
|-
! colspan="2" |Udon
! colspan="3" |Inputs used by Udon worlds
|-
|Udon Menu
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
|Udon Trigger Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Grip Axis
|Global, 1H
|Registerable by VRChat worlds with Udon.
|vector1
|optional
|-
|Udon Stick Click
|Global, 1H
|Registerable by VRChat worlds with Udon.
|boolean
|optional
|-
! colspan="2" |Menu
! colspan="3" |Specifically for the menu action set
|-
|Confirm
|Menu
|Clicks on menu items
|boolean
|suggested
|-
|Back
|Menu
|Returns to the previous page (or closes the menu?)
|boolean
|optional
|-
|Tab
|Menu
|(?)
|boolean
|optional
|-
|Scroll
|Menu
|Scrolls in the menu
|vector2
|
|-
|Close Quick Menu
|Menu
|[[Quick Menu|Closes the Quick Menu]]
|boolean
|optional
|-
|Drag
|Menu
|(?)
|boolean
|optional
|-
! colspan="2" |Action Menu
! colspan="3" |Specifically for the action menu action set
|-
|Axis
|Action
|Directional control in the action menu
|vector2
|suggested
|-
|Select
|Action
|Select hovering item in the action menu
|boolean
|
|-
! colspan="2" |(?)
! colspan="3" |(?)
|-
|Pose Data
|Global
|The 6-DOF position and orientation of a device tracked device.
|pose
|
|-
|SkeletonLeftHand
|Global
| rowspan="2" |Used to retrieve bone transform data from the related controllers
|skeleton
|suggested
|-
|SkeletonRightHand
|Global
|skeleton
|
|-
|Haptics
|Global, 1H
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror)
|vibration
|
|-
! colspan="2" |Gesture Activator (GA)
! colspan="3" |Activators for (?)
|-
|GA (Thumb)
|Global
|
|boolean
|optional
|-
|GA (Thumb Inner-Upper)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Inner-Lower)
|Global
|
|boolean
|optional
|-
|GA (Thumb, Outer)
|Global
|
|boolean
|optional
|-
|GA (Index Finger)
|Global
|
|boolean
|optional
|-
|GA (Grip)
|Global
|
|boolean
|optional
|-
|GA (Stick Deflection)
|Global
|
|vector2
|optional
|-
! colspan="2" |Gesture
! colspan="3" |(?)
|-
|Gesture - Trigger Axis
|Global
|
|vector1
|optional
|-
|Gesture - Grip Axis
|Global
|
|vector1
|optional
|-
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki>
! colspan="3" |Used to directly set the integer values of [https://creators.vrchat.com/avatars/animator-parameters/#gestureleft-and-gestureright-values GestureLeft/GestureRight]
|-
|UG - Neutral (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>0 (Neutral)</code>
|boolean
|optional
|-
|UG - Fist (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>1 (Fist)</code>
|boolean
|optional
|-
|UG - Open (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>2 (HandOpen)</code>
|boolean
|optional
|-
!UG - Point (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>3 (FingerPoint)</code>
|boolean
|optional
|-
|UG - Peace (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>4 (Victory)</code>
|boolean
|optional
|-
|UG - Horns (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>5 (RockNRoll)</code>
|boolean
|optional
|-
|UG - Finger Gun (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code>
|boolean
|optional
|-
|UG - Thumbs Up (Left/Right)
|Global
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code>
|boolean
|optional
|-
! colspan="2" |Gesture Wheel (GW)
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control
|-
|GW (Left/Right)
|Global, Act, 1H
|The XY position of the gesture wheel
|vector2
|optional
|-
|GW Select (Left/Right)
|Global, Act, 1H
|Selects a gesture that will be released after activation stops
|boolean
|optional
|-
|GW Held (Left/Right)
|Global, Act, 1H
|Selects a gesture that will remain after activation stops
|boolean
|optional
|-
|GW Direct (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Direct Stay (Left/Right)
|Global, Act, 1H
|(?)
|boolean
|optional
|-
|GW Soft Select (Left/Right)
|Global, Act, 1H
|Selects a gesture which can be used with Gesture wheel Weight
|vector1
|optional
|-
|GW Weight (Left/Right)
|Global, Act, 1H
|Analog driving value of the current gesture
|vector1
|optional
|-
|GW Cancel (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Cancel Open (Left/Right)
|Global, Act, 1H
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release
|boolean
|optional
|-
|GW Disable Move (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while walking)
|boolean
|optional
|-
|GW Disable Rotate (Left/Right)
|Global, Act, 1H
|Disables gesture wheel while clicked (prevents emotes while rotating)
|boolean
|optional
|-
|Disable Gesture Tracked
|Global, Action
|Stops gesture wheel from running while clicked. (Prevents inputs while moving)
|boolean
|optional
|-
|_____________________________
|________________
|
|
|
|}
Every bindable Action for SteamVR controllers in VRChat. Found in <code>VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json</code> (Descriptions are community created)

==Walkthroughs==
===Adding new inputs===
TODO

===Double tap menu===
TODO

===Creating Chords===
TODO

===Dead zones===
TODO

===Trigger thresholds===
TODO

===Changing haptics===
TODO

=== DPAD overlap percentage===
TODO

==Don'ts==
There's certain things you can do to bindings that can cause issues. Try to avoid them when possible

===Multiple actions per control source===
When you bind multiple actions like this, it stops them from functioning instantaneously and can make them unpredictable. <ref name=":0" />

[[File:Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]

A functional use case would be setting '''action menu''' to <code>Single</code> and '''quick menu''' to <code>Double</code>; this will introduces a small delay after the <code>single</code> press input which can be interrupted by a <code>double</code> click to open the '''quick menu''' without accidentally opening the '''action menu'''.

==Controller info & fixes==

====Can't do gestures at all====
By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].

<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>

TODO: GIF navigating to toggle

====Double tap is opening the Main Menu====
This feature was introduced with Input 2.0. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

====Disabling finger tracking====
Skeletal based finger tracking is enabled by default for all controller types. You can disable it in the [[Settings#Controls|Controls]] section of the [[Main Menu]]

TODO: Location of toggle in context

===Reverting to old finger tracking===
If you prefer the old finger tracking method, navigate to the [[Action Menu#Quick Actions|Quick Actions]] section of the [[Action Menu]] and enabling Legacy fingers. (this will need to be done on a per-avatar basis)

<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>

TODO: GIF navigating to toggle

====Default & Community bindings====
TODO: guide to the binding select page with an image.

TODO: Link to SteamVR beta for a fix on community bindings (remove later when fixed)

====Hard bindings reset====
In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.

TODO

===Vive===
Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)

====No touch to move / Emotes are "sticky"====
It's likely that you previously used Vive Advanced controls before Input 2.0. You can restore Advanced behavior you're used to by switching from '''Default Bindings''' over to the '''Default Advanced Bindings''' which can be found on the bindings select page.

====Difficulty moving====
The default thresholds for movement on Vive controllers require you to hit the very edges of the touchpad. This can be changed by adjusting Dead zones.

TODO: Recommended values for Simple & Advanced

====Accidental jumping====
With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.

TODO: Recommended values for both

====Grip isn't doing hand open / Isn't clearing gestures====
This seems to be an oversight with Vive Advanced Bindings, you'll need to add the Gesture_wheel_cancel_open_left & right actions to your grips as a Button press inputs.

TODO: image showing what the newly added button should look like

===Index===

====Easier Object holding====

===HP Reverb G2===

TODO: More controller types, need users with more experience on other types.

==References==
<references />