Need a hand?
Answers to the common questions first. Still stuck, or found a bug? Email support@bonkle.net - see what to include.
Installing on Windows
How do I install Bonkle?
- Download the zip.
- Right-click the zip and choose Extract All. Do not run the game from inside the zip.
- Open the extracted folder and start
Bonkle.exe.
There is no installer and no account. To update, download the new zip and replace the folder - your progress is stored elsewhere and stays. To uninstall, delete the folder (and %APPDATA%\Bonkle if you also want your progress gone).
Windows says "Windows protected your PC"
That blue SmartScreen box appears for new downloads that are not yet known to Microsoft. Click More info, then Run anyway. You only need to do this once per version.
Only do this for a zip downloaded from this website (bonkle.net or live.bonkle.net).
My antivirus blocks or deletes the game
Some antivirus tools are wary of new, unsigned games. Download again from this website, then add the game folder as an exception in your antivirus, or restore the file from its quarantine. If it keeps happening, email us the name of your antivirus and the message it shows.
Saves and the recovery code
Where is my progress saved?
On your PC in %APPDATA%\Bonkle (paste that into the Explorer address bar). Updating the game never touches it. To back it up by hand, copy that folder somewhere safe while the game is closed.
When you are online the game also keeps a cloud save of your progress on our server, so you can get it back on another device with your recovery code.
What is the recovery code and where do I find it?
Your online player (friend code, friends, ranks and cloud save) belongs to a secret key on your device. The recovery code is the way to take that player to a new PC or phone.
- Open your CHARACTER page and press RECOVERY.
- Choose to show your code and write it down (12 letters and digits, like
ABCD-EFGH-JKMN). Keep it private: anyone with it can take over your online player.
I have a new PC or phone - how do I get my progress back?
- Install Bonkle on the new device and make sure it is online.
- Open CHARACTER → RECOVERY and enter your recovery code.
- Your friend code, friends and ranks move over, and the cloud save is merged into this device. The game says when your progress has been restored.
After a recovery the old device's online player stops working there (it says the ID moved to another device), and you get a new recovery code - write it down again.
Lost your recovery code and your old device? Then we cannot move the player for you, because nobody can prove it is yours. Copying the save folder from a backup still works.
Can I start over?
Yes: open SETTINGS from the title screen and choose RESET PROGRESS. It restarts your campaign but keeps your online player and friends. To delete your online data too, see deleting your data.
Online play and servers
How do I play with friends online?
Open ONLINE and either host a lobby and share its join code, join a friend's code, or pick quick match for ranked games. On the FRIENDS page you add friends with their friend code (on your CHARACTER page) and invite them straight into your lobby. Versus, co-op campaign, co-op survival and 8-player battle royale all work online.
It says NO CONNECTION or SERVER NOT FOUND
- Check that your device is online, then press RETRY - the game also retries by itself.
- Bonkle talks to
play.bonkle.neton UDP port 27450. School, work and some public networks block that; try another network or a phone hotspot. - If Windows Firewall asks about Bonkle, allow it. A firewall or antivirus may also need an exception for the game folder.
- VPNs and very strict routers can block UDP. Try without the VPN.
Everything except online play keeps working while you are offline.
"Servers are busy" or "update the game"
Busy: all match servers are full for that mode. Try again in a minute, or host a lobby with a join code instead. Update: online play needs the same version as the server. Download the newest zip from this website - your progress stays.
How do I hide that I am online?
Turn on APPEAR OFFLINE in the settings or on the FRIENDS page. Friends then see you as offline; invites still reach you.
Controllers
Which controllers work?
Xbox, PlayStation and most USB or Bluetooth gamepads work out of the box; the on-screen hints switch to pad buttons as soon as you touch one. Two pads = two players on one PC. You can also share one keyboard: player 1 uses the arrows, player 2 uses WASD. All controls are on the home page.
My gamepad does nothing
- Connect the pad, then press any button on it in the menu.
- Unplug and re-plug it, or try another USB port or cable (some cables only charge).
- Bluetooth: pair it in Windows settings first, and close other apps that take over controllers.
- Still nothing? Email us the controller's name and how it is connected.
Purchases
Do I need to pay for anything?
No. This version of Bonkle has no real-money purchases on any platform. Coins, crates, skins, effects and battle items are earned by playing. Crates are never sold for money, and skins are cosmetic only.
Restoring purchases on iPhone / iPad (later)
If real-money items come to iPhone / iPad later, they are bought through the App Store with your Apple ID. A new or reinstalled device gets them back with the game's RESTORE PURCHASES button, and refunds go through Apple at reportaproblem.apple.com.
The game will not start or looks wrong
Black window, crash on start or very low frame rate
- Update your graphics driver (NVIDIA, AMD or Intel website, or Windows Update).
- Bonkle needs a graphics card or chip with DirectX 12 or Vulkan support. Very old laptops (around 2012 or older) may not have it.
- Laptops with two graphics chips: set the game to "High performance" under Windows Settings → System → Display → Graphics.
- Still black? Try the Vulkan renderer: open Command Prompt in the game folder and run
set LIMP_GPU=vulkanand thenBonkle.exe.
Report a bug
Email support@bonkle.net. The more of this you include, the faster we can fix it:
- What happened and what you expected instead.
- How to make it happen again: mode, world / level, what you pressed.
- Game version - in the game under SETTINGS (top right, e.g. "BONKLE 0.8.0 (BUILD 1107)", also SETTINGS → ACCOUNT → VERSION) - and device: Windows 10 or 11, graphics card, or iPhone / iPad model.
- A screenshot or short video if you can (Windows: Win + Shift + S for a screenshot, Win + G for a recording).
- For online problems: your friend code and roughly when it happened (with your time zone).
- The log text, if the game crashed or misbehaved (below).
Where are the logs?
Bonkle keeps a log of its last three runs on your device and never sends it anywhere (there is no crash reporter). On Windows:
- Close the game (the log of the run that misbehaved is then complete).
- Paste
%APPDATA%\Bonkle\logsinto the Explorer address bar and press Enter. - Attach
bonkle.log(the last run) to your email -bonkle.1.logandbonkle.2.logare the two runs before it, in case you started the game again since.
The log contains game messages, your nickname and online ids - nothing else about you. Do not send us your recovery code with a bug report.
System requirements
- OSWindows 10 or 11, 64-bit
- GraphicsAny GPU with DirectX 12 or Vulkan
- InputKeyboard, or 1-2 gamepads
- OnlineInternet (UDP port 27450) for online modes only
- ScreenWindow, borderless or fullscreen up to 4K
- MobileiPhone / iPad (iOS 15 or newer)
- PriceFree
Contact
Email support@bonkle.net. Bonkle is made by one independent developer, so a reply can take a few days. Questions about your data: see the privacy policy.
