RS-SDK

The LiteClient is a headless, high-performance RS274 client designed for running many bots on a single machine. It implements the same protocol and game state as the full browser client but removes all rendering (no 3D, no textures, no sound, no screenshots).

Key Characteristics:

• Low Resource Usage: Approximately 13.8 MB RAM and 0.42% CPU per bot (measured on M-series hardware).
• Compatibility: It acts as a façade for the ~54 methods and ~36 fields used by the bot bridge, ensuring that BotWorldState is produced by the exact same logic as the browser client.
• Headless: It does not fetch models, animations, or music. Map data is loaded once from /ondemand.zip during the index build.
• Accuracy: Entity positions are snapped to grid coordinates (x/z) rather than interpolated for efficiency and accuracy.

import { startSession } from '#/lite/session.js';

const s = await startSession({
    host: 'rs-sdk-demo.fly.dev',
    username,
    password,
    // Anything other than 'stopped' means the bot left the game on its own.
    onEnd: end => console.warn(`session over: ${end.reason}`)
});

s.client.walkTo(3222, 3218, true);
s.client.flush();

// ...

s.stop();
const { reason } = await s.stopped;