Guides:SteamVR Bindings: Difference between revisions
(Vive Default vs Default Advanced) |
(Completed some more guides, added images) |
||
Line 62: | Line 62: | ||
|Chords | |Chords | ||
|Bindings that combine two or more inputs to execute one action | |Bindings that combine two or more inputs to execute one action | ||
|} | |} | ||
<sup>Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.</sup> | <sup>Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.</sup> | ||
Line 71: | Line 68: | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
!Control Source Mode | !Control Source Mode | ||
!Provided Inputs | ! Provided Inputs | ||
|- | |- | ||
|Button | |Button | ||
|Touches, Clicks, Holds, Double clicks, and Long presses | |Touches, Clicks, Holds, Double clicks, and Long presses | ||
|- | |- | ||
|Trigger | |Trigger | ||
Line 80: | Line 77: | ||
|- | |- | ||
|Joystick | |Joystick | ||
| XY Positioning, touches, and presses | |XY Positioning, touches, and presses | ||
|- | |- | ||
| Trackpad | |Trackpad | ||
|XY Positioning, touches, and presses | |XY Positioning, touches, and presses | ||
|- | |- | ||
|DPAD | |DPAD | ||
| Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode. | |Splits the the XY control source into North, East, South, and West quadrants. Can be used in touch or click mode. | ||
|- | |- | ||
|Grab | |Grab | ||
|Combines capacitive sensors and force sensors to report a more reliable grab | |Combines capacitive sensors and force sensors to report a more reliable grab | ||
|- | |- | ||
|Force Sensor | |Force Sensor | ||
|Gives analog actions a 0-1 value indicating how much force the user is applying to the control | |Gives analog actions a 0-1 value indicating how much force the user is applying to the control | ||
|- | |- | ||
Line 99: | Line 96: | ||
|- | |- | ||
|Toggle Button | |Toggle Button | ||
|One press for on, one press for off | |One press for on, one press for off | ||
|- | |- | ||
|Radial Menu | |Radial Menu | ||
|(?) | | (?) | ||
|} | |} | ||
===Input Methods=== | ===Input Methods === | ||
{| class="wikitable mw-collapsible mw-collapsed" | {| class="wikitable mw-collapsible mw-collapsed" | ||
!Input | !Input | ||
Line 113: | Line 110: | ||
|- | |- | ||
|Click | |Click | ||
|Pressing the control | |Pressing the control | ||
|boolean | |boolean | ||
|Any | |Any | ||
|- | |- | ||
|Touch | |Touch | ||
|Touching the assigned control (If it has a touch sensor) | |Touching the assigned control (If it has a touch sensor) | ||
|boolean | |boolean | ||
|Any | |Any | ||
Line 128: | Line 125: | ||
|- | |- | ||
|Double | |Double | ||
| A quick double press of the control | |A quick double press of the control | ||
|boolean | |boolean | ||
|Button | |Button | ||
Line 142: | Line 139: | ||
|Button | |Button | ||
|- | |- | ||
| Pull | |Pull | ||
|Value 0-1 representing what percentage the trigger is depressed | | Value 0-1 representing what percentage the trigger is depressed | ||
|vector1 | |vector1 | ||
|Trigger | |Trigger | ||
|- | |- | ||
| Position | |Position | ||
|The position you are touching on a touchpad or the position you've pushed a joystick to. | |The position you are touching on a touchpad or the position you've pushed a joystick to. | ||
|vector2 | |vector2 | ||
Line 169: | Line 166: | ||
|- | |- | ||
|Main Menu | |Main Menu | ||
|Global | | Global | ||
|[[Main Menu|Opens the Main Menu]] | |[[Main Menu|Opens the Main Menu]] | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|Quick Menu | |Quick Menu | ||
|Global | | Global | ||
|[[Quick Menu|Opens the Quick Menu]] | |[[Quick Menu|Opens the Quick Menu]] | ||
|boolean | |boolean | ||
| optional | |optional | ||
|- | |- | ||
|Action Menu | |Action Menu | ||
|Global | | Global | ||
|[[Action Menu|Opens the Action Menu]] | |[[Action Menu|Opens the Action Menu]] | ||
|boolean | |boolean | ||
Line 194: | Line 191: | ||
|Grab | |Grab | ||
|Global, 1H | |Global, 1H | ||
|Picks up grabbable world objects | |Picks up grabbable world objects | ||
|boolean | |boolean | ||
|suggested | |suggested | ||
Line 206: | Line 203: | ||
|Move | |Move | ||
|Global, 1H | |Global, 1H | ||
| Player movement | |Player movement | ||
|vector2 | |vector2 | ||
| | | | ||
|- | |- | ||
|Jump | |Jump | ||
|Global, 1H | |Global, 1H | ||
|Jump! | |Jump! | ||
|boolean | |boolean | ||
| | | | ||
Line 227: | Line 225: | ||
|Start Move (Advanced) | |Start Move (Advanced) | ||
|Global | |Global | ||
|When this is clicked, begin moving. | |When this is clicked, begin moving. | ||
| boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
Line 238: | Line 236: | ||
|- | |- | ||
|Continue Move (Advanced) | |Continue Move (Advanced) | ||
| Global | |Global | ||
|If Start move is released, as long as this is active, movement will continue. | |If Start move is released, as long as this is active, movement will continue. | ||
|boolean | |boolean | ||
Line 250: | Line 248: | ||
|- | |- | ||
|No Gesture After Move | |No Gesture After Move | ||
|Global | | Global | ||
|Prevents Gesture Wheel touches after Start move click is released | |Prevents Gesture Wheel touches after Start move click is released | ||
|boolean | |boolean | ||
Line 273: | Line 271: | ||
|Global, 1H | |Global, 1H | ||
|Toggles [[Gestures]] | |Toggles [[Gestures]] | ||
| boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|Cycle Nameplate Mode | |Cycle Nameplate Mode | ||
|Global | | Global | ||
|Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]] | |Cycles through [[Nameplates#Nameplate element visibility|Nameplates Modes]] | ||
| boolean | |boolean | ||
| optional | |optional | ||
|- | |- | ||
|Toggle HUD | |Toggle HUD | ||
Line 288: | Line 286: | ||
|optional | |optional | ||
|- | |- | ||
|Open Chatbox | |Open Chatbox | ||
|Global | |Global | ||
|Opens the [[Chatbox]] | |Opens the [[Chatbox]] | ||
Line 307: | Line 305: | ||
|- | |- | ||
|Open Camera | |Open Camera | ||
| Global | |Global | ||
| Toggles the [[Camera]] | |Toggles the [[Camera]] | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
| Activate Safe Mode | |Activate Safe Mode | ||
|Global | |Global | ||
|Activates [[Safe mode]] | |Activates [[Safe mode]] | ||
|boolean | |boolean | ||
|suggested | |suggested | ||
|- | |- | ||
|Proximity Sensor | |Proximity Sensor | ||
Line 324: | Line 322: | ||
|optional | |optional | ||
|- | |- | ||
! colspan="2" | One Handed | ! colspan="2" |One Handed | ||
! colspan="3" |Specifically for the one handed action set | ! colspan="3" |Specifically for the one handed action set | ||
|- | |- | ||
|Move & Rotate | |Move & Rotate | ||
| One_Hand | |One_Hand | ||
|Combined movement & rotation | |Combined movement & rotation | ||
|vector2 | |vector2 | ||
Line 337: | Line 335: | ||
|When clicked begin Move & Rotate | |When clicked begin Move & Rotate | ||
|boolean | |boolean | ||
| optional | |optional | ||
|- | |- | ||
| Continue Move & Rotate | |Continue Move & Rotate | ||
|One_Hand | |One_Hand | ||
|When Start Move & Rotate released, continue as long as this is active. | |When Start Move & Rotate released, continue as long as this is active. | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|No Gesture After Move & Rotate | |No Gesture After Move & Rotate | ||
| One_Hand | |One_Hand | ||
|Prevents gestures afterMove & Rotate is released | |Prevents gestures afterMove & Rotate is released | ||
|boolean | |boolean | ||
Line 355: | Line 353: | ||
|- | |- | ||
|Udon Menu | |Udon Menu | ||
|Global, 1H | | Global, 1H | ||
|Registerable by VRChat worlds with Udon. | |Registerable by VRChat worlds with Udon. | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
| Udon Trigger Axis | |Udon Trigger Axis | ||
|Global, 1H | | Global, 1H | ||
|Registerable by VRChat worlds with Udon. | |Registerable by VRChat worlds with Udon. | ||
|vector1 | |vector1 | ||
Line 367: | Line 365: | ||
|- | |- | ||
|Udon Grip Axis | |Udon Grip Axis | ||
|Global, 1H | | Global, 1H | ||
|Registerable by VRChat worlds with Udon. | |Registerable by VRChat worlds with Udon. | ||
|vector1 | |vector1 | ||
| optional | |optional | ||
|- | |- | ||
| Udon Stick Click | |Udon Stick Click | ||
|Global, 1H | |Global, 1H | ||
|Registerable by VRChat worlds with Udon. | |Registerable by VRChat worlds with Udon. | ||
Line 401: | Line 399: | ||
|Scroll | |Scroll | ||
|Menu | |Menu | ||
| Scrolls in the menu | |Scrolls in the menu | ||
|vector2 | |vector2 | ||
| | | | ||
|- | |- | ||
Line 409: | Line 407: | ||
|[[Quick Menu|Closes the Quick Menu]] | |[[Quick Menu|Closes the Quick Menu]] | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|Drag | |Drag | ||
|Menu | |Menu | ||
|(?) | |(?) | ||
|boolean | |boolean | ||
Line 421: | Line 419: | ||
|- | |- | ||
|Axis | |Axis | ||
| Action | |Action | ||
|Directional control in the action menu | |Directional control in the action menu | ||
|vector2 | | vector2 | ||
|suggested | |suggested | ||
|- | |- | ||
|Select | |Select | ||
|Action | |Action | ||
| Select hovering item in the action menu | |Select hovering item in the action menu | ||
|boolean | | boolean | ||
| | | | ||
|- | |- | ||
Line 436: | Line 434: | ||
|- | |- | ||
|Pose Data | |Pose Data | ||
|Global | |Global | ||
|The 6-DOF position and orientation of a device tracked device. | |The 6-DOF position and orientation of a device tracked device. | ||
|pose | |pose | ||
| | | | ||
Line 444: | Line 442: | ||
|Global | |Global | ||
| rowspan="2" |Used to retrieve bone transform data from the related controllers | | rowspan="2" |Used to retrieve bone transform data from the related controllers | ||
| skeleton | |skeleton | ||
|suggested | |suggested | ||
|- | |- | ||
| SkeletonRightHand | |SkeletonRightHand | ||
|Global | |Global | ||
|skeleton | |skeleton | ||
Line 454: | Line 452: | ||
|Haptics | |Haptics | ||
|Global, 1H | |Global, 1H | ||
|Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror) | |Used to apply various haptics to the device. (Such as when hovering over menu elements or the personal mirror) | ||
|vibration | |vibration | ||
| | | | ||
|- | |- | ||
! colspan="2" |Gesture Activator (GA) | ! colspan="2" |Gesture Activator (GA) | ||
! colspan="3" |Activators for (?) | ! colspan="3" |Activators for (?) | ||
|- | |- | ||
|GA (Thumb) | |GA (Thumb) | ||
|Global | |Global | ||
| | | | ||
Line 467: | Line 465: | ||
|optional | |optional | ||
|- | |- | ||
| GA (Thumb Inner-Upper) | |GA (Thumb Inner-Upper) | ||
|Global | |Global | ||
| | | | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GA (Thumb, Inner-Lower) | |GA (Thumb, Inner-Lower) | ||
Line 477: | Line 475: | ||
| | | | ||
|boolean | |boolean | ||
| optional | |optional | ||
|- | |- | ||
|GA (Thumb, Outer) | |GA (Thumb, Outer) | ||
Line 483: | Line 481: | ||
| | | | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GA (Index Finger) | |GA (Index Finger) | ||
|Global | |Global | ||
| | | | ||
Line 507: | Line 505: | ||
|- | |- | ||
|Gesture - Trigger Axis | |Gesture - Trigger Axis | ||
|Global | | Global | ||
| | | | ||
|vector1 | |vector1 | ||
|optional | |optional | ||
|- | |- | ||
|Gesture - Grip Axis | |Gesture - Grip Axis | ||
|Global | | Global | ||
| | | | ||
|vector1 | |vector1 | ||
Line 519: | Line 517: | ||
|- | |- | ||
! colspan="2" |<nowiki>Gesture Direct | Use Gesture (UG)</nowiki> | ! 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] | ! 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) | |UG - Neutral (Left/Right) | ||
Line 529: | Line 527: | ||
|UG - Fist (Left/Right) | |UG - Fist (Left/Right) | ||
|Global | |Global | ||
|Sets Gesture(Left/Right) to <code>1 (Fist)</code> | |Sets Gesture(Left/Right) to <code>1 (Fist)</code> | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|UG - Open (Left/Right) | |UG - Open (Left/Right) | ||
Line 557: | Line 555: | ||
|optional | |optional | ||
|- | |- | ||
| UG - Finger Gun (Left/Right) | |UG - Finger Gun (Left/Right) | ||
|Global | |Global | ||
|Sets Gesture(Left/Right) to <code>6 (HandGun)</code> | |Sets Gesture(Left/Right) to <code>6 (HandGun)</code> | ||
Line 564: | Line 562: | ||
|- | |- | ||
|UG - Thumbs Up (Left/Right) | |UG - Thumbs Up (Left/Right) | ||
| Global | |Global | ||
|Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code> | |Sets Gesture(Left/Right) to <code>7 (Thumbsup)</code> | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
! colspan="2" |Gesture Wheel (GW) | ! colspan="2" |Gesture Wheel (GW) | ||
! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control | ! colspan="3" |Gesture wheel of emotes based on pre-input 2.0 Vive touchpad Gesture control | ||
|- | |- | ||
|GW (Left/Right) | |GW (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|The XY position of the gesture wheel | |The XY position of the gesture wheel | ||
|vector2 | |vector2 | ||
| optional | |optional | ||
|- | |- | ||
|GW Select (Left/Right) | |GW Select (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|Selects a gesture that will be released after activation stops | |Selects a gesture that will be released after activation stops | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Held (Left/Right) | |GW Held (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|Selects a gesture that will remain after activation stops | |Selects a gesture that will remain after activation stops | ||
|boolean | |boolean | ||
Line 591: | Line 589: | ||
|- | |- | ||
|GW Direct (Left/Right) | |GW Direct (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|(?) | |(?) | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Direct Stay (Left/Right) | |GW Direct Stay (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|(?) | |(?) | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Soft Select (Left/Right) | |GW Soft Select (Left/Right) | ||
| Global, Act, 1H | |Global, Act, 1H | ||
| Selects a gesture which can be used with Gesture wheel Weight | |Selects a gesture which can be used with Gesture wheel Weight | ||
|vector1 | |vector1 | ||
|optional | |optional | ||
|- | |- | ||
| GW Weight (Left/Right) | |GW Weight (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|Analog driving value of the current gesture | |Analog driving value of the current gesture | ||
|vector1 | |vector1 | ||
|optional | |optional | ||
|- | |- | ||
|GW Cancel (Left/Right) | |GW Cancel (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release | |Sets the current gesture to <code>1 (Fist)</code> and <code>0 (neutral)</code> after release | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Cancel Open (Left/Right) | |GW Cancel Open (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
|Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release | |Sets the current gesture to <code>2 (HandOpen)</code> and <code>0 (neutral)</code> after release | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Disable Move (Left/Right) | |GW Disable Move (Left/Right) | ||
|Global, Act, 1H | |Global, Act, 1H | ||
| Disables gesture wheel while clicked (prevents emotes while walking) | |Disables gesture wheel while clicked (prevents emotes while walking) | ||
|boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|GW Disable Rotate (Left/Right) | |GW Disable Rotate (Left/Right) | ||
| Global, Act, 1H | |Global, Act, 1H | ||
| Disables gesture wheel while clicked (prevents emotes while rotating) | |Disables gesture wheel while clicked (prevents emotes while rotating) | ||
| boolean | |boolean | ||
|optional | |optional | ||
|- | |- | ||
|Disable Gesture Tracked | |Disable Gesture Tracked | ||
|Global, Action | |Global, Action | ||
|Stops gesture wheel from running while clicked. (Prevents inputs while moving) | |Stops gesture wheel from running while clicked. (Prevents inputs while moving) | ||
|boolean | |boolean | ||
|optional | |optional | ||
Line 652: | Line 650: | ||
==Walkthroughs== | ==Walkthroughs== | ||
These walkthroughs require you to | These walkthroughs require you to navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]]. | ||
===Default Bindings=== | === Default Bindings=== | ||
To reset your bindings to default, navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR | 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]] | [[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=== | ===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 | 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]] | [[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]] | ||
=== Adding new inputs=== | ===Adding new inputs=== | ||
TODO | TODO | ||
===Double tap menu=== | ===Double tap menu === | ||
TODO | TODO | ||
Line 678: | Line 676: | ||
TODO | 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^<sup>Exponent</sup></code> | |||
[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote> | |||
===Trigger thresholds=== | ===Trigger thresholds=== | ||
Line 685: | Line 691: | ||
===Changing haptics=== | ===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=== | ===DPAD overlap percentage=== | ||
Line 701: | Line 707: | ||
== Controller info & fixes== | ==Controller info & fixes== | ||
===All controllers=== | === All controllers=== | ||
Various fixes that are potentially globally applicable. | Various fixes that are potentially globally applicable. | ||
<blockquote> | <blockquote> | ||
====Can't do gestures at all==== | ==== 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]]. | 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> | <code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code> | ||
<blockquote>TODO: GIF navigating to toggle</blockquote> | <blockquote>TODO: GIF navigating to toggle in action menu</blockquote> | ||
====Double tap is opening the Main Menu==== | ====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]] | 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==== | |||
====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]] | 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==== | ====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. <sup>(per-avatar basis)</sup> | 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. <sup>(per-avatar basis)</sup> | ||
<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code> | <code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code> | ||
<blockquote>TODO: GIF navigating to toggle</blockquote> | <blockquote>TODO: GIF navigating to toggle in action menu</blockquote> | ||
====Tracking breaking in SteamVR Dashboard==== | ====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.''' | 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.''' | ||
<sup>'''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]</sup | <sup>'''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]</sup> | ||
====Hard Bindings reset ==== | ====Hard Bindings reset==== | ||
In rare cases, a full hard reset of your | 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> | </blockquote> | ||
Line 743: | Line 744: | ||
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. | 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"==== | ====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. | It's likely that you previously used Vive [[Community:SteamVR Bindings|Advanced controls]] before Input 2.0. Try switching. | ||
====Difficulty moving==== | ====Difficulty moving ==== | ||
The default thresholds for movement on Vive controllers require you to hit the | 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. | |||
==== Accidental jumping==== | ====Physbone posing with grip ==== | ||
With a mix of adjustments to Overlap percentage & | 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> | |||
====Physbone posing with grip==== | |||
At time of writing (8/30/24) posing | |||
<blockquote>[https://feedback.vrchat.com/open-beta/p/1501-vive-controllers-unwanted-gesture-behavior-in-action-menu Related Canny] | |||
====Unwanted Action Menu gestures==== | ====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. | 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>[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==== | ====Grip isn't doing hand open / Isn't clearing gestures==== | ||
Line 771: | Line 766: | ||
<blockquote> | <blockquote> | ||
====Easier Object holding==== | ====Easier Object holding==== | ||
TODO</blockquote> | |||
</blockquote> | |||
===HP Reverb G2=== | ===HP Reverb G2=== | ||
<blockquote>TODO</blockquote> | |||
TODO: More controller types. | |||
TODO: More controller | |||
==References== | ==References== | ||
<references /> | <references /> |
Revision as of 01:52, 1 September 2024
[Reason: Still missing guides & need more input from various controller types]
[Reason: No reason provided.]
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. [1]
Official VRChat SteamVR Input 2.0 documentation[2]
Official VRChat SteamVR input 2.0 FAQ[3]
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
Via web browser
- Go to http://localhost:27062/dashboard/controllerbinding.html while SteamVR is running
- Select
VRChat
from the list of applications
Via VRChat
Glossary
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 official docs but with some edits for clarity.
Control Source Modes
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
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 VRChat\VRChat_Data\StreamingAssets\SteamVR\actions.json
(Descriptions are community created)
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 | Opens the Main Menu | boolean | optional |
Quick Menu | Global | Opens the Quick Menu | boolean | optional |
Action Menu | Global | 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 | |
Advanced Controls | 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 |
Miscellaneous | 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 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 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 |
One Handed | 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 |
Udon | 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 |
Menu | 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 | Closes the Quick Menu | boolean | optional |
Drag | Menu | (?) | boolean | optional |
Action Menu | 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 | |
(?) | (?) | |||
Pose Data | Global | The 6-DOF position and orientation of a device tracked device. | pose | |
SkeletonLeftHand | Global | 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 | |
Gesture Activator (GA) | 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 | |
Gesture | (?) | |||
Gesture - Trigger Axis | Global | vector1 | optional | |
Gesture - Grip Axis | Global | vector1 | optional | |
Gesture Direct | Use Gesture (UG) | Used to directly set the integer values of GestureLeft/GestureRight | |||
UG - Neutral (Left/Right) | Global | Sets Gesture(Left/Right) to 0 (Neutral)
|
boolean | optional |
UG - Fist (Left/Right) | Global | Sets Gesture(Left/Right) to 1 (Fist)
|
boolean | optional |
UG - Open (Left/Right) | Global | Sets Gesture(Left/Right) to 2 (HandOpen)
|
boolean | optional |
UG - Point (Left/Right) | Global | Sets Gesture(Left/Right) to 3 (FingerPoint)
|
boolean | optional |
UG - Peace (Left/Right) | Global | Sets Gesture(Left/Right) to 4 (Victory)
|
boolean | optional |
UG - Horns (Left/Right) | Global | Sets Gesture(Left/Right) to 5 (RockNRoll)
|
boolean | optional |
UG - Finger Gun (Left/Right) | Global | Sets Gesture(Left/Right) to 6 (HandGun)
|
boolean | optional |
UG - Thumbs Up (Left/Right) | Global | Sets Gesture(Left/Right) to 7 (Thumbsup)
|
boolean | optional |
Gesture Wheel (GW) | 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 1 (Fist) and 0 (neutral) after release
|
boolean | optional |
GW Cancel Open (Left/Right) | Global, Act, 1H | Sets the current gesture to 2 (HandOpen) and 0 (neutral) 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 VRChat SteamVR Bindings page.
Default Bindings
To reset your bindings to default, navigate to the VRChat SteamVR Bindings page and select Activate
on the official Default Bindings available for your controller.
Binding editing page
Navigate to the VRChat SteamVR Bindings page and select Edit
on the current Binding.
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.
Adding new inputs
TODO
TODO
Creating Chords
TODO
Deadzones
To change the deadzones on control sources like Trackpads & Joysticks, open their input settings and adjust the values to your liking. DeadZone
is what you'd expect and Max Zone Percentage
determines how far from the center of the control source is 100% value.
Curve Exponent
This exponent value is applied to change how speed scales on the final relative position between the Deadzone and Max Zone.
Speed = Value^Exponent
Trigger thresholds
TODO
Changing haptics
Most control sources on the default bindings have an input setting for Haptic Amplitude
. To turn haptics off, you'll need to go through every control source input setting on the controller and set Haptic Amplitude
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 Haptics
button in the center of the Global action set & change Left/Right Hand Haptics
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. [1]
A functional use case would be setting action menu to Single
and quick menu to Double
; this will introduces a small delay after the single
press input which can be interrupted by a double
click to open the quick menu without accidentally opening the action menu.
Controller info & fixes
All controllers
Various fixes that are potentially globally applicable.
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.
Path: Action Menu ➜ Options ➜ Avatar ➜ Gestures
TODO: GIF navigating to toggle in action menu
Double tap is opening the Main Menu
This feature was introduced with Input 2.0. You can disable it in the 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 Controls section of the Main Menu
Reverting to old finger tracking
If you prefer the old finger tracking method, navigate to the Quick Actions section of the Action Menu and enabling Legacy fingers. (per-avatar basis)
Path: Action Menu ➜ Expressions ➜ Quick Actions ➜ Legacy Fingers
TODO: GIF navigating to toggle in action menu
Tracking breaking in SteamVR Dashboard
This is due to a SteamVR feature called Keyboard privacy introduced in SteamVR 2.7 which stops applications from seeing device positions while the Steam keyboard is visible. In SteamVR settings navigate to
Dashboard
and setKeyboard Privacy
to Disabled.Currently this safety feature can only be disabled in the SteamVR Beta. 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
(username)/Documents/steamvr/input
and delete thesteam.app.438100_controlType.json
of the affected controller type. Restart VRChat to generate new files.
Vive Wands
Advanced Controls
Under the Official Bindings for Vive Controllers you can choose between
Default Bindings
&Default Advanced Bindings
.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 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 Deadzones to change this.
Accidental jumping
With a mix of adjustments to Overlap percentage & 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
interact
action and there's is no way to restore pre-input 2.0 functionality of pose via Grip without sacrificing other functionalities.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
Gesture Wheel - Disable Move
AndGesture Wheel - Disable Rotate
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.Grip isn't doing hand open / Isn't clearing gestures
You're likely missing the
Gesture Wheel Cancel Open (Left/Right)
actions on your grips as a Button clicks.
Index
Easier Object holding
TODO
HP Reverb G2
TODO
TODO: More controller types.