command · command.actor

Release control

Requests release of direct player control through ControlAuthority.

command.actor.release-control(actor_id, expected_authority_revision, expected_actor_revision) -> command.receipt

Stable ID: command.actor.release-control
Owner: game.control-authority
Authority: request
Timing: fixed_tick
Availability: active-session
Side effects: may resume the retained Actor plan and return autonomous authority
Determinism: record request and owner result in engine sequence order
Introduced: 1.0.0

Usage

Submit command.actor.release-control through command.submit. 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

Examples

local receipt = command.submit(
    "command.actor.release-control",
    {
        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.