WhiteKnuckleVR

White Knuckle VR

A full 6DOF VR conversion for White Knuckle, the speed climbing game from Dark Machine Games.

Features stereo rendering, roomscale movement, and 6DOF gesture-based motion controls. The philosophy of this mod is that it should be completely on-par with the physics-based gameplay of the vanilla game. All VR interactions work as inputs into the existing physics system, meaning that the player moves in exactly the same way as in vanilla. The only difference is that you are using your hands to climb and jump. This also means that buffs & debuffs should all work right out of the box.

Physical item interactions are not yet supported. This is something I'd like to add in the future, but it will likely require significant effort.

Installation

1. Install through Thunderstore
2. Activate your VR runtime (OpenXR or SteamVR), and launch the game. The game will launch once in flatscreen. Close the game.
3. Launch the game with your VR runtime active. It should launch into VR.

The first launch writes three config files into BepInEx/config/. See The VR settings menu.

Finding your game folder: in Steam, right-click White Knuckle → Manage → Browse local files.

Playing in flatscreen mode

Set activateVR to false in BepInEx/config/VRToggle.json and relaunch. The game will launch without the VR mod active.

Controls

Right controller

Control — Action

Grip — Grab a handhold

Trigger — Interact with buttons and levers; pick up items; use a held item

A — Jump

B — Quick-pocket right / Hold to drop item / Cancel in menu or terminal

Stick — Turn (left/right). Smooth or snap, set in the VR settings menu.

Stick click — Toggle crouch. Hold to open the pause menu (toggle crouch mode only).

Menu button — Maps to the gamepad Select button

Left controller

Control — Action

Grip — Grab a handhold

Trigger — Interact with buttons and levers; pick up items; use a held item

X — Open / close inventory. Hold to open the pause menu (toggle inventory mode only).

Y — Quick-pocket right / Hold to drop item

Stick — Walk and strafe. Also climbs, unless climbMode is set to Gesture Only.

Stick click — Sprint

Menu button — Pause / Open Menu

Gestures

Gestures allow you to move and climb using physical movements, but you can achieve most of these movements with button presses as well. You can turn off or tweak each gesture's activation threshold in ModParameters.json.

Climbing

While gripping handholds, your hand effectively operates as your movement joystick. Your body moves opposite your arm:

• Pull your hand down to climb up
• Move your hand left to climb right
• Pull your hand towards your chest to swing forward
• Extend your hand to move away from the handhold

There is a dead zone around a neutral, where your VR movement will be none.

Set climbMode in the VR settings menu to choose:

• Either (default) — use arm gestures to climb, but arm gestures can be overridden by using the left joystick
• Gesture Only — use arm gestures to climb, joystick is inactive
• Joystick Only — vanilla stick climbing, arm gestures are inactive

Dyno / Wall Jump

While gripping the wall, you can flick your hand downwards and release the grip button to launch off of it. If you move your arm down in a diagonal, you will jump off the wall opposite to the direction of the diagonal. If you are holding the wall with two hands, you'll need to do this with both hands, or release one hand and dyno with the other. You can also jump off the wall by pressing A.

Jump (on the ground)

Flick both hands upwards to jump off the ground. You can also jump off the ground by pressing A.

Sprint

Make a mock-running motion with your hands to sprint. You can also sprint by clicking the left joystick.

Physical crouch

Crouch in real life to crouch in-game. Resetting your VR view resets your "standing height", which allows you to play in standing or seated mode.

Throw / drop an item

While holding grip, make a throwing motion, and then release the grip button, to throw or drop an item.

Hand swap

While holding an item, bring your hands together and press both grips at the same time to pass it between your hands.

Items

X opens and closes your inventory. Time slows down while it is open by default.

While holding an item, you will see a laser pointer showing where the item is pointing. Press trigger to activate the item, or hold it for charged attacks.

The VR settings menu

Pause in-game to access the VR Settings screen. More settings are available in 3 json files in BepInEx/config/.

VRToggle.json

This file allows you to turn on or off the mod, or deactivate motion controls (to use a keyboard + mouse or gamepad).

Key — Default — Meaning

activateVR — true — set to false to disable the VR mod

useMotionControls — true — set to false to play in VR, using either keyboard + mouse or gamepad controls

WhiteKnuckleVRSettings.json

These are the exact same settings available in the VR Settings menu.

ModParameters.json

Many tunable parameters are available in this file which affect the implementation of the motion & gesture controls. These aren't intended to be changed for normal play, but I'll explain the most useful parameters below.

Key — Default — Meaning

reachMultiplier — 6 — A multiplier allowing you to reach past your physical hands. It is required for your VR reach to match your reach in the vanilla game.

vrHandScale — 1 — Size of hand sprites

heldItemScale — 1 — Size of held items relative to hand size

| gripScheme | auto | auto uses the trigger on Index and the