Setup & installation
Follow these steps in order to install the Botting Hub AI client, set up 2FA, configure your settings and start botting. The core install takes about 10 minutes.
- Check your PC meets the system requirements.
- Grab your license key and install the required files.
- Set up accounts and 2FA, then review the client settings.
- Launch the game the correct way and set Windows language & scaling.
- Prep your skill with the script setup guide — then start botting.
full setup walkthrough
01 System requirements #
Make sure your machine meets all of the following before you install.
- Operating system
- Windows 10 & 11 — Home, Pro, Educational, Enterprise · Windows Server 2016+
- Language
- Keyboard, apps, display & regional format must all be English
- Display scaling
- Screen display scaling must be 100%
The AI reads the screen, so non-English text or non-100% scaling throws off detection. Set both before launching.
02 Your license key #
A license key is sent to your email to access your product. Orders typically process within 5–15 minutes. If you haven't received it, you may have entered your email incorrectly at checkout.
Key not arriving after 15 minutes? Join our Discord and the team will sort it out fast.
03 Download & install #
If you purchased the AI scripts, install all four files below. Each is mandatory — install it in the folder noted on its card.
All four files are mandatory. Use the exact locations shown — Sandboxie in Program Files; Proxifier and the Jagex Launcher in Program Files (x86) — or the client won't run correctly.
04 The Botting Hub client #
The BH Client is compatible exclusively with Jagex accounts — legacy accounts are no longer supported by Jagex.
It can seamlessly handle 2FA verification by accessing your email inbox. To enable this, configure app passwords as described in the 2FA setup. The "email password" you enter in the client must be the app-specific password generated by Gmail — not your normal Gmail password.
Multiple accounts — the +Gmail method
It's recommended to use one character per account. If you're botting multiple Jagex accounts (or converting legacy accounts to Jagex), use the +Gmail trick — every address with a +suffix is delivered to your primary inbox:
maingmail@gmail.com
maingmail+1@gmail.com
maingmail+2@gmail.com
maingmail+1@gmail.com
maingmail+2@gmail.com
All +suffix emails forward to your primary Gmail (maingmail@gmail.com), making large-scale account management simple and efficient.
Proxies are configured automatically in the background, so the BH Client securely isolates each of your accounts.
05 2FA setup #
This makes 2FA automation work for both the client and the account creator. If you'd rather not automate it, just enter a random email and password and type the verification code manually — but never leave the email or password fields blank.
Requirements
- 64-bit Windows operating system
- Google Chrome browser installed
- One single brand-new Gmail address with 2-Factor Authentication enabled
Generate the Gmail app password
- Enable Two-Factor Authentication on your Gmail account.
- Go to your Gmail settings and open App passwords — you can find it by typing "App passwords" into the Search Google Account bar at the top of the page.
- Under App Passwords, enter
Bot Manageras the app name and click Create. - A generated app password will appear. Copy it, then paste it into the BH Client under "Gmail password" — and be sure to also enter your Gmail address.
06 Client settings explained #
What each toggle in the BH Client does.
Optimized Graphics Mode
Speeds up graphics processing and resolves client flickering, delivering smoother performance for both solo users and large-scale account farms.
Hardware Input Mode Experimental
Routes all bot actions through your actual hardware mouse. This advanced anti-detection feature ensures every in-game input is generated by physical hardware rather than software, making it virtually impossible for Jagex to tell bot input from human input. Ideal for account farmers aiming to minimize ban risk and reliably run multiple clients like a real player.
Skip Settings Check
Bypasses the initial configuration routine at startup for fast deployment with standardized setups. If you enable this, you must not change any settings, camera angle or other configuration done initially.
Conversational AI Paid
Enables the bot to participate in game chat using AI-driven responses, enhancing realism and social blending while supporting advanced automation and content creation.
RuneLite Beta
Lets your bot operate directly on RuneLite. The current version includes all scripts except Blast Furnace, Fishing, Guardians of the Rift, Mining, MLM and Woodcutting — and currently works only with Hardware Input Mode enabled.
07 Run the client correctly #
This is the step people get wrong most often — read it carefully.
- Always launch the official client from scratch using the Botting Hub Launcher. It opens the client in fixed mode at the exact size the AI was trained on.
- Set the OSRS client to Fixed mode — Classic layout.
Do not launch OSRS manually in random sizes or layouts — it will make the bot malfunction. And never minimize the game client while a script is running.
08 Windows & display settings #
- Windows language for keyboard, apps, display and regional format must be English.
- Display scaling must be 100% — Settings → System → Display → Scale.
09 Script setup guides #
Each script expects a specific starting state. Find your skill below and match the requirements before you start.
NMZ
Rock cake + NMZ unlocked (Vampire Slayer, Tourist Trap, Fishing Contest, The Grand Tree, Tree Gnome Village, Mountain Daughter). Enough coins in the coffer and supplies in the bank, and an initial dream made. Start the script at the NMZ area. Keep supplies in your main bank tab — do not spread them across other tabs.
Absorption potions — requires over 200k points / a rock cake. · Prayer potions — requires 150+ prayer potions; use this setup until you have enough points.
MLM
30 Mining, a pickaxe in your inventory. Start at the MLM bank.
AGILITY
Start near the selected course with food in your inventory (shrimp, salmon, trout, tuna, monkfish, jug of wine, cake, chocolate cake and slices).
SAND CRABS
Start near the Sand Crab Isle bank. Keep supplies in your main bank tab — do not spread them across other tabs.
MINER
Start near the selected mining location with a pickaxe in your inventory.
MAGIC
Have runes in your inventory and make sure your magic spellbook is configured as required for the chosen spell.
COOKING
P2P: start at Rogues' Den with raw fish in the bank. F2P: start at the Draynor bank. Keep the raw fish at the top of your bank and do not use placeholders.
FLETCHING
Start at the selected bank. Keep enough supplies at the top of your bank and do not use placeholders.
CRAFTING
Start at the selected location. Keep enough supplies at the top of your bank and do not use placeholders.
HERBLORE
Start at the selected location. Keep enough supplies at the top of your bank and do not use placeholders. Druidic Ritual quest required.
SMITHING
Start at the selected location. Keep enough supplies at the top of your bank and do not use placeholders.
FIREMAKING
Start at the selected location. Keep enough logs at the top of your bank and do not use placeholders.
FISHING
Start near the selected fishing location with fishing supplies in your inventory (fishing rod, feather, etc.).
HUNTER
Start at the selected hunting spot with enough supplies in your inventory (20 box traps, bird snare, etc.). Supported locations: Piscatoris / Feldip Hills. Eagle's Peak quest is required to lay box traps.
Level requirements: Crimson Swift (1), Copper Longtail (9), Tropical Wagtail (19), Swamp Lizard (29), Ferret (27), Chinchompa (53), Red Chinchompa (63).
WOODCUTTING
Powerchop mode: continuously chops your selected tree near your character and drops the logs for max efficiency — just move to your chopping area before starting. Banking mode: chops your selected tree and banks the logs at the nearest accessible bank.
BLAST FURNACE
Have enough coins, ores, stamina potions, a coal bag and ice gloves in your bank. Place all required supplies at the top of your bank and avoid placeholders. Start on a Blast Furnace world while standing inside the Blast Furnace area.
BLOOD RUNECRAFTER
Start near the dense runestone with a pickaxe and a chisel. Requires 73 Agility, 77 Runecrafting, 38 Mining & Crafting.
10 Bot manager #
Once you're running more than 10–15 accounts at once, switch to the Bot Manager for easier automation. Download it only if you purchased it.
Setting it up
Start by importing your accounts and proxies to streamline the setup, then:
- Click Add Task and give it a name, then select it from the right-hand side.
- Choose your script, set the duration (in minutes) and configure the settings. In this example we use NMZ AI with absorption-potion settings.
- From the main dashboard, select your account, task, proxy and world, then start the script.
All script settings must be configured beforehand in the BH Client — the task uses those settings.
Tip: quickly pause the bot by right-clicking the Start button and selecting Pause.
11 Antivirus / Windows Security exclusions #
Only needed if your antivirus is blocking the client. Steps 1–2 open the settings; do steps 3–7 only if the client won't run.
- Open Windows Security settings.
- Click Manage settings under Virus & threat protection settings.
- Click Add or remove exclusions under Exclusions.
- Click Add an exclusion and select Folder.
- Paste this path, then click Select Folder:
%SYSTEMDRIVE%%HOMEPATH%\Botting Hub - Go back to Virus & threat protection and click Manage settings.
- Turn off Real-time protection.
12 Troubleshooting #
Having a problem? Click the one that matches — most issues come down to one of the settings below.
The bot clicks the wrong things or doesn't react
99% of the time it's one of these four. Check each one:
• Display scaling is 100% (Windows & display).
• Windows language is English (keyboard, apps, display, regional).
• The game is in Fixed mode — Classic layout.
• You opened the game with the BH Launcher, not manually.
• Display scaling is 100% (Windows & display).
• Windows language is English (keyboard, apps, display, regional).
• The game is in Fixed mode — Classic layout.
• You opened the game with the BH Launcher, not manually.
The bot froze or stopped mid-run
Never minimize the game client while a script is running — the AI can't see a minimized window. Keep it open and on screen. If you turned on Skip Settings Check, make sure you didn't change any settings or the camera after setup.
The 2FA code isn't filling in automatically
In the client, the "Gmail password" must be the app password you generated — not your normal Gmail password — and you must also fill in your Gmail address. You also need Google Chrome installed and 2-Factor Authentication enabled on that Gmail. Full steps: 2FA setup.
The client won't open / antivirus blocks it
Add the Botting Hub folder to your antivirus exclusions and turn off real-time protection — follow Antivirus exclusions step by step.
I didn't get my license key
Orders take 5–15 minutes. Check your spam folder and make sure you typed your email correctly at checkout. Still nothing? Ask in Discord.
Still stuck?
Our team and community are active in Discord — most setup questions are answered in minutes.