Community:SteamVR Bindings: Difference between revisions

Latest revision as of 06:30, 20 November 2024

V · ECommunity-written content

The following was created by the community. It may contain material not directly endorsed by the VRChat team. To learn more, consider reading Contributing to the VRChat Wiki.

V · EThis page is a stub.

You can help the VRChat Wiki by improving it.
[Reason: Still missing guides & need more input from various controller types]

V · EThis page is a work in progress

This page is actively being worked on, information may be incomplete or out of date. You can help the VRChat Wiki by editing it.
[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

Open the main menu
Navigate to Settings
Go to Controls
Select Open SteamVR Input Bindings Panel

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
Activate Safe Mode	Global	Activates Safe mode	boolean	suggested
Toggle HUD	Global, 1H	Toggles HUD	boolean	optional
Cycle Nameplate Mode	Global, 1H	Cycles through 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 Stream Camera
Toggle Earmuffs	Global, 1H	Toggles Earmuffs	boolean	optional
Proximity Sensor	Global	When active, trigger AFK in VRChat	boolean	optional
Toggle Personal Mirror	Global	Toggles Personal Mirror	boolean	optional
Toggle Personal Mirror Grabbing	Global	Toggles grabbing on Personal Mirror	boolean	optional
Toggle Face Mirror	Global, 1H	Toggles 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 Avatar Debug Screen	boolean	optional
Toggle OSC Debug Screen"	Global, 1H	Toggles OSC Debug Console	boolean	optional
One Handed (1H)		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.

Additional input methods

To use additional 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 More Options and then you'll have access to additional input methods besides click.

Creating new inputs / Control sources

On any of a controller's existing control sources, you can create new inputs with a specific 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.

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 set Keyboard 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 the steam.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.

Related Canny

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 And Gesture 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.

Related Canny

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.

References

[:0-1] 1.0 ^1.1 https://github.com/OpenVR-Advanced-Settings/OpenVR-AdvancedSettings/blob/master/docs/SteamVRInputGuide.md

[2] ttps://docs.vrchat.com/docs/steamvr-input-20

[3] ttps://docs.vrchat.com/docs/input-20-faq

[1]

[2]

[3]

@@ Line 1: / Line 1: @@
 {{Noticebox/Community}}
+{{Stub|Still missing guides & need more input from various controller types}}
 {{Noticebox/wip|}}
@@ Line 10: / Line 11: @@
 ==Where==
-=== Standard method ===
+===Standard method===
-# Open SteamVR
+#Open SteamVR
-# Find '''Settings'''
+#Find '''Settings'''
-# Select '''Controllers'''
+#Select '''Controllers'''
-# Set '''Advanced Setting''' to '''Show'''
+#Set '''Advanced Setting''' to '''Show'''
-# Select '''Show Binding UI'''
+#Select '''Show Binding UI'''
-# Select '''VRChat''' from the list of applications
+#Select '''VRChat''' from the list of applications
-[[File:Accessing VRChat Bindings.png]]
+[[File:SteamVR Input - Accessing VRChat Bindings.png]]
-=== Via web browser ===
+===Via web browser===
-# Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
+#Go to http://localhost:27062/dashboard/controllerbinding.html while S'''teamVR is running'''
-# Select '''VRChat''' from the list of applications
+#Select '''<code>VRChat</code>''' from the list of applications
-=== Via VRChat ===
+===Via VRChat===
-# Open the main menu
+#Open the main menu
-# Go to Controls
+#Navigate to [[Settings]]
-# Select ""
+#Go to [[Settings#Controls|Controls]]
+#Select '''<code>Open SteamVR Input Bindings Panel</code>'''
 ==Glossary==
 {| class="wikitable"
-|+
+! Terms
-!Terms
+!Explanation
-!Explanation
 |-
 |Bindings
 |A complete set of bindings between inputs and actions that can be saved and shared in the Steam Workshop.
 |-
@@ Line 44: / Line 45: @@
 |Behavior that can be bound to inputs or chords, like movement, selection, or bringing up the camera or personal mirror.
 |-
-|Action Set
+|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.
+| 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
+|Control source
-|A specific actuator on a controller, like a joystick, trigger, button, or trackpad.
+|A specific '''physical''' actuator on a controller, like a joystick, trigger, button, or trackpad.
 |-
-|Control source mode
+| 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
+|}
+<sup>Mostly from the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs] but with some edits for clarity.</sup>
+===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
 |}
-From the [https://docs.vrchat.com/docs/steamvr-input-20#bindings-glossary official docs.]
+===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]]
-=== Adding new inputs ===
+===Binding editing page ===
-TODO
+Navigate to the [[Community:SteamVR_Bindings#Where|VRChat SteamVR Bindings page]] and select <code>Edit</code> on the current Binding.
-=== Double tap menu ===
+[[File:SteamVR Input - Editing Bindings.png|950x950px]]
-TODO
-=== Creating Chords ===
+===Changing input settings===
-TODO
+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.
-=== Dead zones ===
+[[File:SteamVR Input - Accessing Input Settings.png|border|800x800px]]
-TODO
-=== Trigger thresholds ===
+===Additional input methods ===
-TODO
+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.
-=== Changing haptics ===
+[[File:SteamVR Input - Additional Input Methods.png|1180x1180px]]
-TODO
-=== DPAD overlap percentage ===
+===Creating new inputs / Control sources===
-TODO
+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]]
-== Don'ts ==
+===Creating Chords===
-There's certain things you can do in bindings that can cause issues. Try to avoid these when possible
+TODO
-=== Multiple actions on per control ===
+===Deadzones===
-When you bind multiple actions like this, it stops them from functioning instantaneously and makes them a bit unpredictable. <ref name=":0" />
+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.
-(Image upload pending)
+[[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>
-A functional use case would be setting '''action menu''' to press and '''quick menu''' to double; it introduces a small delay on the action menu input which can be interrupted by a double click to open the quick menu without accidentally opening the action menu.
+[[File:SteamVR Input - Curve Exponent.png|400x400px]]</blockquote>
+===Trigger thresholds===
+TODO
-== Controller info & fixes ==
+===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.'''
-=== All ===
+===DPAD overlap percentage===
+TODO
-==== Can't do gestures at all ====
+==Don'ts==
-By default coming into the Input 2.0 update, gestures were set to disabled.
+There's certain things you can do to bindings that can cause issues. Try to avoid them when possible
-TODO: walkthrough showing how to enable them in the radial menu
+===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" />
-==== Disabling new hand poses / finger tracking ====
+[[File:SteamVR Input - Multiple actions per controller.png|alt=Bad vs Good method for multiple actions via one control source|800x800px]]
-TODO: add an image pointing out the toggle in the controls section of the main menu.
-==== Default & Community bindings ====
+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'''.
-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 ====
+==Controller info & fixes==
-In rare cases, a full hard reset of your bindings may be needed due to issues with SteamVR.
-TODO
+=== All controllers===
+Various fixes that are potentially globally applicable.
+<blockquote>
-=== Vive ===
+==== Can't do gestures at all====
-Vive is a little special, two default binding modes are available with different feature sets. (TODO: write about them)
+By default coming into the Input 2.0 update, gestures were set to disabled. You can enable them in them in the [[Action Menu]].
-==== No touch to move / Emotes are "sticky" ====
+<code>Path: [[Action Menu]] ➜ [[Action Menu|Options]] ➜ [[Action Menu|Avatar]] ➜ Gestures</code>
-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: GIF navigating to toggle in action menu</blockquote>
-==== Difficulty moving ====
+====Double tap is opening the Main Menu====
-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.
+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. <sup>(per-avatar basis)</sup>
-TODO: Recommended values for Simple & Advanced
+<code>Path: [[Action Menu]] ➜ [[Expressions]] ➜ [[Action Menu|Quick Actions]] ➜ Legacy Fingers</code>
+<blockquote>TODO: GIF navigating to toggle in action menu</blockquote>
-==== Accidental jumping ====
+====Tracking breaking in SteamVR Dashboard====
-With a mix of adjustments to Overlap percentage & Dead zone on the Trackpad DPADs, you can restore pre-Input 2.0 behavior.
+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>
+====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>
-TODO: Recommended values for both
+===Vive Wands===
+<blockquote>
-==== Grip isn't doing hand open / Isn't clearing gestures ====
+====Advanced Controls====
-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.
+Under the Official Bindings for Vive Controllers you can choose between '''<code>Default Bindings</code>''' & '''<code>Default Advanced Bindings</code>.'''
-TODO: image showing what the newly added button should look like
+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.
-=== Index ===
+====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>
-==== Easier item holding / Auto Hold ====
+====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>
-=== HP Reverb G2 ===
+====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, need users with more experience on other types.
+TODO: More controller types.
-== References ==
+==References==
 <references />
+[[Category:Guides]]

Anonymous

Search

Community:SteamVR Bindings: Difference between revisions

Latest revision as of 06:30, 20 November 2024

Where

Standard method

Via web browser

Via VRChat

Glossary

Control Source Modes

Input Methods

Actions

Walkthroughs

Default Bindings

Binding editing page

Changing input settings

Additional input methods

Creating new inputs / Control sources

Creating Chords

Deadzones

Curve Exponent

Trigger thresholds

Changing haptics

DPAD overlap percentage

Don'ts

Multiple actions per control source

Controller info & fixes

All controllers

Can't do gestures at all

Double tap is opening the Main Menu

Disabling finger tracking

Reverting to old finger tracking

Tracking breaking in SteamVR Dashboard

Hard Bindings reset

Vive Wands

Advanced Controls

No touch to move / Emotes are "sticky"

Difficulty moving

Accidental jumping

Physbone posing with grip

Unwanted Action Menu gestures

Grip isn't doing hand open / Isn't clearing gestures

Index

Easier Object holding

HP Reverb G2

References

Navigation

Wiki tools

Page tools

Categories