command · command.infrastructure

Request infrastructure work

Directs one Settlement to evaluate a specific repair or network extension through current World, Construction, Work, Resource, and labor facts.

command.infrastructure.request-work(settlement_id, infrastructure_id, kind) -> command.receipt

Stable ID: command.infrastructure.request-work
Owner: game.settlement
Authority: request
Timing: fixed_tick
Availability: active-session
Side effects: may retain a Settlement decision and designate one repair or extension project
Determinism: record request and owner result in engine sequence order
Introduced: 1.19.0

Usage

Ask one Settlement to evaluate a specific damaged or proposed infrastructure record as repair or extension work. The same chooser verifies current condition, construction capacity, physical material custody, and the retained site inventory before it designates Work.

Parameters

settlement_id: Settlement responsible for the requested work.
infrastructure_id: damaged, broken, or proposed World infrastructure identity.
kind: repair or extension.

Returns

A fixed-tick command receipt with the Settlement and Construction owner result. Invalid kind, unavailable materials, occupied capacity, or mismatched lifecycle changes no work owner.

Cost

One bounded Settlement decision over the directed candidate plus indexed World, Resource, and Construction owner checks.

Fields

ID	Type	Units	Required	Description
`infrastructure_id`	`stable-id`	none	yes	Damaged, broken, or proposed World infrastructure identity.
`kind`	`string`	none	yes	Requested work kind: repair or extension.
`settlement_id`	`stable-id`	none	yes	Settlement responsible for the requested work.

Errors

Examples

command.submit("command.infrastructure.request-work", {settlement_id = 1, infrastructure_id = item.infrastructure_id, kind = "repair"}, 1)

API history

1.19.0: Settlement-owned repair and extension direction added for Village Life M4.