Connect (if needed) and report the connection, your character's binding, and a summary of its surroundings.

Your character's position, inventory, equipment and jobs, plus what it knows around it: players and other agent characters in view, resource patches and trees on explored ground, your force's buildings with status counts, visible enemies, research, power and top production.

Your character's inventory and equipment.

Details of entities near map positions (searched within 1.5 tiles; explored ground only; other forces only while visible): type, status, recipe, crafting progress, inventories, fuel burning, energy buffer (kJ), belt contents, fluids, and for mining drills the ore left in their mining area. Up to 16 per call.

ASCII tile grid of a square area: one character per tile, rows north to south. Unexplored tiles are '?'. The legend explains every symbol (uppercase = resources, lowercase = your force's buildings, @ = you).

Everything about up to 10 names at once — the item (stack size, fuel value), the entity it places (footprint, power use in kW, crafting/mining speed, mining area, drill drop offset, inserter pickup/drop offsets, module slots, belt speed) and the recipe that makes it (ingredients, products, time, unlocked or not).

Machines of your force in an area (explored ground) grouped by problem — no power, low power, no fuel, missing ingredients (with which ingredient when detectable), output full, depleted ore, idle — plus power summary.

Check whether items could be placed at explored positions right now (no side effects). Up to 24 placements per call. Answers yes, or no with the blocker when identifiable.

Nearest width x height rectangle of free land (no water, cliffs or entities; trees allowed and counted) on explored ground near a point.

Your force's item and fluid production and consumption on your surface, per minute over a time window (like the production statistics window), plus all-time totals.

Trains on your surface (id, state, mode, cars, position, station, schedule, cargo) and the known train stop names.

Blueprints your character carries (inventory and books, nested books included).

Decode a carried blueprint by label into relative entity positions and its item bill (read in windows).

Decode a blueprint export string into relative entity positions (top-left entity at 0,0), directions, recipes and the item bill. Does not build.

Capture your force's buildings in an explored rectangle (max 200x200 tiles) as a blueprint export string, with entity counts and the map anchor of its top-left entity.

Chat messages since your last read (or since since_id): players and other agents; your own lines excluded.

Events since your last read (or since since_id): your jobs finishing or failing, your character attacked or killed, research finished, supply warnings of duties.

Block until new chat or a new event arrives, or timeout_s passes (polls about twice per second).

Say something in game chat as your character.

Queue a technology for research for your force.

Move a gun, ammo and/or armor from your main inventory into your equipment slots.

Leave the vehicle you are in.

Set a train's schedule (existing stop names with wait conditions) and switch it to automatic.

Create a new body for your character at the spawn point (after death), with the scenario's respawn kit.

Walk to a map position with the game pathfinder at normal walking speed. The goal must be on explored ground or within the exploration radius (default 64 tiles) of you.

Board the nearest free car (fuelling it from your inventory if needed) and drive to a position.

Persistent job: follow a player at a distance until cancelled. Replaces your current jobs.

Mine by hand (vanilla mining time and reach): either the minable thing at x,y, or count mining operations of a resource name ("iron-ore", "coal", "stone", "tree", "rock", ...) found on explored ground within 80 tiles.

Place a building from your inventory (walks within build range; normal placement rules).

Hand-craft with your character's crafting queue (real crafting time; missing intermediates are queued too).

Move items from your inventory into the entity at x,y (walks within reach).

Take items out of the entity at x,y into your inventory: specific counts, or all=true (walks within reach).

Set the recipe of the crafting machine at x,y (walks within reach).

Rotate the entity at x,y one step, or to a 16-way direction (walks within reach).

Build many entities as ONE job: steps are placed in order (walking within build range, items from your inventory, normal placement rules), each optionally setting a recipe and inserting items. Failed steps are reported and skipped unless stop_on_error. auto_craft hand-crafts missing placeable items first. dry_run=true only checks the plan (items, recipes, placement, overlaps) without building.

Build a whole blueprint as ONE job, anchored so its top-left entity lands at (anchor_x, anchor_y): from an export string, or a carried blueprint by label. Up to 1000 entities; per-step failures are reported.

Queue a sequence of actions (craft, insert, extract, mine, place, set_recipe, rotate, walk_to) as chained jobs. If one fails, the rest of the chain is cancelled. Waits for the last one up to wait_s.

Mine your force's own buildings back into your inventory (vanilla mining time): the nearest one at x,y, or all within area_radius (max 10 tiles, 50 buildings).

Fight visible enemies around a point with your equipped gun (walks into range, shoots, next target); anchored to the radius; retreats below flee_below health.

Persistent job: guard an area — shoot enemies that come near, refill ammo turrets and repair structures from your inventory — until cancelled. Replaces your current jobs.

Persistent job: keep burner machines around a point fuelled from your inventory until cancelled. Replaces your current jobs.

Status of one of your jobs, or (without job_id) your running job, queue and recently finished jobs.

Wait up to timeout_s for one of your jobs to finish.

Cancel one of your jobs, or all of them (all=true), stopping your character.