Lock yourself or your friends into positions in VR! Want your friend to keep his or her paws hands behind his back? No problem. Chat wants to make you stand on one foot for 60 seconds? Easy. Have to bend over and touch your toes or you lose some kind of game? It's possible, with punishments consequences for failing.
You can be locked via clicking a button locally, or locked remotely via OSC integration (a friend grabbing your StayPutVR-compatible cuffs, for example), at which point your movement will be locked. Once locked, if your devices move too far away from their current position there'll be conseqeuences of your chosing: an audio warning, an OSC message that drives animation on your avatar, or even external messages to OSC-compatible applications, like PiShock.
Cooldown timers, audio warnings, and PiShock intensity are all configurable, and the control remains completely and totally on your own computer, with you choosing who can control your avatar via VRChat's avatar interaction system.
Compatible prefabs:
Gumroad: foxipso.gumroad.com/l/stayputvr
Jinxxy: jinxy.com/foxipso/StayPutVR
Use code github for 10% off!
StayPutVR is open-source and created by Foxipso. You can download the code in this Github repo and use the application for free!
You then need a compatible avatar. You can use my public test avatar (Foxipso Base) or add it to your own.
The easiest way to add it is to use my 3D cuffs and collar, which comes complete with a HUD and poseable locks that your friends can set. Using my prefab also supports me and my work!
foxipso.gumroad.com/l/stayputvr
- Install the application
- Start SteamVR and StayPutVR
- Make sure you see "Connected to Driver"
- Go to the Devices tab. Move each device to identify it and assign a role using the drop-down.
- If you wish to integrate with VRChat or another OSC application, go to the OSC tab, verify the settings, and click Enable OSC.
- Experimental [I need testers]: For Twitch integration, go to the Twitch tab, set up your Twitch application credentials, and configure chat commands.
- Configure the countdown timer, safe zones, and other settings like PiShock if you wish.
- For VRChat, simply lock your cuffs or collar. For manual locking: lock individual devices on the Devices Tab, or set devices to "Will Lock" and then click "Lock All Included Devices" to lock them all at the same time!
- Move your devices and you should get a warning if you're out of bounds, or a shock if you're out of bounds and the device is set to shock!
In VRChat, you can now use my public test avatar (Foxipso Base), add it to your own avatars using my prefab, or make your own custom objects that utilize the OSC integration.
- Position locking for any and all VR tracked devices you select
- Configurable boundary radii:
- Safe zone: You're complying beautifully.
- Warning zone: You're straying too far--watch out!
- Non-Compliance zone: Now you've done it.
- Disable zone: Safety threshold for tracking errors or if you wish to stop consenting--auto unlocks and stops any output!
- Integration with VRChat, PiShock, OpenShock, ButtplugIO and Twitch (experimental)
- Integration with Sacred's VRCBiteTech (get shocked when bitten!)
- Audio cues for warnings and boundary violations
- Configurable timers for automatic unlocking and shock cooldown
- Multi-shocker support (OpenShock & PiShock)
- Supports placement spheres in the prefab
- Can stop your locomotion in VRChat when locked (recommended with placement spheres)
- Emergency stop mode
- Immediately unlocks all devices and prevents any further shocking
- Requires a button push in the UI to go back to normal operation
- Can also be activated via an OSC stretch param (>0.5). Integrates with the StayPutVR prefab for a tag you can yank quickly
View the wiki for more information.
OpenShock integrationDone!Multiple shockers (OpenShock)Done!Multiple shockers (PiShock)Done!PiShock WebSocket v2 supportDone!Emergency stop supportDone!ButtplugIO integrationDone!- DG-Lab integration
Placement spheres/hints (attempt #2)Done!- In-world audio emitters (attempt #2)
- Visual Studio 2019 or higher with C++ desktop development workload
- CMake 3.15 or higher
- Clone the repository
- Open a command prompt in the project directory
- Run
cmake -B build - Run
cmake --build build --config Release - Install with
cmake --build build --target install --config Release
1.3.0 - ButtplugIO integration (11/3/2025)
- Added ButtplugIO integration (experimental)
1.2.0 - PiShock WebSocket v2 support (10/27/2025)
- Added PiShock WebSocket v2 support (faster response times, future multi-device support)
- Added support for multiple shockers using PiShock WebSocket v2
- Fixed a bug where warning OSC messages ("Locked Warning", enum 3) weren't being sent
1.1.1 - Bug fixes (10/12/2025)
- Fixed bug where StayPutVR driver wouldn't load when launching SteamVR via SteamLink or Pico Connect
- Fixed bug where PiShock warning and disobedience durations were shown as 0.0-1.0 units instead of 1.0-15.0 seconds
- Added shock cooldown timer for both PiShock and OpenShock
1.1.0 - Multi-shocker support (9/21/2025)
- Adds support for multiple shockers using OpenShock
- Adds emergency stop mode (OSC message)
1.0.3 - OpenShock Support (Beta) (8/25/2025)
- OpenShock Integration: OpenShock support equivalent to PiShock
- Fixed a bug where the default OSC receive port was 9005 instead of 9001 (VRChat default)
1.0.2 - BiteTech support (8/24/2025)
- BiteTech Support: Added support for BiteTech devices, including bite detection and disobedience actions.
1.0.1 - Performance & Stability Release (8/23/2025)
- VR Performance Improvements: Eliminated potential blocking operations in VR driver main loop
- SteamVR Crash Fix: Resolved
VRApplicationError_IPCFailedcrashes caused by IPC timeouts (after headset reconnects)
1.0.0 - Initial release (8/8/2025)
This project is licensed under the Apache 2.0 License. See LICENSE for details.
- Based on the OpenVR driver example
- Special thanks to all contributors and testers