> ## 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. # Controller > Complete reference for all Controller methods available to your bot. The `Controller` object is passed to your `Player.run()` method each round. It provides all queries and actions for interacting with the game. ```python theme={null} class Player: def run(self, c: Controller): # c is the Controller for this unit pos = c.get_position() ``` ## Info methods ### Unit info Return the team of the entity with the given id, or this unit if omitted. Return the position of the entity with the given id, or this unit if omitted. Return this unit's entity id. Return this unit's current action cooldown. Actions require cooldown == 0. Return this unit's current move cooldown. Movement requires cooldown == 0. Return the current HP of the entity with the given id, or this unit if omitted. Return the max HP of the entity with the given id, or this unit if omitted. Return the EntityType of the entity with the given id, or this unit if omitted. Return the facing direction of a conveyor, splitter, armoured conveyor, or turret. Raises `GameError` if the entity has no direction. Return the vision radius squared of the given unit, or this unit if omitted. ### Turret info Return the amount of ammo this turret currently holds. Return the resource type loaded as ammo, or None if empty. Return the position of the closest non-empty tile in the gunner's facing direction, or None if nothing is in range. Only valid on gunners. ### Building info Return the output target position of a bridge. Raises `GameError` if not a bridge. Return the resource stored in a conveyor/splitter/armoured conveyor/bridge/foundry, or None if empty. Raises `GameError` if the entity has no storage. ### Tile queries Return the environment type (empty, wall, ore) of the tile at pos. Return the id of the building on the tile at pos, or None if empty. Return the id of the builder bot on the tile at pos, or None if empty. Return True if the tile has no building and is not a wall. Return True if a builder bot belonging to this team could stand on the tile (conveyor, road, or allied core, and no other builder bot). Return True if pos is within this unit's vision radius. ### Nearby queries Return all in-bounds tile positions within dist\_sq of this unit (defaults to vision radius). dist\_sq must not exceed the vision radius. Return ids of all entities on tiles within dist\_sq (defaults to vision radius). Return ids of all buildings within dist\_sq (defaults to vision radius). Return ids of all units within dist\_sq (defaults to vision radius). ### Map and game state Return the width of the map in tiles. Return the height of the map in tiles. Return the current round number (starts at 1). Return (titanium, axionite) in this team's global resource pool. Return this team's current cost scale as a percentage (100.0 = base cost). Return the CPU time elapsed this round in microseconds. ## Cost getters Every buildable entity has a cost getter that returns the current scaled `(titanium, axionite)` cost: ```python theme={null} c.get_conveyor_cost() # -> (int, int) c.get_splitter_cost() c.get_bridge_cost() c.get_armoured_conveyor_cost() c.get_harvester_cost() c.get_road_cost() c.get_barrier_cost() c.get_gunner_cost() c.get_sentinel_cost() c.get_breach_cost() c.get_launcher_cost() c.get_foundry_cost() c.get_builder_bot_cost() ``` ## Movement Move this builder bot one step in direction. Raises `GameError` if not legal. Return True if this builder bot can move in direction this round. ## Building Every buildable entity has `can_build_*` and `build_*` methods. All require action cooldown == 0 and sufficient resources. The `can_build_*` variants return `bool`; `build_*` returns the new entity's `int` id and raises `GameError` if not legal. ### Directional buildings These take `(position: Position, direction: Direction)` — the direction the building faces. They return the new building's entity id. ```python theme={null} c.build_conveyor(pos, direction) # -> int c.can_build_conveyor(pos, direction) c.build_splitter(pos, direction) # -> int c.can_build_splitter(pos, direction) c.build_armoured_conveyor(pos, direction) # -> int c.can_build_armoured_conveyor(pos, direction) c.build_gunner(pos, direction) # -> int c.can_build_gunner(pos, direction) c.build_sentinel(pos, direction) # -> int c.can_build_sentinel(pos, direction) c.build_breach(pos, direction) # -> int c.can_build_breach(pos, direction) ``` ### Bridge Takes `(position: Position, target: Position)` — the bridge's output target tile (within distance² 9). Returns the new bridge's entity id. ```python theme={null} c.build_bridge(pos, target) # -> int c.can_build_bridge(pos, target) ``` ### Non-directional buildings Take only `(position: Position)`. They return the new building's entity id. ```python theme={null} c.build_harvester(pos) # -> int c.can_build_harvester(pos) c.build_road(pos) # -> int c.can_build_road(pos) c.build_barrier(pos) # -> int c.can_build_barrier(pos) c.build_foundry(pos) # -> int c.can_build_foundry(pos) c.build_launcher(pos) # -> int c.can_build_launcher(pos) ``` ## Healing & destruction Heal all friendly entities on the tile by 10 HP. Costs one action cooldown. Return True if this builder bot can heal the tile this round. Destroy the allied building at building\_pos. Does **not** cost action cooldown. Return True if this builder bot can destroy the allied building. Destroy this unit. Builder bots deal 20 damage to their tile. Terminates the bot's turn immediately (the bot will not execute any further code this round). Forfeit the game immediately. Destroys this team's core, ending the game as a loss. Terminates the bot's turn immediately. ## Markers Place a marker with the given u32 value. Does not cost action cooldown. Max one per round. Return True if this unit can place a marker at position this round. Return the u32 value stored in the friendly marker. ## Combat Fire this turret at target. Use `launch()` for launchers. Return True if this turret can fire at target this round. Pick up the builder bot at bot\_pos and throw it to target. Return True if this launcher can pick up and throw the bot. ## Core Spawn a builder bot on one of the 9 core tiles. Costs one action cooldown. Returns the new builder bot's entity id. Return True if the core can spawn a builder at position this round. ## Debug indicators Draw a debug line between two positions with RGB colour. Saved to the replay. Draw a debug dot at a position with RGB colour. Saved to the replay.