query · world.infrastructure

World local infrastructure

Returns bounded World-owned local road, fence, and gate plans with typed connection anchors, immutable geometry counts, material, access, condition, and lifecycle.

world.infrastructure.local(filters?, cursor?, page_size?) -> query-page

Stable ID: world.infrastructure.local
Owner: 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 stable World-owned local infrastructure records. Typed endpoint anchors distinguish buildings, landmarks, dedicated land, settlements, and regional connections; lifecycle and condition remain detached read-only facts.

Parameters

filters.infrastructure_id: optional positive stable local-infrastructure identity.
cursor: optional stable-identity continuation cursor returned by the same query.
page_size: positive record limit capped by the host.

Returns

A detached page containing identity, kind, typed anchors, endpoint cells, material, access policy, lifecycle stage, condition, geometry counts, revision, and causal ticks.

Cost

Bounded by page size and owner-visit budgets. World resumes from the stable identity cursor without scanning preceding records.

Fields

ID	Type	Units	Required	Description
`access_policy_id`	`string`	none	yes	Referenced access-policy identity.
`cell_count`	`unsigned-integer`	none	yes	Cells in road geometry.
`condition`	`unsigned-integer`	basis-points	yes	Current condition.
`created_at_tick`	`unsigned-integer`	ticks	yes	Plan creation tick.
`edge_count`	`unsigned-integer`	none	yes	Edges in fence or gate geometry.
`from_anchor_id`	`stable-id`	none	yes	First connection anchor identity.
`from_anchor_kind`	`enumeration`	none	yes	First typed connection anchor.
`from_cell_x`	`signed-integer`	grid-cells	yes	First anchor cell X.
`from_cell_y`	`signed-integer`	grid-cells	yes	First anchor cell Y.
`infrastructure_id`	`stable-id`	none	yes	Local infrastructure identity.
`kind`	`enumeration`	none	yes	Road, fence, or gate.
`material_resource_id`	`string`	none	yes	Validated physical material identity.
`permits_construction_access`	`boolean`	none	yes	Whether the referenced policy permits construction access.
`permits_field_access`	`boolean`	none	yes	Whether the referenced policy permits field work access.
`permits_local_travel`	`boolean`	none	yes	Whether the referenced policy permits Actor traversal.
`revision`	`revision`	none	yes	World infrastructure revision.
`stage`	`enumeration`	none	yes	Current infrastructure lifecycle stage.
`to_anchor_id`	`stable-id-or-null`	none	no	Second connection anchor identity.
`to_anchor_kind`	`enumeration-or-null`	none	no	Second typed connection anchor.
`to_cell_x`	`signed-integer-or-null`	grid-cells	no	Second anchor cell X.
`to_cell_y`	`signed-integer-or-null`	grid-cells	no	Second anchor cell Y.
`travel_reduction`	`unsigned-integer`	basis-points	yes	Maximum road traversal-cost reduction at full condition.
`updated_at_tick`	`unsigned-integer`	ticks	yes	Latest World mutation tick.

Errors

Examples

local result = world.query("world.infrastructure.local", {page_size = 16})
if result.status == "completed" then
    for _, item in ipairs(result.records) do
        ui.row(item.kind .. " " .. tostring(item.infrastructure_id), item.from_anchor_kind .. " to " .. tostring(item.to_anchor_kind))
    end
end

API history

1.19.0: Persistent local road, fence, gate, and anchor facts added for Village Life M1.