command · command.construction
Cancel construction
Cancels one current construction project through its existing owners.
command.construction.cancel(construction_id) -> command.receipt- Stable ID
command.construction.cancel- Owner
- game.construction
- Authority
- request
- Timing
- fixed_tick
- Availability
- active-session
- Side effects
- may release construction Work, reservations, and footprint occupancy
- Determinism
- record request and owner result in engine sequence order
- Introduced
- 1.5.0
Usage
Submit the current construction ID returned by world.construction.active. Construction validates current ownership and performs all Work, reservation, material, and footprint cleanup.
Parameters
- construction_id: current Construction identity.
Returns
A fixed-tick command receipt with the owner result.
Cost
One indexed Construction lookup and its bounded transactional cleanup.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
construction_id | stable-id | none | yes | Current construction identity. |
Errors
error.command-budget-exhaustederror.command-owner-rejectederror.command-queue-fullerror.invalid-commanderror.restricted-command
Examples
command.submit("command.construction.cancel", {construction_id = project.construction_id}, 1)API history
- 1.5.0: Normal construction cancellation added for Phase 16D.