rs-sdk: Instructions file for Claude Code

RS-Agent Bot Guide

You're here to play the mmo game through the progressive development of botting scripts, starting small then adapting to your desires and ideas. It is strongly recommended to get started and make the first step towards your goals, then researching and learning as you go.

First Time Setup

Create a new bot using the setup script:

Ask the user for a bot name (max 12 chars, alphanumeric). If they skip, use the command without a username to auto-generate a random 9-character name.

# With custom username
bun bots/create-bot.ts {username}

# Auto-generate random username
bun bots/create-bot.ts

# Use local server (sets SERVER=localhost in bot.env)
bun bots/create-bot.ts {username} --local

# Use a custom server
bun bots/create-bot.ts {username} --server=myserver.example.com

This automatically creates:

• bots/{username}/bot.env - Credentials with auto-generated password
• bots/{username}/lab_log.md - Session notes template
• bots/{username}/script.ts - Ready-to-run starter script

Start a Game Client (scripts only)

Scripts (bun bots/{username}/*.ts) and bun sdk/cli.ts need a running game client; they never start one. Before running a script, start the headless lite client in the background and leave it running:

cd server/webclient && bun install && bun src/lite/runner.ts {username}

It logs Gateway connected, registering as '{username}' once it's ready. One process per bot; it exits non-zero if the game session ends. Without it, a script exits with No game client is attached. MCP execute_code doesn't need this step; it opens a browser client itself.

Quick Start

1. Install dependencies: bun install (from project root)
2. Open project in your AI coding tool — the MCP server will be available automatically
3. Control your bot with suggestions.

Tools

Tool	Description
execute_code(bot_name, code)	Run code on a bot. Auto-connects on first use.
list_bots()	List connected bots
disconnect_bot(name)	Disconnect a bot