Store Value (Entity Action Type)

Entity action — stores a piece of text on the entity under a named key.

Stores a piece of text on the entity under a named key — a marker, a name, a state flag — retrievable with origins:stored_value.

Type ID: origins:store_value — an entity action.

Needs the Origins mod. Registered by Origins, not core Apoli. It only works on players, and only on the server. See Origin storage for the system as a whole.

Fields

FieldTypeDefaultPurpose
keyStringrequiredThe name to store the text under.
valueString""The text to store. [other_key] placeholders are expanded against the same player’s store before it is written.
clearBooleanfalseRemove the entry at key instead of writing one.

If value contains a placeholder that can’t be resolved, nothing is stored.

Placeholders

[key] expands to whatever is under key: a stored origin’s id, or a stored text value. [key.name] expands to a stored origin’s display name instead of its id.

Examples

Mark a state:

{
  "type": "origins:store_value",
  "key": "phase",
  "value": "cursed"
}

Record the display name of a stored origin so it can be shown in a message later:

{
  "type": "origins:store_value",
  "key": "stolen_name",
  "value": "[stolen.name]"
}