Tool

Returns

get_turn

the current turn as an integer: the stardate in tenths (÷10 for the displayed value)

get_empire_status

the player empire: turn, treasury_bc, income_bc, research_per_turn, food, production, research_target, plus unavailable naming the fields not yet reverse-engineered (those come back null, never guessed)

list_colonies

one entry per colony: system (MOO2's own planet name, e.g. "Skynet I"), population, and the labour outputs food_output/production_output/research_output. buildings and production_queue stay empty — unresolved

get_colony(index)

a single colony in the same shape, indexed as in list_colonies

get_home_colony

the home colony's population and labour outputs. Identity, buildings and queue stay null/empty. The raw farmer/worker/scientist counts aren't stored by MOO2, so they aren't reported

get_player_empire

empire_id (0–4) plus the home system's home_system name and home_system_index. Errors if the game wasn't started by the harness, whose home-star marker this relies on

list_systems(explored_only=true)

per system: index (for list_system_planets), name, galaxy x/y, the global planets indices in orbit order, explored_by_player, home_of and colonies_of. Passing explored_only=false includes unexplored systems — information the game itself would not show the player

list_system_planets(system_index)

per planet: index, name, body_type (planet / gas giant / asteroids), size, gravity, climate, minerals. Climate only means anything when body_type is "planet"

list_ships

per ship: name (e.g. "Colony Ship 2"), design, location (the star system it's at) and owner. Ships, not fleets

list_fleets

fleets by location and ship composition — currently always errors: the ship records are resolved but their grouping into fleets is not, so fleets can't be assembled without guessing

get_game_state

a consistent snapshot — empire, colonies, fleets read back-to-back — with any unresolved or unreadable domain returned as null and named in unavailable with a reason

Tool

Returns

get_turn

the live stardate (in tenths; ÷10 for the displayed value)

get_empire_status

the player empire: turn, treasury_bc, income_bc, research_per_turn, food; unresolved fields are null and named in unavailable

list_empires

every empire: empire_id, name, is_player, plus the same scalars. Shows what the game would hide — AI treasuries are readable from turn 1, and contact status is not reverse-engineered yet, so it can't be limited to empires the player has met

get_player_empire

which empire the player is: empire_id and the home system's name/index

list_colonies / get_colony

colonies: owner, population, food_output, production_output, research_output, system (e.g. "Skynet I"). buildings/production_queue are unresolved and stay empty. all_empires=true includes the AI empires'. A colony whose record MOO2 hasn't written yet (it does so some turns after founding) still appears, located by the star table: owner and system only, every record field null and named in unavailable

get_home_colony

the home colony alone, found by verifying the record's owner rather than assuming its index

list_systems

star systems: name, color, x/y, planets, home_of, colonies_of, explored_by_player. Explored only unless explored_only=false

list_system_planets

one system's planets: name, body_type, size, gravity, climate, minerals

list_ships

the player's ships: name, design, location. Ships, not fleets

list_fleets

errors — how ships group into fleets is not reverse-engineered

get_game_state

a snapshot of empire + colonies + fleets, with unreadable domains null and named in unavailable