Skip to content

Getting Started

Requirements

  • Python 3.11 or newer.
  • The roWars Docker stack running locally.
  • A bot configuration file, usually sdks/python/examples/bots.example.toml.

Start the CLI

From the repository root, in PowerShell:

$env:PYTHONPATH = "G:\roWars\sdks\python;G:\roWars\apps\cli"
.\sdks\python\.venv\Scripts\python.exe -m rowars_cli --config .\sdks\python\examples\bots.example.toml

In Git Bash:

PYTHONPATH="/g/roWars/sdks/python:/g/roWars/apps/cli" ./sdks/python/.venv/Scripts/python.exe -m rowars_cli --config ./sdks/python/examples/bots.example.toml

First Commands

rowars> /bots
rowars> /groups
rowars> /connect scout
rowars> /spawn scout
rowars> /use scout
scout> state
scout> where
scout> move 160 190 wait

Use /disconnect scout when you are done with the bot session.

Next Steps

  • Read Configuration to understand bot handles, tokens, groups, death policy, stat plans, and job plans.
  • Read the CLI guide to control bots interactively.
  • Read the Python SDK guide to write scripts and reusable strategies.