You are viewing a potentially older version of this package. View all versions.
WKSR-WKRace-0.7.0 icon

WKRace

Race others through the same seeded White Knuckle world: live splits, an opponent ghost, ranked matchmaking, lobbies and practice against your best. Includes the WKSR client.

By WKSR
Date uploaded 2 days ago
Version 0.7.0
Download link WKSR-WKRace-0.7.0.zip
Downloads 10
Dependency string WKSR-WKRace-0.7.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305
prideunique-ImuiBepInEx-1.0.1 icon
prideunique-ImuiBepInEx

Library used for building UI

Preferred version: 1.0.1
MonkSilly-WKLib-0.3.0 icon
MonkSilly-WKLib

A modding library, with almost everything you could possibly need

Preferred version: 0.3.0

README

WKSR: White Knuckle SpeedRun

Race other people up the same White Knuckle climb. Both of you get the exact same seeded world, you see each other's splits as you go, and your opponent climbs next to you as a ghost.

What you get

  • Ranked races against whoever is searching, with a rating.
  • Friendly lobbies: send a friend a code and race them.
  • Practice: solo runs on any seed. Your best run on each seed comes back as a ghost to beat.
  • WKSR, a small app that sits next to the game. It finds matches and shows your splits and results. It comes with this package and opens when the game starts.

Getting started

  1. Install this package with your mod manager. BepInExPack comes with it.
  2. Press Start modded. WKSR opens next to the game.
  3. The first time, WKSR asks for a racer name. Other players will see it.
  4. For ranked races, press LINK STEAM once. Steam's own sign-in page opens in your browser; WKSR never sees your password.
  5. Press FIND GAME, or SOLO to practise.

Always start the game through your mod manager or WKSR's LAUNCH GAME button. Starting it from Steam directly doesn't load mods for this game.

The rules

  • One run each. No restarts during a race.
  • If you die, you lose, even if you were miles ahead.
  • First to the top wins.
  • If someone's game or connection drops, the race pauses for up to 60 seconds.

Keys

F9 Start your run (in practice: twice for a fresh run)
F10 Twice to forfeit
F7 / F6 Hide the splits / the ghost

Something wrong?

Press REPORT BUG in WKSR, add a screenshot, and it comes straight to us.

Privacy

WKSR connects to our race server in the EU. It keeps your racer name, rating and race results, and nothing is sold or shared. The i button in WKSR shows exactly what is stored, and how to get a copy or have it deleted.

Made with AI

This mod and WKSR were built with an AI assistant (Claude), directed and play-tested by a human. It has been tested in real races and practice runs, and backed by close to 200 automated tests. If you find something that slipped through, REPORT BUG is the fastest way to tell us.

CHANGELOG

Changelog

0.9.4

Update to keep playing with others: 0.9.4 is not matched with 0.9.3.

  • CONNECT and DISCONNECT: the game only connects to the match server after you press CONNECT in the WKSR window, and it remembers that for the next start. Until then the window has UNRANKED only: solo runs work offline. DISCONNECT takes you offline again.
  • No first-start page any more. What the match server keeps is in the readme, and under OPTIONS, PRIVACY NOTICE.
  • Escape in a run closes the WKSR window together with the pause menu.
  • Timer check: the check on a timer that stands still while you move is switched off for now.
  • The mod's options (WKLib's mod list) no longer show the old WKSR program's settings or the test settings, and the mouse wheel scrolls faster there.

0.9.3

Everyone needs 0.9.3: it can't play with 0.9.1 or 0.9.2.

  • WKSR is now inside the game. There is no separate WKSR program any more. A WKSR button on the side of the game's main menu opens RANKED, LOBBY, UNRANKED, LEADERBOARDS and OPTIONS, each with a BACK button. The same button is in the pause menu of a run, with the match, its splits and FORFEIT. Start the game from your mod manager as before. The package now installs ImuiBepInEx and WKLib, which draw the menu.
  • Your player name is your Steam name, and your Steam account links by itself when the game runs through Steam: there is no LINK STEAM any more. If another player already has your name, yours gets a number. Your rating, record and times stay yours.
  • First start: the WKSR window first shows what the match server keeps and what other players see. The game connects to the match server after OK.
  • The game and its public test release: players on either one can be matched and can share a lobby.
  • Ranked solo: dying and restarting in the game stays a ranked solo run, on a new seed. Before, it turned into an unranked run for the rest of the session.
  • Timer check: a finished run is no longer refused when the check thinks the timer stood still. The time counts, and the run is marked for us to look at.
  • OPTIONS has the game's hotkeys, ghost opacity, EXPORT MATCH DATA and the privacy notice.
  • Not in this version: proximity voice chat, REPORT BUG, the mods window and the desktop shortcut. Bug reports go to the Discord (EXPORT MATCH DATA makes a file to send along).

0.9.2

  • Added a readme line

0.9.1

Everyone needs 0.9.1: it can't play with 0.9.0.

  • New WKSR layout: RANKED (1v1 and solo), LOBBY (create or join) and UNRANKED (solo with your own modifiers and seed). The options behind the gear hold voice chat, the game's hotkeys, ghost opacity, export match data, report bug, and CREATE SHORTCUT, which puts WKSR on your desktop so you can open it without starting the game first.
  • Ranked solo: a solo run hosted by the match server, with the ranked modifiers. The server picks the seed, and every restart in the game is a new run on a new seed.
  • Unranked solo: with a seed typed in, a restart runs that seed again; with no seed, every restart is a new random seed.
  • Leaderboards (the trophy): ranked 1v1 by rating and by fastest time, and ranked solo by fastest time. One row per player, their best, with the version it was set on. Search for a name, or FIND ME. The boards start empty with 0.9.1: you are listed once you play ranked on it.
  • Replays: the 20 fastest runs of a time board can be run against as a ghost (PLAY AGAINST). After a run, SAVE REPLAY keeps its replay on your PC; UNRANKED, SAVED REPLAYS lists them with their seed and modifiers, to run against.
  • Mods list: the game tells WKSR which other mods are loaded, and the match server checks them against its list of approved mods. Every mod is approved to start with. Once a mod is marked as not approved, a game with it gets no ranked 1v1 and no ranked solo; lobbies and unranked solo runs need ALLOW UNAPPROVED MODS ticked, and stay unranked. WKSR names the mods concerned.
  • Times follow the game's own timer. The time in WKSR and on the overlay is the game's timer, to the hundredth: shortcut sections count three times over, as in the game. A 1v1 is still won by whoever finishes first; a party ranks finishers by their timer. Solo, pausing the game stops the clock; in a match it keeps running.
  • Competitive mode counts as unlocked while the mod is loaded, so every player can set up the competitive options.
  • A closed or crashed game ends the run in WKSR (in a match, that is a forfeit).
  • Hotkeys for start/ready, forfeit, splits, ghosts and chat can be changed in WKSR's options.
  • Players online is live, and WKSR says when a newer version is out. If the match server can't be reached, it asks Thunderstore for the newest version number.
  • LAUNCH GAME works after the game opened WKSR. (Steam kept counting the game as running while that WKSR was open.)
  • Performance: the in-game overlay and the level seeding do far less work each frame.
  • The flare gun of the "hunted" trinket always starts on the same place in the inventory, just right of the middle.
  • Deep Storage food now also makes the first Deep Storage level one with a food bar or pill bottle, and keeps the secret room open.
  • Perks: the Chute to Habitation interlude and the Hadal Diver room offer both Rabbit DNA and Pulse Organ. A refresh no longer brings back the guaranteed perk it just showed.

0.9.0

Party matches, proximity voice chat, modifiers, a ready check and text chat. Everyone needs 0.9.0: it can't play with 0.7.

  • Party matches: lobbies of up to 15 players, started by the host. One life and no restarts: die and you're out. The match ends when everyone is done, or 5 minutes after the first finish. In-game position (Mario Kart style, "?" on a shortcut), gaps at each split, and a ghost for every player.
  • Proximity voice chat: talk to your lobby, and in a match to the players within 65 m, who hear you from where you are. Push to talk (any key or mouse button) or open mic. WKSR's voice settings pick the microphone and both volumes, and you can mute anyone. A speaker symbol shows over whoever is talking. Voice is never recorded.
  • Lobbies are rooms now: they stay open after a match for a rematch, and the next player takes over if the host leaves.
  • Modifiers: CREATE LOBBY picks 1v1 or party, artifact bans (1v1) and curated seeds (Deep Storage food, perks, items, separately). SOLO has its own picker. Ranked always uses all of them.
  • Ready check in every match: press F9 or READY within 60 seconds once everyone has loaded.
  • Chat in lobbies and matches: T in the game, or the chat box in WKSR. /mute and /unmute hide someone.
  • Deaths are announced with the game's own death lines ("FUSED INTO THE MASS").
  • Ghost opacity slider in WKSR.

0.7.4

First release on Thunderstore.

  • The README lists what every match world guarantees (fair seeds).

0.7.2

  • WKSR, the client, is included and opens with the game.
  • WKSR never starts the game by itself; LAUNCH GAME starts it modded the way mod managers do, with the profile that has the mod.
  • First start: WKSR asks for a player name, starting from a random one.
  • Matches: one run each. Restarts are off, and a death ends the match (the survivor wins).
  • Practice: solo runs on any seed, no countdown, restarts as in singleplayer, and your best run on each seed as a ghost.
  • Ranked matchmaking with provisional ratings, friendly lobbies with join codes, artifact bans, a linked Steam account for ranked.
  • REPORT BUG sends bug reports with screenshots from WKSR.