Grant Origin (Entity Action Type)

Gives a player one named origin. On a normal layer it becomes their pick; on a swappable layer it is added to their swap pool.

Type ID: origins:grant_origin — an entity action.

Needs the Origins mod. Registered by Origins, not core Apoli. It only runs for players.

Fields#

Field	Type	Default	Purpose
origin	Identifier	required	The origin to grant. Unknown ids and origins:empty do nothing.
layer	Identifier	origins:origin	The layer to grant it on.
to_pool	Boolean	false	On a normal layer, put the origin in that layer’s swap pool instead of making it the player’s pick. Ignored on a swappable layer, where a grant is always a pool grant. Also accepts the alias swappable.

What “granting” means per layer kind#

layer is	Result
a normal layer	the origin becomes the player’s pick there, exactly as /origin set would
a normal layer, with to_pool: true	the origin is added to the swap pool feeding that layer — the player can swap to it, but their own origin is untouched
a swappable layer	the origin is added to that pool

Pool grants are per player and are not checked against the layer’s origins list, so a swappable layer can ship empty and be filled entirely at run time.

Examples#

Give the player the Phantom origin outright:

{
  "type": "origins:grant_origin",
  "origin": "origins:phantom",
  "layer": "origins:origin"
}

Unlock an extra form they can swap into, without disturbing what they are now:

{
  "type": "origins:grant_origin",
  "origin": "example:wolf_form",
  "layer": "origins:origin",
  "to_pool": true
}

To take one back, use origins:revoke_origin. To move one between two players, use origins:transfer_origin.