max bittkerandClaude Fable 5
716a9375f9
Disk/data: - Delete scripts/ entirely: 3.2GB of gitignored Jan-Feb run telemetry plus the legacy per-skill script/lab_log layout superseded by bots/ (tracked files remain recoverable from git history) - Prune bots/ to the 10 most-used bots (claude46, Codex7, max, codexpl8, runepl8, maxbittker, codex53, aaravA, codex_53, multibot) + _template; all removed dirs archived to ~/rs-sdk-cleanup-archive-2026-07-13.tgz along with stream/ (held live Twitch/bot/Anthropic credentials) - Remove orphaned sdk/node_modules + sdk/bun.lock (pathfinder is vendored in server/vendor; sdk has no deps of its own) Git hygiene: - Untrack sdk/collision-data.json (22MB blob per regen; kept on disk, regen curl documented in DEVELOPERS.md and .gitignore) - gitignore backups/, .obsidian/, and engine public/client/*.js (the gap that let stale client.js shadow fresh webclient builds return) - Delete the untracked stale public/client/client.js shadow copy Dead code/config: - Drop unused deps: tmi.js, @types/tmi.js, ts-morph - Drop dead tsconfig globs (stream/, bot_arcs/) - Remove unused nix toolchain (flake.nix, flake.lock, .envrc) Docs: - GEMINI.md/agents.md were byte-identical 4-month-stale copies of claude.md; replace with symlinks so all tools read one file - DEVELOPERS.md: remove abolished copy-client.js-to-engine step and nonexistent agent//javaclient sections; document collision regen - sdk/README.md: fix reference to nonexistent scripts/example-remote.ts - Remove stale sdk/SDK_DESIGN.md and misleading sdk/test/test_status.md Also commit the forgotten sdk/test/click-dialog-by-text.test.ts (tests a shipped API, was never git-added). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
RS-SDK
Research-oriented starter kit for runescape-style bots, including a typescript sdk, agent documentation and bindings, and a server emulator. Works out of the box - tell it what to automate!
Build and operate bots within a complex economic role-playing MMO. You can automate the game, level an account to all 99s, and experiment with agentic development techniques within a safe, bot-only setting.
The goals of this project are to provide a rich testing environment for goal-directed program synthesis techniques (Ralph loops, etc), and to facilitate research into collaboration and competition between agents.
There is currently a leaderboard for bots running on the demo server, with rankings based on highest total level per lowest account playtime.
See the benchmark comparing models for evaluation results across different LLMs.
Note
RS-SDK is a fork of the LostCity engine/client, an amazing project without which rs-sdk would not be possible. Find their code here or read their history and ethos
Getting Started:
git clone https://github.com/MaxBittker/rs-sdk.git
Out of the box, you can connect to the provided demo server, choose a name that is not already taken!
With claude code:
bun install
claude "start a new bot with name: {username}"
Manually:
bun install
bun bots/create-bot.ts {username}
bun bots/{username}/script.ts
Chat is shown by default. Note that seeing other players' chat exposes the bot to scamming and prompt-injection attempts; opt out with SHOW_CHAT=false in the bot.env file (or bun bots/create-bot.ts <name> --no-chat).
Warning: The demo server is offered as a convenience, and we do not guarantee uptime or data persistence. Hold your accounts lightly, and consider hosting your own server instance. Please do not manually play on the demo server.
Gameplay Modifications
This server has a few modifications from the original game to make development and bot testing easier:
- Faster leveling - The XP curve is accelerated and less steep.
- Infinite run energy - Players never run out of energy
- No random events - Anti-botting random events are disabled
Architecture:
rs-sdk runs against an enhanced web-based client (botclient) which connects to the LostCity 2004scape server emulator.
There is a gateway server which accepts connections from botclient and SDK instances, and forwards messages between them based on username.
Once connected to the gateway, the botclient will relay game state to the SDK, and execute low-level actions (e.g. walkTo(x,y)) sent from the SDK through the gateway.
This means that the SDK can't talk directly to the game server, but must go through the botclient. It will attempt to launch the botclient on startup if one is not already running.
You don't need to run the gateway/botclient in order to run automations against the demo server, but you may choose to if you are fixing bugs or adding features to the rs-sdk project
Running the server locally
Running the server locally has many advantages, primary being the ability to set a high tickrate.
You can set tickrate in server/engine/.env via the NODE_TICKRATE variable (default is 400ms, try 200ms or 30ms for faster gameplay, especially useful for headless testing). You can also change it at runtime with the in-game ::speed <ms> command (minimum 20ms, doesn't persist across restarts).
You want all three of these running:
# Game engine
cd server/engine && bun run start
# Web client bundler
cd server/webclient && bun run watch
# Gateway (bridges SDK <-> bot client)
cd server/gateway && bun run gateway
The gateway listens on ws://localhost:7780 by default (configurable via AGENT_PORT env var).
2. Connect a bot to the local gateway
The SERVER variable in bot.env controls where the bot connects. To use your local gateway, leave SERVER blank:
BOT_USERNAME=mybot
PASSWORD=test
SERVER=
SHOW_CHAT=true
When SERVER is empty, all connection paths (scripts, CLI) default to ws://localhost:7780.
When SERVER is set to a hostname (e.g. rs-sdk-demo.fly.dev), they connect to wss://{SERVER}/gateway instead.
Disclaimer
This is a free, open-source, community-run project.
The goal is strictly education and scientific research.
LostCity Server was written from scratch after many hours of research and peer review. Everything you see is completely and transparently open source.
We have not been endorsed by, authorized by, or officially communicated with Jagex Ltd. on our efforts here.
You cannot play Old School RuneScape here, buy RuneScape gold, or access any of the official game's services! Bots developed here will not work on the official game servers.
License
This project is licensed under the MIT License. See the LICENSE file for details.