command · restricted.actor
Crisis override
Requests development-only crisis control of one Actor through ControlAuthority.
restricted.actor.crisis-override(actor_id, expected_authority_revision, expected_actor_revision) -> command.receipt
- Stable ID
restricted.actor.crisis-override- Owner
- game.control-authority
- Authority
- restricted_request
- Timing
- fixed_tick
- Availability
- active-session
- Side effects
- may interrupt autonomous control with a retained crisis override
- Determinism
- record request and owner result in engine sequence order
- Introduced
- 1.0.0
Usage
Submit restricted.actor.crisis-override through restricted.command.submit from a development package. Supply current expected revisions so the owning service can reject stale intent without partial mutation.
Parameters
- actor_id: Actor identity whose control state will be changed.
- expected_actor_revision: Expected revision of the Actor state.
- expected_authority_revision: Expected revision of the Actor control-authority record.
Returns
A command receipt from the owning fixed-tick command service; acceptance does not mean the command has completed.
Cost
Bounded by per-package command and queue limits; authoritative work occurs once through the fixed-tick owner.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
actor_id | stable-id | none | yes | Actor identity whose control state will be changed. |
expected_actor_revision | revision | none | yes | Expected revision of the Actor state. |
expected_authority_revision | revision | none | yes | Expected revision of the Actor control-authority record. |
Errors
error.command-budget-exhaustederror.command-owner-rejectederror.command-queue-fullerror.invalid-commanderror.restricted-command
Examples
local receipt = restricted.command.submit(
"restricted.actor.crisis-override",
{
actor_id = <stable-id>,
expected_actor_revision = <revision>,
expected_authority_revision = <revision>
},
1
)
API history
- 1.0.0: Runtime contract published from the complete Phase 14 registry.
Related symbols
restricted.actorerror.command-budget-exhaustederror.command-owner-rejectederror.command-queue-fullerror.invalid-commanderror.restricted-command