query · world.faction
Faction standings
Returns bounded Faction-owned identity, strategy, territory, and relation facts.
world.faction.standings(filters?, cursor?, page_size?) -> query-page- Stable ID
world.faction.standings- Owner
- game.faction 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 stable Faction identity, current goal, strategic intent, standing, relation pressure, territory count, and anchor site.
Parameters
- cursor: optional continuation cursor.
- page_size: bounded Faction-row limit.
Returns
Detached Faction-owned strategy and relation rows, or unavailable when the scenario has no Faction owner.
Cost
One bounded Faction scan with indexed relation and topology lookups.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
anchor_site_id | stable-id-or-null | none | no | First stable territory site. |
anchor_x_meters | number-or-null | meters | no | Territory anchor World X coordinate. |
anchor_y_meters | number-or-null | meters | no | Territory anchor World Y coordinate. |
faction_id | stable-id | none | yes | Faction identity. |
goal | enumeration | none | yes | Current Faction goal. |
name | string | none | yes | Faction display name. |
relation_pressure | unsigned-integer | basis-points | yes | Current relation pressure. |
stance | enumeration | none | yes | Standing relative to the first stable faction. |
strategic_intent | enumeration | none | yes | Current retained strategic intent. |
territory_site_count | unsigned-integer | none | yes | Known territory site count. |
updated_at_tick | unsigned-integer | ticks | yes | Latest Faction update. |
Errors
error.capability-unavailableerror.invalid-queryerror.query-budget-exhaustederror.query-contract-violation
Examples
local factions = world.query("world.faction.standings", {page_size = 16})API history
- 1.19.0: Faction standings added for Phase 19Q9F.