Get botting in three steps.
The launcher is a single file. Everything it needs is inside it except Java itself — no JavaFX to install, no folders to set up, no flags. Install Java once, download your launcher, run it.
What you need
- Java 21 or newer — a one-time install (step 1).
- A BotWith.me account — free to create.
- Access to a server — the download button appears on bots you own.
- A couple of minutes — nothing to configure by hand.
Your platform
Steps 1 and 3 adjust to match.
Install Java 21 (or newer)
Any Java 21+ works — the launcher carries its own JavaFX, so you do not need a special "FX" build. The easy, free one is Eclipse Temurin:
Download Temurin 21 (Windows) →During install, leave Set JAVA_HOME and Associate .jar files ticked if offered — the second one makes a double-click just run the launcher. To check afterwards, open a terminal and run java -version; it should say 21 or higher.
Grab Temurin 21 for macOS (pick the right chip — Apple silicon is aarch64, older Intel Macs are x64). Homebrew users can run brew install --cask temurin@21 instead.
Download Temurin 21 (macOS) →Check it worked in Terminal with java -version — it should report 21 or higher.
Install a JDK 21 from your package manager — on Debian/Ubuntu that is sudo apt install openjdk-21-jdk — or download Temurin 21 from Adoptium if your distro is older.
Download Temurin 21 (Linux) →Confirm with java -version — it should say 21 or higher.
Download your launcher
Your launcher is built fresh for you the moment you download it, so every copy is unique to your account. The Download launcher button lives on the card of any server you own:
Go to Servers →What you'll see it do
- Requesting download
- →
- Checking access
- →
- Building your copy
- →
- Issuing client
- →
- Downloading
When it finishes, save the .jar somewhere you'll find it, like your Desktop.
Run it
Double-click the .jar and the launcher opens. That's it.
If a double-click does nothing, open a terminal in the folder you saved it and run:
java -jar botwithme-launcher.jar
Open Terminal, change into the folder you saved it, and run:
cd ~/Downloads java -jar botwithme-launcher.jar
If Gatekeeper blocks a double-click, running it from Terminal like this sidesteps it.
Open a terminal in the folder you saved it and run:
java -jar botwithme-launcher.jar
Most desktops can also do it from the file manager via Open with → OpenJDK Java Runtime.
A window appears asking you to sign in. From there, pick your server, load a script — jar or text (.bot) — and go.
It keeps itself up to date
When a server ships a new client, the launcher re-maps its hooks automatically — so you download once and updates land on their own. No reinstalls, no patch notes to chase, no waiting on a new build to get back in.
If something goes wrong
The handful of things that trip people up, and the fix for each.
"Windows protected your PC" / SmartScreen
Double-click opens WinRAR / 7-Zip instead of running
"JavaFX runtime components are missing"
"UnsupportedClassVersionError" or it just won't start
Nothing happens at all
Ready when you are.
Java installed? Head to your server and grab your launcher.