CLI Guide

The roWars CLI is an interactive shell for controlling one or more bots.

Modes

Global prompt:

rowars>

Bot prompt after /use scout:

scout>

Slash commands are CLI commands. Bare commands in bot mode target the current bot. Bare commands in global mode must target a handle, a group, or all.

Lifecycle

/connect scout
/spawn scout
/despawn scout
/disconnect scout
/reload

For groups:

/connect @1
/spawn @1
/disconnect @1

For every configured bot:

/connect all
/spawn all
/disconnect all

/disconnect closes the bot session. stop is different: it stops the current in-game movement, navigation, or attack.

/reload reloads the local TOML config without restarting the CLI. Existing bots with the same handle keep their current session; the CLI updates safe runtime fields such as slot, group, death policy, and stat plan. New bots are added disconnected, and bots removed from the file are disconnected and removed from the fleet. If gateway_url or a bot token changes while that bot is already connected, disconnect and reload again before reconnecting it.

Bot Commands

state
where
enemies
move <x> <y> [wait] [timeout=<seconds>]
navigate [map] <x> <y> [wait] [timeout=<seconds>]
attack <targetId> [wait] [timeout=<seconds>]
stop
despawn
echo [text]
portals
route <map>

Examples:

scout> where
scout> move 160 190 wait
scout> navigate prontera 150 180 wait timeout=30
scout> enemies
scout> attack 12345 wait
scout> stop

Targeting From Global Mode

rowars> scout where
rowars> @1 move 160 190 wait
rowars> all state

Events

rowars> /events on
rowars> /raw on
rowars> /events off

Raw mode prints full JSON messages. Normal event mode prints compact event lines.