event · events.command
Command failed
Reports a typed command after its gameplay owner rejects the fixed-tick request.
events.command.failed(request_sequence, command_id, origin_id, target_tick, error_id, detail)- Stable ID
events.command.failed- Owner
- app.script-event-service
- Authority
- read_only
- Timing
- post_commit
- Availability
- active-session
- Side effects
- none
- Determinism
- ordered by event publication sequence and committed tick
- Introduced
- 1.3.0
Usage
Listen for fixed-tick command requests that reached their gameplay owner but were rejected. Display detail to the player and use error_id for stable recovery logic.
Parameters
- request_sequence: rejected command request.
- command_id: stable command identity.
- origin_id: engine-created caller identity.
- target_tick: requested fixed tick.
- error_id: stable rejection identity.
- detail: player-readable owner explanation.
Returns
An immutable event published after the gameplay owner rejects the request without mutation.
Cost
One bounded retained event and one callback delivery per subscribed package.
Fields
| ID | Type | Units | Required | Description |
|---|---|---|---|---|
command_id | string | none | yes | Stable command symbol ID. |
detail | string | none | yes | Player-readable owner rejection detail. |
error_id | string | none | yes | Stable rejection reason ID. |
origin_id | string | none | yes | Engine-created caller origin ID. |
request_sequence | unsigned-integer | none | yes | Rejected command request sequence. |
target_tick | tick | simulation-ticks | yes | Requested fixed simulation tick. |
Errors
- None
Examples
local subscription = events.listen("events.command.failed", function(event)
ui.text("Command", event.payload.detail)
end)API history
- 1.3.0: Owner-rejected command feedback event added for Phase 16D.