> ## Documentation Index
> Fetch the complete documentation index at: https://cambridgebattlecode-mintlify-api-updates-1773792477.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cambridge Battlecode

> Documentation for the Cambridge Battlecode programming competition.

<img className="block dark:hidden" src="https://mintcdn.com/cambridgebattlecode-mintlify-api-updates-1773792477/Zv7Zw9Hd845Vs7ed/images/battlecode-logo-dark.png?fit=max&auto=format&n=Zv7Zw9Hd845Vs7ed&q=85&s=44fdd950364f45c92a92fae3dd290065" alt="Cambridge Battlecode" style={{ maxWidth: 400, marginBottom: 16 }} width="1090" height="303" data-path="images/battlecode-logo-dark.png" />

<img className="hidden dark:block" src="https://mintcdn.com/cambridgebattlecode-mintlify-api-updates-1773792477/Zv7Zw9Hd845Vs7ed/images/battlecode-logo-light.png?fit=max&auto=format&n=Zv7Zw9Hd845Vs7ed&q=85&s=fc1d713320ee6b512dfe0785bb212649" alt="Cambridge Battlecode" style={{ maxWidth: 400, marginBottom: 16 }} width="1090" height="303" data-path="images/battlecode-logo-light.png" />

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](https://battlecode.cam).

## Quick start

```bash theme={null}
pip install cambc
cambc starter
cambc run starter starter --watch
```

<CardGroup cols={2}>
  <Card title="Install and scaffold" icon="terminal" href="/getting-started/installation">
    Install the CLI and run `cambc starter` to set up your project.
  </Card>

  <Card title="Write your first bot" icon="code" href="/getting-started/first-bot">
    Learn the basics: spawning builder bots, placing conveyors, and harvesting resources.
  </Card>

  <Card title="Game rules" icon="book" href="/spec/overview">
    Full game specification — map, resources, units, buildings, turrets, and win conditions.
  </Card>

  <Card title="API reference" icon="rectangle-terminal" href="/api/controller">
    Every method available to your bot via the Controller object.
  </Card>
</CardGroup>
