EverambleGAME API / 1

CONTENT CONTRACT · VERSION 1

Reference / Events

item_use_committed

A successful item use committed; delivered no earlier than the following tick.

Feature
authority
Rights
none
Errors
invalid_type faultmissing_reference faultout_of_range faultunknown_field fault

Signature

{ actor: ActorRef, item: ItemId, kind: "item_use_committed", player: (PlayerRef)?, target: ActorRef }

Fields

NameTypeMeaning
actorActorRefActing actor (human- or AI-controlled) that used the item from its own inventory.
Length: 1…256; Pattern: ^[\s\S]+$
itemItemIdInventory item definition to count, consume or match.
Length: 1…129; Pattern: ^[a-z][a-z0-9_]{0,31}:[a-z][a-z0-9_]{0,95}$; Reference: item
kind"item_use_committed"Discriminant
playerPlayerRefPlayer controlling the actor; absent for AI-controlled actors.
Length: 1…256; Pattern: ^[\s\S]+$
targetActorRefActor instance selected by the item-use target contract.
Length: 1…256; Pattern: ^[\s\S]+$

Validated example

{
  "actor": "a1",
  "item": "core:healing_potion",
  "kind": "item_use_committed",
  "player": "p1",
  "target": "a1"
}