MagicActivationPayload
Used by MagicItem
This is a nested shape inside a content file. The catalog explains context validation and links real RON examples.
What an activated magic item releases. Spell payloads resolve through the ordinary spell composition; effect payloads carry the same typed effect steps directly for items whose magic is not a named spell.
Spell
Select the spell behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| area_override | Area | optional | An item-authored replacement for the referenced spell's delivery area. This changes only the footprint; the ordinary spell keeps ownership of its save, effects, duration, and concentration. |
| forced_action_options | array | optional | A non-empty subset of a referenced spell's authored forced-action choices. The activation may narrow a spell's menu but cannot add a command the spell itself does not know. |
| spell | string | required |
Effect
Select the effect behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| delivery | Delivery | required | |
| duration_roll | RolledDuration | optional | One activation-scoped duration roll shared by every subject the delivery reaches. The roll is made once, then multiplied by this many world seconds (for example, 60 for a duration in minutes). |
| duration_secs | integer | optional | How long the composed direct effect persists. Instantaneous effects omit this; item magic never inherits concentration. |
| effects | Effect[] | required | |
| range_ft | uint32 | default 0 | |
| self_only | boolean | default false | The item's bearer is the only legal target. This is distinct from range 0, which retains the ordinary touch-target behavior. |
| then | SpellPhase[] | optional | Ordered follow-up phases with independent delivery gates. These share the activation's target/aim but do not repay its economy or consumption, matching the ordinary staged-spell substrate. |
RecoverSpellSlot
Restore one expended spell slot of this exact level. A definition may expose several activation options so the player/solver chooses the expended slot explicitly rather than an item policy choosing for them.
| Field | Type | Required | Description |
|---|---|---|---|
| level | uint8 | required |
GrantedAction
Consume/activate an item to install a world-portable later action.
| Field | Type | Required | Description |
|---|---|---|---|
| consume_on_success | boolean | default false | |
| delivery | GrantedActionDelivery | required | |
| duration_secs | uint64 | required | |
| economy | CastTime | required | |
| effects | GrantedActionEffect[] | required | |
| uses | uint16 | required |