A fully offline Old School RuneScape botting suite: a modern desktop launcher on top of the Simba color-bot engine, preserving a personal collection of WaspScripts-era scripts after the platform shut down.
No accounts, no servers, no telemetry — everything runs and stays on your own machine.
- Script library — 78 local scripts, searchable and filterable by skill via an OSRS-style skills panel, with the real wiki skill icons.
- Personal metadata — rename scripts, write your own markdown
descriptions (requirements, setup, notes), set images, favorite ★, hide,
and track which scripts work or are broken. All stored locally in
library.json. - Generated documentation — every script ships with a description reconstructed from its source code (what it does, requirements, setup, features), shown until you write your own.
- One-click running — pick a RuneLite client, hit Run; live console output per running script, kill switch included.
- Two library generations — scripts automatically run against the v1 (pre-refactor) or v2 (current) SRL-T + WaspLib libraries they were written for.
- Launch via the
osrs-bot launcherdesktop shortcut (orlauncher/src-tauri/target/release/wasp-launcher.exe). - Pick a script, select your game client at the bottom, press Run.
- The
osrs-bot Simbashortcut opens the Simba IDE directly for editing and debugging scripts.
Account credentials are configured once via Settings → Tools →
Credentials Helper and stored only in the gitignored
runtime/credentials.simba.
elixer-osrs-bot/
├── README.md
├── docs/
│ ├── AUDIT.md # full codebase audit (findings + severities)
│ └── ROADMAP.md # phased cleanup plan + decisions
├── launcher/ # desktop app — Tauri 2 + SvelteKit 5
│ ├── src/ # Svelte frontend (routes, lib, skill icons)
│ └── src-tauri/ # Rust backend (commands, Simba runner)
└── runtime/ # the Simba 1400 engine + everything it needs
├── Simba64.exe # the color-bot engine (gitignored binary)
├── credentials.simba # account login (gitignored, local only)
├── Scripts/ # every .simba script, flat
└── Includes/ # the script libraries
├── WaspLib -> WaspLib_v2 # active junction, switched per run
├── SRL-T -> SRL-T_v2 # active junction, switched per run
├── WaspLib_v1 / SRL-T_v1 # pre-refactor libs (scripts using osr.simba)
└── WaspLib_v2 / SRL-T_v2 # current libs (everything else)
The capitalized Scripts/, Includes/, Configs/, Data/ folder names are
Simba's own convention — the engine and the scripts' include paths depend on
them, so they're left as-is.
WaspLib and SRL-T are junctions the launcher repoints per run to whichever
generation the script needs — v1 if the script includes osr.simba,
v2 otherwise. The _v1/_v2 folders are the real library stores; the
junctions are gitignored runtime state.
Requires Node 24 (bundled under launcher/.tools/), pnpm and a Rust GNU
toolchain (no MSVC — see launcher/src-tauri/.cargo/config.toml).
cd launcher
pnpm install
pnpm tauri build --no-bundleImportant: always build through the Tauri CLI. A plain
cargo build --releaseproduces a dev-flavored exe that tries to load a dev server onlocalhost:1420instead of the embedded frontend.
For development with hot reload:
pnpm tauri devNo hardcoded paths: the launcher locates the runtime/ folder by walking up
from its own executable, so the whole folder can be moved or cloned anywhere.
Per-user state (runtime/Configs/launcher.json, BASettings.ini,
credentials.simba) is gitignored and stays on your machine.
Built on the work of the WaspScripts community — see runtime/README.md for full credits (Simba by Villavu, SRL-T and WaspLib by Torwent, both GPL-3.0) and the licensing status of the preserved scripts. The launcher itself is a heavily stripped offline fork of wasp-launcher (GPL-3.0).
Personal use only. Botting violates the OSRS terms of service — use at your own risk, on accounts you can afford to lose.