EverambleGAME API / 1

CONTENT CONTRACT · VERSION 1

Reference / Effects

grant_xp

Grant a player experience on the character level or a progress track; levels it reaches announce themselves.

Feature
actors
Rights
player_progress
Debits
none
Conflict
accumulating
Errors
invalid_type faultmissing_reference faultout_of_range faultscope_denied faultstale_reference rejectionunknown_field fault

Signature

{ amount: PositiveCount, kind: "grant_xp", player: PlayerRef, track: (ProgressTrackId)? }

Fields

NameTypeMeaning
amountPositiveCountExperience granted.
Range: 1…2147483647; Unit: count
kind"grant_xp"Discriminant
playerPlayerRefPlayer that gains the experience.
Length: 1…256; Pattern: ^[\s\S]+$
trackProgressTrackIdProgress track it goes to; absent: the character level.
Length: 1…129; Pattern: ^[a-z][a-z0-9_]{0,31}:[a-z][a-z0-9_]{0,95}$; Reference: progress_track

Validated example

{
  "amount": 30,
  "kind": "grant_xp",
  "player": "p1",
  "track": "reference:gardening"
}