Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.battlecode.cam/llms.txt

Use this file to discover all available pages before exploring further.

​
Run a local match

cambc run <bot_a> <bot_b> [map]
This runs the full game engine locally with no time limits — ideal for rapid iteration. The engine outputs a replay.replay26 file. Bot paths can be a directory containing main.py, a .py file, or a bot name from your bots_dir (set in cambc.toml). The optional map argument is a .map26 file — if omitted, the first map in your maps_dir is used. 
cambc run starter starter                        # bot vs itself
cambc run my_bot opponent --seed 42              # deterministic seed
cambc run my_bot opponent maps/custom.map26      # custom map
cambc run my_bot opponent --replay out.replay26  # custom replay path

​
View a replay

cambc watch replay.replay26
Opens the visualiser in your browser. Supports play/pause, round scrubbing, speed control, and keyboard navigation.

​
Run + watch in one command

cambc run --watch starter starter

​
View a platform match

cambc watch --match <match_id>
cambc watch --match <match_id> --game 3

​
Remote test runs

Remote commands require authentication — run cambc login first if you haven’t already. Test your bots on the same hardware that runs ladder matches, with full time limit enforcement: 
cambc match test <bot_a> <bot_b> [maps...]
This uploads both bots and runs a match on AWS Graviton3 instances with the 2ms CPU time limit enforced. Use this to catch performance issues before submitting. Bot paths for match test must be a directory containing main.py or a .zip file (unlike cambc run, arbitrary .py files are not accepted). 
cambc match test my_bot opponent
cambc match test my_bot opponent maps/custom.map26
Remote test runs are rate-limited: max 10 test/unrated matches per 10 minutes.
You can also challenge another team to an unrated match using both teams’ latest submissions: 
cambc match unrated <opponent_team_id>
cambc match unrated <opponent_team_id> --map arena --map galaxy   # specific maps

​
Debugging

  • stdout via print("msg") is captured and saved to the replay — view it per-unit in the visualiser
  • stderr prints to your console in real time
  • Use c.draw_indicator_line() and c.draw_indicator_dot() to draw debug overlays on the map

​
Next steps

Submit your bot

Upload your bot to compete on the ladder.

CLI reference

Full reference for all CLI commands.