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

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

IDTypeUnitsRequiredDescription
actor_idstable-idnoneyesActor identity whose control state will be changed.
expected_actor_revisionrevisionnoneyesExpected revision of the Actor state.
expected_authority_revisionrevisionnoneyesExpected revision of the Actor control-authority record.

Errors

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

Related symbols

Project references