Practical guide

Inspect and direct infrastructure work

Inspect roads, fences, gates, condition causes, and physical work, then request repair or extension without bypassing simulation owners.

Procedure

1. Query world.infrastructure.local for current identity, lifecycle, condition, geometry, access, and World revision facts.
2. Query world.infrastructure.maintenance for the latest bounded Settlement candidate trace, condition wear evidence, resource readiness, and next autonomous evaluation tick.
3. Submit command.infrastructure.request-work with one Settlement identity, infrastructure identity, and repair or extension kind when explicit direction is needed.
4. Query world.infrastructure.construction for the designated project, worker, Work job, Resource containers, progress, and current project revision.
5. Use command.work.set-priority or command.work.assign for normal labor direction, command.infrastructure.cancel for revision-checked cancellation, and command.infrastructure.set-access-policy only for gate policy changes.

Example

local candidates = world.query(
    "world.infrastructure.maintenance",
    {page_size = 8}
)
for _, item in ipairs(candidates.records) do
    if item.eligible and item.work_kind == "repair" then
        command.submit(
            "command.infrastructure.request-work",
            {
                settlement_id = 1,
                infrastructure_id = item.infrastructure_id,
                kind = "repair"
            },
            1
        )
        break
    end
end

Constraints and recovery

• Lua requests work; World retains condition, Settlement retains the choice, Construction retains progress, Work retains jobs and claims, Actor retains travel and labor, and Resource retains every physical unit.
• Broken roads provide no travel reduction. Broken fences and gates provide no enclosure or traversal effect until repair completes.
• Autonomous maintenance continues without Lua. Direction uses the same candidate and capacity checks rather than a separate mutation path.
• Use expected revisions for cancellation and gate policy changes. A retained query row is detached and may be stale by the command tick.

Related symbols

• world.infrastructure.local
• world.infrastructure.maintenance
• world.infrastructure.construction
• world.land.enclosures
• command.infrastructure.request-work
• command.infrastructure.cancel
• command.infrastructure.set-access-policy
• command.work.set-priority
• command.work.assign

Project references

• Game Development Phase 19
• Engine extension contract