query · world.expedition
Expedition records
Returns bounded ScoutingOrder-owned expedition state with Party, supply, route, and discovery facts.
world.expedition.records(filters?, cursor?, page_size?) -> query-page- Stable ID
world.expedition.records- Owner
- game.scouting-order, game.party, and sim.world
- 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 current scouting orders with Party membership, objective, travel progress, provisions, field condition, destination, and discovery counts.
Parameters
- cursor: optional continuation cursor.
- page_size: bounded expedition-row limit.
Returns
Detached records composed from ScoutingOrder, Party, and World owners, or unavailable when those owners are absent.
Cost
One bounded scouting-order scan with indexed Party, traveler, and site lookups.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
condition | enumeration | none | yes | Latest field decision or ready state. |
destination_site_id | stable-id | none | yes | Destination site identity. |
destination_x_meters | number | meters | yes | Destination World X coordinate. |
destination_y_meters | number | meters | yes | Destination World Y coordinate. |
expedition_id | stable-id | none | yes | Scouting-order identity. |
leader_actor_id | stable-id | none | yes | Expedition leader identity. |
member_count | unsigned-integer | none | yes | Current Party membership. |
objective | enumeration | none | yes | Current expedition objective. |
party_id | stable-id | none | yes | Expedition Party identity. |
reported_route_count | unsigned-integer | none | yes | Discovery routes returned. |
reported_site_count | unsigned-integer | none | yes | Discovery sites returned. |
revision | revision | none | yes | Scouting-order revision. |
state | enumeration | none | yes | Current expedition state. |
supply_units | unsigned-integer | resource-units | yes | Conserved departure provisions. |
travel_progress | unsigned-integer | basis-points | yes | Current route-segment progress. |
updated_at_tick | unsigned-integer | ticks | yes | Latest expedition update. |
Errors
error.capability-unavailableerror.invalid-queryerror.query-budget-exhaustederror.query-contract-violation
Examples
local expeditions = world.query("world.expedition.records", {page_size = 16})API history
- 1.19.0: Expedition status records added for Phase 19Q9F.