EverambleGAME API / 1

CONTENT CONTRACT · VERSION 1

Reference / Events

item_used

The host validated an item intent and selected exactly its declared use handler.

Feature
authority
Rights
none
Errors
invalid_type faultmissing_reference faultout_of_range faultunknown_field fault

Signature

{ actor: ActorRef, item: ItemId, kind: "item_used", 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_used"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_used",
  "player": "p1",
  "target": "a1"
}