Cambridge Battlecode

Documentation for the Cambridge Battlecode programming competition.

Cambridge Battlecode is a programming competition where you write Python bots that compete in a turn-based strategy game. Your bots control autonomous mining fleets on Titan — harvesting resources, building infrastructure, and destroying the enemy core.

For competition details, dates, prizes, and eligibility, visit the main website.

Quick start

pip install cambc
cambc starter
cambc run starter starter --watch

Install and scaffold

Install the CLI and run cambc starter to set up your project.

Write your first bot

Learn the basics: spawning builder bots, placing conveyors, and harvesting resources.

Game rules

Full game specification — map, resources, units, buildings, turrets, and win conditions.

API reference

Every method available to your bot via the Controller object.