Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Description

Version

Hand Engine
3.2.0-LITE
Steam Desktop Client
latest
SteamVR
2.7.4
StretchSense Driver Add-On for SteamVR (Included with StretchSense SteamVR App installer)
latest
StretchSense SteamVR App
0.6.0
VRChat Creator Companion (optional)
2.3.2

Hardware

The below optional hardware may improve your VRChat experience:

Description

Image

Mini Wireless Bluetooth Gamepad VR Controller (optional)
Mini-Wireless-Bluetooth-Gamepad-VR-Controller-Remote-Pad-For-IOS-Android-Smartphone-PC-Laptop-Game-Accessories.jpg_.pngImage Added

General Notes

As of VRChat 2024.3.1, this has some built in finger touch gestures that may interfere with the StretchSense SteamVR App button emulation. In particular, it seems like the activation detection for held objects is performed by the contact distance between the index finger and thumb and this is independent of the grip button being pressed down.

Warning

In v0.6.0 of the StretchSense SteamVR App, there is a known issue when OSC apps and drivers like VRCFaceTracking (VRCFT), Virtual Motion Tracker and Double Hip Tracker are used with VRChat and the StretchSense SteamVR App and OpenGloves SteamVR add-on. You must change these OSC apps to use different ports than 9000. You must also configure VRChat to use these updated ports. See more in the OSC Port Collisions with VRChat section of this guide.

SteamVR Controller Profile

...

Pose

Button Name

Action

Type

Description

interact-idle.png

Idle

Make a relaxed pose and move your fingers between being fully extended to a slightly relaxed curled pose. This represents no buttons being pressed.
grab.png

Grip

Grab objects in world

Status
titleScalar: 1.0
*

Make a finger gun pose with your thumb pointing upwards and your middle, ring and little fingers curled.
Note
Don’t squeeze too hard to avoid overdriving the glove sensors.
trigger.png

RT

Activate objects and UI in world

Status
titleScalar: 1.0
*

Point gesture with thumb pointing upwards. Fully curl in your index finger, as if you were pulling a real trigger.
Note
Avoid squeezing your index finger too hard as it will make it harder to repeat the gesture.
Info
In VRChat 2024.3.1 or later the index finger curl instead of the trigger button controls the activation threshold for held objects.
menu.png

Menu

Toggle SteamVR Dashboard

Status
colourGreen
titleLONG PRESS

Touch your little finger to your thumb, with your thumb resting on the middle part of your little finger. Keep your other fingers extended. This gesture activates the SteamVR Dashboard. Train it so it can be pressed accurately. You may need to go back and train the idle pose again to stop it accidentally triggering.
Note
Bind this button in the SteamVR Dashboard Controller Bindings to avoid accidentally activating it.
primary-a.png

A Button

Jump

Status
colourBlue
titleSingle

Touch your middle finger to your thumb, with your thumb resting on the middle part of your middle finger. Keep your other fingers extended.
secondary-b.png

B Button

Quick Menu
Udon Menu

Status
colourGreen
titleLONG PRESS

Status
colourYellow
titleDouble PRESS

Touch your ring finger to your thumb, with your thumb resting on the middle part of your ring finger. Keep your other fingers extended.

Using Third Party Gamepads

...

VRChat supports keyboard and gamepad input natively while running in the foreground. For XInput compatible gamepads it is possible to use and remap these in SteamVR, using the same approach as for virtual Index Controllers. These can be used at the same time while the StretchSense SteamVR app is running.

This can free your hands for improved performance if you are using an avatar with a complex gesture set to drive facial animations, props or if you are planning on playing games in VRChat worlds that require high precision or movement.

It is possible to use a small third-party gamepad that is detected by Steam to achieve better joystick performance and to have physical buttons for things like opening and selecting items from the VRChat radial action menu.

Gamepad SteamVR Setup

  1. Turn on the gamepad and put it in pairing mode, according to the manufacturer’s instructions.

  2. Go to Windows Settings → Bluetooth & devices → Devices → Add device.

  3. Select Bluetooth when prompted for the kind of device to add.

  4. Once the device is connected, in the Windows toolbar, search and run Set up USB Game Controllers.

  5. Calibrate the joystick on the game controller (if your manufacturer’s device manual has hardware calibration instructions do this first).

  6. Open SteamVR and check the gamepad shows up in the SteamVR status window alongside your trackers and headset.

  7. Proceed to setup SteamVR bindings for VRChat. There are no default bindings available so you will need to create new ones from scratch.

  8. In the StretchSense SteamVR App, train a new model that excludes any gestures for button actions that have been mapped to the gamepad. We recommend training a model that has Trigger, Grip and Menu to improve stability while using the gamepad in that hand.

Gamepad SteamVR Bindings

We recommend using the following SteamVR bindings for VRChat. Additionally binding the Menu (Combined) action will allow all 3 menu types in VRChat to be triggered from a single button, leaving the other gamepad buttons free:

Screenshot 2024-09-06 113712.pngImage AddedScreenshot 2024-09-06 113909.pngImage Added
Screenshot 2024-09-06 113925.pngImage Added

Tip

Check the Return bindings with left hand under the Extra Settings tab to allow the left-hand radial menu to be navigated using the gamepad’s left joystick.

VRChat Hand Skeleton

Under the hood, VRChat uses the Mixamo Y-Bot skeleton for its animation retargeting. Avatars rigged and weight painted to this skeleton will have their hands look the best when SteamVR skeleton data is applied to the hands. Other skeletons, especially those ripped from other games may not have their fingers animate correctly.

Optionally, avatar creators can upload their avatar to Mixamo and use its auto-rigging feature, then download the resulting FBX to get the fingers looking optimal in the VRChat Creator Companion.

https://sketchfab.com/3d-models/y-bot-from-mixamo-f114e5b0bd2141119544756530560e48

Troubleshooting

Missing Required Bindings

...

Using SlimeVR, Mocopi or Third-Party Straps for VRChat

Follow our /wiki/spaces/ENG/pages/509739024 OpenGloves Configuration Guide to configure the OpenGloves SteamVR add-on to work with your tracker and strap combination.

OSC Port Collisions with VRChat

Adjust In StretchSense App for SteamVR v0.9.0 or below, you may need to adjust apps like VRCFaceTracking to use a different OSC port other than 9000.

Changing OSC port in VRCFaceTracking

...

Changelog

Version

Publish Date (YYYY/MM/DD)

Add clarification about version required for OSC port collision fix.

v1.1.1

2024/12/02

Add guide for using gamepads and Studio Gloves together

v1.1.0

2024/09/06

Add note about OSC port collisions with OpenGloves

v1.0.1

2024/08/29

Initial version.

v1.0.0

2024/08/26