query · world.route
Known regional routes
Returns the observer's bounded route knowledge with topology endpoints and current reported confidence, pressure, and danger.
world.route.known(filters?, cursor?, page_size?) -> query-page- Stable ID
world.route.known- Owner
- game.observer-knowledge and sim.world-topology
- Authority
- read_only
- Timing
- immediate
- Availability
- active-session
- Side effects
- none
- Determinism
- stable owner order at the current committed tick
- Introduced
- 1.19.0
Usage
Read discovered route segments with observer knowledge state, endpoints, coordinates, pressure, and danger for regional presentation.
Parameters
- cursor: optional continuation cursor.
- page_size: bounded route-row limit.
Returns
Detached route rows limited to the observer's current or stale knowledge.
Cost
One bounded ObserverKnowledge scan and indexed topology lookups.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
confidence | unsigned-integer-or-null | basis-points | no | Latest report confidence. |
danger | signed-integer-or-null | danger-units | no | Latest reported route danger. |
evaluated_at_tick | unsigned-integer | ticks | yes | Knowledge evaluation tick. |
from_site_id | stable-id | none | yes | Origin site identity. |
from_x_meters | number | meters | yes | Origin World X coordinate. |
from_y_meters | number | meters | yes | Origin World Y coordinate. |
knowledge | enumeration | none | yes | Unknown, discovered, current, or stale state. |
pressure | signed-integer-or-null | pressure-units | no | Latest reported route pressure. |
route_id | stable-id | none | yes | Containing route identity. |
segment_id | stable-id | none | yes | Route-segment identity. |
to_site_id | stable-id | none | yes | Destination site identity. |
to_x_meters | number | meters | yes | Destination World X coordinate. |
to_y_meters | number | meters | yes | Destination World Y coordinate. |
Errors
error.capability-unavailableerror.invalid-queryerror.query-budget-exhaustederror.query-contract-violation
Examples
local routes = world.query("world.route.known", {page_size = 32})API history
- 1.19.0: Observer-bounded route reports added for Phase 19Q9F.