query · world.region
Known regions
Returns the observer's bounded current or stale regional environment reports.
world.region.known(filters?, cursor?, page_size?) -> query-page- Stable ID
world.region.known- Owner
- game.observer-knowledge
- 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 regions with knowledge confidence, biome, weather, and environmental pressure for the Empire view.
Parameters
- cursor: optional continuation cursor.
- page_size: bounded region-row limit.
Returns
Detached region rows limited to retained observer reports.
Cost
One bounded ObserverKnowledge scan and indexed World environment lookups.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
biome | enumeration | none | yes | Reported regional biome. |
confidence | unsigned-integer | basis-points | yes | Report confidence. |
environmental_pressure | signed-integer | pressure-units | yes | Reported environmental pressure. |
knowledge | enumeration | none | yes | Current or stale knowledge state. |
observed_at_tick | unsigned-integer | ticks | yes | Source observation tick. |
region_id | stable-id | none | yes | Region identity. |
weather | enumeration | none | yes | Reported regional weather. |
Errors
error.capability-unavailableerror.invalid-queryerror.query-budget-exhaustederror.query-contract-violation
Examples
local regions = world.query("world.region.known", {page_size = 16})API history
- 1.19.0: Observer-bounded region reports added for Phase 19Q9F.