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.

​
Requirements

  • Python 3.12 or 3.13 (3.14 is not supported)
  • pip (comes with Python)

​
Install

pip install cambc
This gives you both the CLI tool and the compiled Rust game engine as a native Python module. No Docker, Rust toolchain, or Node.js required.
The cambc package includes the full game engine compiled for your platform. Supported: macOS (Apple Silicon + Intel), Linux (x86_64 + ARM64), Windows (x86_64).

​
Verify

cambc --version

​
Set up your project

cambc starter
This scaffolds a project with a cambc.toml config, bots/ and maps/ directories, a .gitignore, and optionally a starter bot. See the CLI reference for details.

​
What’s included

ComponentDescription
cambc CLIRun local matches, open the visualiser, submit bots, trigger test runs
cambc Python moduleGame types (Team, EntityType, Direction, Position, etc.) for use in your bot code
titan_runnerThe compiled Rust game engine (embedded, runs locally with no time limits)

​
Next steps

Write your first bot

Create a simple bot that spawns builders and starts harvesting.

CLI reference

Full reference for all CLI commands.