command · command.infrastructure
Cancel infrastructure work
Cancels one current infrastructure project through Construction, Work, Actor, Resource, and World owners.
command.infrastructure.cancel(infrastructure_id, expected_revision) -> command.receipt- Stable ID
command.infrastructure.cancel- Owner
- game.infrastructure-construction
- Authority
- request
- Timing
- fixed_tick
- Availability
- active-session
- Side effects
- may release Work, return delivered materials, and restore the retained World plan
- Determinism
- record request and owner result in engine sequence order
- Introduced
- 1.19.0
Usage
Cancel one current road, fence, or gate project using the infrastructure identity and project revision returned by world.infrastructure.construction. Construction coordinates Work release, Resource return, Actor handoff, and restoration of the World plan.
Parameters
- infrastructure_id: current World local-infrastructure identity.
- expected_revision: current infrastructure-construction project revision.
Returns
A fixed-tick command receipt with the owner result. A stale revision or rejected owner transaction changes no state.
Cost
One indexed project lookup plus bounded transactional cleanup through Construction, Work, Actor, Resource, and World.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
expected_revision | revision | none | yes | Expected infrastructure-construction project revision. |
infrastructure_id | stable-id | none | yes | Current World infrastructure identity. |
Errors
error.command-budget-exhaustederror.command-owner-rejectederror.command-queue-fullerror.invalid-commanderror.restricted-command
Examples
command.submit("command.infrastructure.cancel", {infrastructure_id = project.infrastructure_id, expected_revision = project.revision}, 1)API history
- 1.19.0: Revision-checked infrastructure cancellation added for Village Life M2.