query · world.land

World land enclosures

Returns one bounded derived enclosure record per World land area from authoritative area boundaries and operational fence and gate geometry.

world.land.enclosures(filters?, cursor?, page_size?) -> query-page

Stable ID: world.land.enclosures
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 one detached whole-area enclosure summary derived from the World land boundary and current operational fence and gate geometry. Use the enclosure and field-access fields to explain whether the complete area is protected and usable; the query cannot change infrastructure or access.

Parameters

filters.area_id: optional positive stable land-area identity.
cursor: optional stable area-identity continuation cursor returned by the same query.
page_size: positive record limit capped by the host.

Returns

A detached page containing whole-boundary edge, fence, gate, and open-edge counts; enclosure and field-access results; referenced gate-policy information; and a derived infrastructure revision fingerprint.

Cost

Bounded by the page size and current retained land and infrastructure records; results are emitted in stable area identity order.

Fields

ID	Type	Units	Required	Description
`access_policy_count`	`unsigned-integer`	none	yes	Distinct access policies referenced by boundary gates.
`area_id`	`stable-id`	none	yes	World land area identity.
`boundary_edge_count`	`unsigned-integer`	none	yes	Edges in the whole area boundary.
`enclosed`	`boolean`	none	yes	Whether every boundary edge is closed by a fence or gate.
`fence_edge_count`	`unsigned-integer`	none	yes	Boundary edges covered by fences.
`field_accessible`	`boolean`	none	yes	Whether the enclosed area has a gate policy permitting field access.
`gate_edge_count`	`unsigned-integer`	none	yes	Boundary edges covered by gates.
`infrastructure_revision`	`revision`	none	yes	Derived revision fingerprint of current boundary infrastructure.
`open_edge_count`	`unsigned-integer`	none	yes	Boundary edges with no current enclosure.
`primary_access_policy_id`	`string-or-null`	none	no	First stable gate access-policy identity, when present.

Errors

Examples

local result = world.query("world.land.enclosures", {page_size = 8})
if result.status == "completed" then
    for _, area in ipairs(result.records) do
        ui.row("Field " .. tostring(area.area_id), area.enclosed and "enclosed" or "open")
    end
end

API history

1.19.0: Whole-area fence, gate, and field-access inspection added for Village Life M3.