cpu_next_hops
Survey legal next waypoints from a cell. Lists eligible revealed cells and Hubs within one hop under the reach rule, with hop distance, owner, fee, and optional compass to a destination.
Instructions
Survey the legal next waypoints from a cell (read-only). Lists every eligible waypoint — your revealed cells and all Hubs — within one hop under the reach rule: hop ≤ radius(from)+radius(to)−1 grid steps (default balance: own↔own 1 = adjacent only, own↔hub 3, hub↔hub 5). Foreign cells are never waypoints, so even a single foreign cell between two plain cells is a WALL — only a Hub reaches across; empty hops means goods can only be hauled up to here. Facts per candidate: hop distance, owner, hub flag, per-unit transit fee, and — with towards — the remaining grid distance (a compass, not a route). Planning is YOUR job: pick each hop yourself (cheap vs short vs whose hub you trust), chain them into path, and verify with cpu_quote_transport. To break a wall: build a border Hub (it still needs an eligible landing cell within reach on the far side), buy land across, or go around. WHEN: the cheap point check — call it right before each leg and after cpu_get_changes shows movement (hubs get demolished, fees change while goods travel); replan via cpu_route_network only when a local fix is impossible.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | Yes | The cell to hop from (your revealed cell, or a Hub). | |
| towards | No | Optional destination — adds the remaining grid distance to it for each candidate (a compass). |