OneHand

One hand. Two tools. Keep climbing.

A challenge mod for White Knuckle Beta 0.61. Choose which hand to keep before a new run, then climb and use every item with that hand alone.

Features

• Choose left or right: set your difficulty and trinkets, press Play, then answer "Which will you keep?" The selected hand stays for the entire run.
• 2.5x stamina: increased stamina capacity and all positive stamina gains, including recovery from food, perks and regeneration. Stamina costs stay the same.
• Two quick slots: keep two items ready and switch between them in your remaining hand. Items retain their normal state and ammunition.
• Piton and hammer support: place the piton, switch to your hammer, then hammer it in with the same hand.
• Minimalist presentation: native game font, underlined choices, trembling letters and yellow/red hover effects. No extra bottom panel.
• A seamless start: after your choice, "Choice made" trembles and fades into black while the run loads. The selection sound continues across the transition.
• Saved runs: continuing a saved run restores your hand and quick-slot selection without asking again.

Installation

Mod manager

Install OneHand through Thunderstore Mod Manager or r2modman, allow the BepInEx dependency to install, and launch the game with mods enabled.

Manual

1. Install BepInExPack 5.4.2305 for Unity Mono if you do not already have it.
2. Close the game and copy the package's BepInEx folder into your White Knuckle game folder, next to the game executable.
3. Confirm that the plugin is at BepInEx/plugins/OneHand/OneHand.dll.
4. Launch the game, choose your difficulty and trinkets, and press Play.

When updating manually, replace the old DLL instead of keeping a second copy in plugins. The sound is embedded in the DLL; no separate audio installation is needed.

Controls

Set up two tools

1. Pick up a piton with your remaining hand and press 1 to store it.
2. Pick up a hammer and press 2 to store it.
3. Press 1 or 2 to equip the corresponding item. Switching returns the current item to its slot.
4. Press the same key again to free your hand for climbing.

Release your grip before equipping an item. Normal item restrictions still apply; a switch may wait for reloading or item use to finish.

Configuration

After the first launch, settings are stored in BepInEx/config/ilya.whiteknuckle.onehand.cfg.

To disable the mode, close the game and set Enabled = false in the [Run] section. To uninstall manually, remove BepInEx/plugins/OneHand.

Compatibility and support

Built for White Knuckle Beta 0.61 with BepInEx 5 (Unity Mono). Other game versions and mods that replace hand, inventory, stamina or run-start behavior have not been verified.

For bug reports, include your game version, the selected hand, steps to reproduce the problem and BepInEx/LogOutput.log from that run. Plugin messages are tagged OneHand.

Source code and build instructions are included in Source. Russian documentation is included in README_RU.md.

0.2.3

• Added Thunderstore package metadata, a 256x256 icon and an English README.
• Starts asynchronous scene loading on the next frame after a hand is confirmed, without waiting for audio to finish.
• "Choice made" uses moderate letter jitter and a smooth fade into black (0.2-second hold, 1.5-second fade).
• Scene assets load during the fade; activation is released after the text fades, independently of audio length.
• Audio plays on its own persistent object across scene changes and cleans up when playback finishes.
• The confirmation overlay is removed when the new scene loads, preserving the new scene's cursor state.
• Continue and disabled mode retain their native loading path.

0.2.2

• Embedded the user's original 5.35095-second stereo 24-bit WAV in OneHand.dll.
• Plays once immediately after a hand is chosen, through the game's UI audio mixer.
• Shows "Choice made" in the native font on black while the sound plays in full, then starts the run.
• Locks selection during playback and ignores stale delayed starts if the selector is replaced or destroyed.
• No separate audio-file installation required; hovering, Back and Continue do not trigger the sound.

0.2.1

• Hovered hand text is yellow; the opposite hand text is red. Existing jitter strengths retained.
• Added an underlined top-left "back" button, white at rest and yellow on hover/focus.
• Back returns to the existing difficulty/trinket settings without starting a run.
• Back is included in keyboard/controller navigation; hand choices remain neutral while Back is focused.

0.2.0

• Hand choice moved to the native Play-to-scene-load boundary, after difficulty and trinket settings.
• Black full-screen selector: "Which will you keep?", underlined "left" / "right" in the native menu font.
• Per-letter jitter: moderate idle; almost still and faint red on hover; intense on the opposite choice.
• Mouse, keyboard and native controller navigation; Back/Escape returns to the existing settings.
• Single-use deferred Play prevents repeated clicks and skips hand selection for Continue.
• Removed the setup panel, F4 overlay and bottom quick-slot/stamina HUD.
• Short notices now use plain native-font English text without a background panel.
• Stamina capacity and all positive gains increased from x2 to x2.5; costs unchanged.
• Existing one-hand mechanics, native quick slots and saved-run flags retained.

0.1.0

• Initial test build targeting the supplied White Knuckle Beta 0.61 assembly.
• Pre-run left/right hand selection, locked for the duration of a run.
• Excluded hand input and scripted grabs blocked; its visuals hidden.
• Double player stamina capacity and all positive stamina gains.
• Two native pockets usable by the selected hand, with quick swapping.
• Native item state and CanDrop restrictions retained.
• Sequential piton placement and hammering, without automatic piton grabbing.
• Saved run mode/hand and current slot retained in session flags.
• Russian setup panel and a compact two-slot HUD.