API Reference
Reference Types
State values and generic definitions
Reference
BotStatus Values
| Value | Description |
|---|---|
connecting | Initial state, attempting to connect |
connected | Connected to game server |
in_game | In-game — world select screen or inside a world |
two_factor_auth | Blocked by 2FA — retries after twofa_secs |
server_overloaded | Server overloaded — retries after server_overload_secs |
too_many_logins | Too many concurrent logins — retries after too_many_logins_secs |
update_required | Client update required — bot stops permanently |
maintenance | Server under maintenance — retries after maintenance_secs |
Coordinates
All x/y values are in tile coordinates (pixels ÷ 32). The bot's position (5.0, 10.0) means tile column 5, row 10.
Default Delays
| Delay | Default | Description |
|---|---|---|
place_ms | 500ms | Delay between place/punch actions |
walk_ms | 500ms | Delay between walk/pathfind steps |
twofa_secs | 120s | Reconnect wait after 2FA block |
server_overload_secs | 30s | Reconnect wait after server overload |
too_many_logins_secs | 5s | Reconnect wait after too-many-logins rejection |
maintenance_secs | 600s | Reconnect wait after server maintenance rejection |