a fast, feature-rich krunker client written in typescript

Download: Windows (x64) - Mac (x64) - Linux (x86_64 AppImage) - Linux (i386 AppImage) - Other

• very good performance with additional performance enhancing settings
• highly customisable, many different settings
• hides ads by default (can be disabled)
• resource swapper (css, sounds & all other assets)
• userscript support
• discord RPC (gamemode, map, class & skin)
• customisable matchmaker (Gamemode, Region, Min/Max players, Time)
• quick class switcher using #hiddenClasses
• built-in hotkeys: more about them here
• maintained & open source

• all client specific features can be turned off to ensure maximum performance
  • once a feature is disabled, none of it code runs
  • for example, while 'Discord RPC' is off, crankshaft does not even import the discord-rpc library.
• written in typescript
• secure: web security is on, the remote module and nodeIntegration are disabled
• splash screen is not a separate window, shows only while krunker is actually loading.
• doesn't automatically open free spin urls in browser
  • you can open them in a new window, in browser or not open them at all
• Discord RPC: if enabled, only updates while you're not actually in game. Does not use setInterval like other clients.
• no-compromise mac, linux and windows support
• only 4 dependencies

• any .js file in %APPDATA%/crankshaft/config/scripts will be considered a userscript and executed if enabled in settings.
• There are a few official/example userscripts:
  • keystrokes.js: shows WASD, shift, space and 2 configurable keys on screen.
  • autospectate.js: automatically joins game as spectator if turned on
• all userscripts are disabled when they are first added.
• %APPDATA%/crankshaft/config/tracker.json is used to keep track of enabled userscripts.

If you want to write a userscript or learn more about them, read the Documentation

Use userscripts at your own risk, the author(s) of this client are not responsible for any damage done with userscripts because the user is the author of the script. Do not write or use any userscripts which would give the user a competitive advantage.

Press Alt to show electron menu. Here you can find all hotkeys.
standard hotkeys like zooming, copying/pasting and devtools also included.
Client's hotkeys:

• F5: reload
• F6: find a new match,
• F7: copy game link,
• Ctrl+F7: join game from clipboard
• F12: devtools (alternative hotkey)

a customisable matchmaker (with GUI settings!) that you can use alongside/instead of the regular F6

• from version 1.9.0, crankshaft will no longer support Documents/Crankshaft for configuration.
• make a backup of Documents/Crankshaft before updating.
• crankshaft 1.9.0 will auto-migrate the folder, but there's a very small chance it could fail while moving/copying/deleting the files, and you'd lose your settings, swapper & scripts.
• this is due to inconsistent read/write permissions for users whose Documents directory lives inside of OneDrive or has been otherwise moved.
• crankshaft 1.9.0 will add quick-open buttons for the new directories & files, as they are harder to access.

1. you have to have git, nodejs, and pnpm installed.
2. installation:
   • git clone https://github.com/KraXen72/crankshaft
   • cd crankshaft
   • pnpm i
3. building from source: pnpm dist

1. follow previous steps 1 & 2
2. make your changes + running from source: pnpm start/pnpm dev (rebuilds on changes, refresh krunker with F6)
   • make sure to run the code through the configured eslint before contributing. (vs code will enable it if you have the extension)
3. after your changes, try it out with pnpm testbuild - this will minify the code & run the app.
   • until automated tests are added, try to manually test it works even after the code is minified. if it does not, you're probably doing something wrong

• please report any bugs/feature requests in the Issues.
• feel free to submit pull requests, they will be merged as long as they support the client ideology.

• Creepycats released Gatoclient, which was based on top of idkr.
• Crankshaft was built on top of Gatoclient lite, an app.asar mod optimizing Gatoclient by LukeTheDuke.
• Very little code remains, as Crankshaft was rewritten in typescript & more features were added.
• Gatoclient was later rewritten, implementing some code from Crankshaft too.
• other acknowledgments
  • wa/paintingofblue - matchmaker implementation
  • Commander/asger-finding (AKC client) - resource swapper implementation
  • Tae - awesome logo for the client <3

You can support ongoing development & maintainance by donating. All donations are highly appreciated! <3