# Spell

> Kinbarrow modding reference — content tree `b2f73c2ab65ff925`, version `0.2.0+main.a22009f4c`.

`spells/<id>.srd.ron` — one spell per file; stem == id (the layout contract's promised one-file-per-entity collection). A spell is a COMPOSITION: one [`Delivery`] carrying a list of [`Effect`]s — data assembles new spells from the primitives with no engine code.

**Note on syntax:** these files are RON, not JSON. The shapes below are exact,
but punctuation follows RON — read a real `data/*.ron` file alongside.

## Fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cancellation_immune` | `boolean` | default `false` | The ongoing spell cannot be ended by spell-level cancellation. |
| `cantrip_steps` | `boolean` | required | Cantrip damage-dice steps at character levels 5/11/17 (SRD). |
| `cast` | `CastTime` | required | The casting time: Action, BonusAction, or Reaction. |
| `classes` | `string[]` | required | The class lists this spell is on (class ids, boot-resolved). |
| `components` | `SpellComponents` | default `{"material":false,"material_consumed":false,"material_costly":false,"somatic":false,"verbal":false}` | Required verbal, somatic, and material components. |
| `concentration` | `boolean` | default `false` | This spell demands CONCENTRATION: its ongoing effects last only while the caster holds focus (one at a time; damage forces a save; a new concentration cast drops the old). Absent = no concentration. |
| `delivery` | `Delivery` | required | The one roll/selection gate between the caster and the effect list. |
| `duration_secs` | `integer` | optional | The spell's SRD duration in SECONDS (the ambient clock — a ward cast outside the bubble expires at now + duration). Absent = instantaneous (the strike-and-done corpus). A concentration spell's duration is its "up to" cap. |
| `effects` | `Effect[]` | required | The composed effect steps applied to each delivered target. |
| `id` | `string` | required | Authored id. |
| `level` | `uint32` | required | 0 = cantrip. |
| `name` | `string` | required | Authored name. |
| `range` | `SpellRange` | required | The spell's range. |
| `reaction_trigger` | `ReactionSpellTrigger` | optional | Required event window for a Reaction cast; absent for turn-time spells. |
| `requires_hearing` | `boolean` | default `false` | The spell only reaches a target that can HEAR the caster (vicious mockery's "if the target can hear you"). A deafened target is untouched: it rolls no save, because the spell never arrives. |
| `requires_sight` | `boolean` | default `false` | The spell only reaches a target the caster can see. |
| `school` | `string` | required | A `tables/schools.srd.ron` id, boot-resolved. |
| `source` | `Source` | required | Authored source. |
| `target_type` | `string` | optional | The targeting gate: a `tables/creature_types.srd.ron` id the target's own creature type must match — hold person's "one humanoid". The one seam future type-gated spells plug into (charm person, dominate person → humanoid; banishment → a plane's natives) with no new machinery. Absent = the spell checks no creature type. |
| `then` | `SpellPhase[]` | default `[]` | Ordered phases resolved after the required first phase. A later phase runs regardless of the preceding phase's hit, miss, save, or targets. |
| `upcast` | `Upcast` | required | How the spell scales at higher slot levels. |
| `upcast_effects` | `array` | optional | Zero-based positions in effects that receive higher-slot roll scaling. Absence uses the first cast-time roll and each ongoing roll, preserving single-roll spells. An explicit list must be nonempty and name only effects with scalable dice. Later phases own their own target lists. Supported rolls: Damage, DamageTypeChoice, Heal, TempHp, SelfDamageHealTarget, TurnStartDamage, AttackHitDamageGrant, Aura, Zone, WallDamage, Beam, and TriggeredZone. |

## Nested shapes

<a id="ability"></a>

### Ability

An open, validated Ability id interned from authored data.

<a id="affliction-entry-effect"></a>

### AfflictionEntryEffect

Authorable `AfflictionEntryEffect` data exposed through the modding schema.

<a id="affliction-entry-effect--drop-held-items"></a>

#### AfflictionEntryEffect::DropHeldItems

Select the drop held items behavior.

<a id="antimagic-policy"></a>

### AntimagicPolicy

Authorable `AntimagicPolicy` data exposed through the modding schema.

<a id="antimagic-policy--suppress-resume"></a>

#### AntimagicPolicy::SuppressResume

Select the suppress resume behavior.

<a id="antimagic-policy--suppress-end"></a>

#### AntimagicPolicy::SuppressEnd

Select the suppress end behavior.

<a id="antimagic-policy--immune"></a>

#### AntimagicPolicy::Immune

Select the immune behavior.

<a id="area"></a>

### Area

An area of effect, resolved on the encounter board's 5 ft grid: a sphere centers on the TARGET, a cone/line throws from the CASTER toward it, a burst centers on the caster (thunderwave's "Self (15-foot cube)", radius-approximated on the Chebyshev grid).

<a id="area--sphere"></a>

#### Area::Sphere

A sphere of `radius_ft`, centered on the target point (fireball).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `radius_ft` | `uint32` | required |  |

<a id="area--cone"></a>

#### Area::Cone

A cone of `length_ft`, thrown from the caster toward the target (burning hands).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `length_ft` | `uint32` | required |  |

<a id="area--line"></a>

#### Area::Line

A line of `length_ft`, thrown from the caster toward the target (lightning bolt).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `length_ft` | `uint32` | required |  |

<a id="area--rectangle"></a>

#### Area::Rectangle

A directional rectangle with independently authored long and wide dimensions. Placement supplies a near-left corner and a second point choosing its long axis; neither dimension is approximated as a line or sphere.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `length_ft` | `uint32` | required |  |
| `width_ft` | `uint32` | required |  |

<a id="area--burst"></a>

#### Area::Burst

A burst of `radius_ft` centered on the caster (thunderwave's "Self" cube, radius-approximated on the grid).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `radius_ft` | `uint32` | required |  |

<a id="area--emanation"></a>

#### Area::Emanation

A radius centered on and including the origin creature. Unlike a burst, an emanation includes its origin and needs no aim point.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `radius_ft` | `uint32` | required |  |

<a id="armor-category"></a>

### ArmorCategory

The SRD armor categories — light/medium/heavy body armor and the shield.

<a id="armor-category--light"></a>

#### ArmorCategory::Light

Select the light behavior.

<a id="armor-category--medium"></a>

#### ArmorCategory::Medium

Select the medium behavior.

<a id="armor-category--heavy"></a>

#### ArmorCategory::Heavy

Select the heavy behavior.

<a id="armor-category--shield"></a>

#### ArmorCategory::Shield

Select the shield behavior.

<a id="attack-hit-damage-consequence"></a>

### AttackHitDamageConsequence

A consequence gated by the actual post-mitigation damage of an `AttackHitDamageGrant`. Keeping the trigger attached to the damage instance means immunity correctly prevents the consequence as well.

<a id="attack-hit-damage-consequence--prevent-healing-until-source-next-turn"></a>

#### AttackHitDamageConsequence::PreventHealingUntilSourceNextTurn

Select the prevent healing until source next turn behavior.

<a id="authored-choice-payload"></a>

### AuthoredChoicePayload

Authorable `AuthoredChoicePayload` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `option_set` | `string` | required | Authored option set. |
| `options` | `string[]` | required | Authored options. |
| `resource_cost` | `uint16` | default `0` | Authored resource cost. |

<a id="authored-forced-action"></a>

### AuthoredForcedAction

Authorable `AuthoredForcedAction` data exposed through the modding schema.

<a id="authored-forced-action--approach"></a>

#### AuthoredForcedAction::Approach

Select the approach behavior.

<a id="authored-forced-action--drop"></a>

#### AuthoredForcedAction::Drop

Select the drop behavior.

<a id="authored-forced-action--flee"></a>

#### AuthoredForcedAction::Flee

Select the flee behavior.

<a id="authored-forced-action--grovel"></a>

#### AuthoredForcedAction::Grovel

Select the grovel behavior.

<a id="authored-forced-action--halt"></a>

#### AuthoredForcedAction::Halt

Select the halt behavior.

<a id="cancellation-check"></a>

### CancellationCheck

The closed resolution gate for cancelling a spell or ongoing effect.

<a id="cancellation-check--automatic"></a>

#### CancellationCheck::Automatic

Select the automatic behavior.

<a id="cancellation-check--d20"></a>

#### CancellationCheck::D20

Select the d20 behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dc` | `int64` | required |  |
| `modifier` | `int64` | required |  |

<a id="cancellation-check--slot-level-or-spellcasting-check"></a>

#### CancellationCheck::SlotLevelOrSpellcastingCheck

End ongoing spells at or below the casting slot's level automatically; check higher-level spells using the caster's spellcasting ability against the base DC plus the ongoing spell's level.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dc_base` | `int64` | required |  |

<a id="cancellation-check--saving-throw"></a>

#### CancellationCheck::SavingThrow

The interrupted creature saves against the authored DC; cancellation occurs on a failed save.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `dc` | `int64` | required |  |

<a id="cancellation-check--saving-throw-against-caster-dc"></a>

#### CancellationCheck::SavingThrowAgainstCasterDc

The interrupted creature saves against the reacting caster's spell save DC. Cancellation occurs on a failed save.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |

<a id="cast-spell-filter"></a>

### CastSpellFilter

A spell catalogue predicate used by cast privileges, transformations and preparation access. Nonempty fields are combined: a spell must satisfy every authored field.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cantrip` | `boolean` | optional | When present, require or forbid a cantrip. |
| `cast_times` | `CastTime[]` | default `[]` | Casting times accepted by the rule. Empty accepts every casting time. |
| `classes` | `string[]` | default `[]` | Class-list ids. Empty accepts every class list. |
| `maximum_level` | `integer` | optional | Inclusive highest spell level. Absent has no level ceiling. |
| `minimum_level` | `integer` | optional | Inclusive lowest spell level. Absent has no level floor. |
| `schools` | `string[]` | default `[]` | School ids. Empty accepts every school. |
| `spell_ids` | `string[]` | default `[]` | Exact open spell ids. Empty accepts every id. |

<a id="cast-time"></a>

### CastTime

Casting times supported by the combat turn economy: Action, BonusAction, and Reaction. Longer castings, such as rituals, are not represented here.

<a id="cast-time--action"></a>

#### CastTime::Action

Select the action behavior.

<a id="cast-time--bonus-action"></a>

#### CastTime::BonusAction

Select the bonus action behavior.

<a id="cast-time--reaction"></a>

#### CastTime::Reaction

Select the reaction behavior.

<a id="cast-transform-option"></a>

### CastTransformOption

One open-id cast transformation. The id records the choice; only its authored filter, price, compatibility, and transformations select rules.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `compatible_with` | `string[]` | default `[]` | Other option ids that may be combined with this option. |
| `cost` | `uint32` | required | Units charged to `pool`; zero is legal for automatic transformations. |
| `filter` | `CastSpellFilter` | default `{"cantrip":null,"cast_times":[],"classes":[],"maximum_level":null,"minimum_level":null,"schools":[],"spell_ids":[]}` | Spell predicate that must accept the cast. |
| `id` | `string` | required | Open option id used by UI and recorded decisions, never dispatch. |
| `minimum_class_level` | `uint32` | required | First granting-class level at which this option is legal. |
| `pool` | `string` | optional | Authored resource pool charged when the option has a positive cost. |
| `transformations` | `CastTransformation[]` | required | Nonempty ordered transformation composition. |

<a id="cast-transformation"></a>

### CastTransformation

A bounded mechanical change an authored cast-transform option applies.

<a id="cast-transformation--range-feet"></a>

#### CastTransformation::RangeFeet

Replace the spell's range when its printed range meets the minimum.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `feet` | `uint32` | required |  |
| `minimum_printed_ft` | `uint32` | required |  |

<a id="cast-transformation--range-multiplier"></a>

#### CastTransformation::RangeMultiplier

Multiply a ranged spell and give a Touch spell the authored reach.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `multiplier` | `uint32` | required |  |
| `touch_feet` | `uint32` | required |  |

<a id="cast-transformation--extra-targets"></a>

#### CastTransformation::ExtraTargets

Add distinct targets near the first target.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | `uint32` | required |  |
| `within_ft` | `uint32` | required |  |

<a id="cast-transformation--economy"></a>

#### CastTransformation::Economy

Change the spell's turn economy.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cast` | `CastTime` | required |  |

<a id="cast-transformation--duration-multiplier"></a>

#### CastTransformation::DurationMultiplier

Multiply a finite duration by this positive factor.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `multiplier` | `uint32` | required |  |

<a id="cast-transformation--duration-seconds"></a>

#### CastTransformation::DurationSeconds

Replace the spell's finite duration with this exact positive value.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `seconds` | `uint64` | required |  |

<a id="cast-transformation--concentration"></a>

#### CastTransformation::Concentration

Replace the spell's concentration requirement.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `required` | `boolean` | required |  |

<a id="cast-transformation--ignore-components"></a>

#### CastTransformation::IgnoreComponents

Suppress the named ordinary component requirements.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `components` | `SpellComponents` | required |  |

<a id="cast-transformation--reroll-damage-dice"></a>

#### CastTransformation::RerollDamageDice

Reroll up to this authored number of damage dice.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `maximum` | `FeatureValue` | required |  |

<a id="cast-transformation--reroll-attack-roll"></a>

#### CastTransformation::RerollAttackRoll

Reroll a missed spell attack up to this many times.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `maximum` | `uint32` | required |  |

<a id="cast-transformation--save-disadvantage"></a>

#### CastTransformation::SaveDisadvantage

Give one target Disadvantage on its first save against the spell.

<a id="cast-transformation--damage-kind-choice"></a>

#### CastTransformation::DamageKindChoice

Choose the resulting damage kind from this nonempty open-id set.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kinds` | `string[]` | required |  |

<a id="cast-transformation--protect-area-allies"></a>

#### CastTransformation::ProtectAreaAllies

Protect a bounded number of creatures in an area. The base capacity is composed with the optional per-spell-level increment.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `capacity` | `FeatureValue` | required |  |
| `per_spell_level` | `uint32` | required |  |

<a id="cast-transformation--add-ability-damage"></a>

#### CastTransformation::AddAbilityDamage

Add the named ability modifier once to one matching damage roll.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |

<a id="cast-transformation--maximize-damage"></a>

#### CastTransformation::MaximizeDamage

Maximize the spell's damage dice.

<a id="cast-transformation--half-damage-on-successful-save"></a>

#### CastTransformation::HalfDamageOnSuccessfulSave

A successful save against a damaging cantrip takes half damage.

<a id="cast-transformation--waive-cost-per-turn"></a>

#### CastTransformation::WaiveCostPerTurn

Waive the option's resource cost for a bounded number of uses per turn.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `uses` | `uint32` | required |  |

<a id="choice-delivery-option"></a>

### ChoiceDeliveryOption

One explicit delivery choice, resolved through the ordinary cast target, save, and effect readers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bonus` | `FeatureValue` | optional | Optional feature-derived flat bonus applied once to the option. |
| `delivery` | `Delivery` | required | Target, attack, or save gate applied before its effects. |
| `dice_count_by_level` | `[uint32, uint32][]` | default `[]` | Strictly increasing `(class level, dice count)` rows applied to the option's damage or healing dice. |
| `effects` | `Effect[]` | required | Ordered effects delivered by this option. |
| `id` | `string` | required | Open option id used by UI and recorded decisions, never dispatch. |
| `range` | `SpellRange` | required | Range of this option's ordinary cast-shaped delivery. |

<a id="contingent-consequence"></a>

### ContingentConsequence

Authorable `ContingentConsequence` data exposed through the modding schema.

<a id="contingent-consequence--prevent-drop-to-one"></a>

#### ContingentConsequence::PreventDropToOne

Select the prevent drop to one behavior.

<a id="contingent-predicate"></a>

### ContingentPredicate

Authorable `ContingentPredicate` data exposed through the modding schema.

<a id="contingent-predicate--would-drop-to-zero"></a>

#### ContingentPredicate::WouldDropToZero

Select the would drop to zero behavior.

<a id="contingent-predicate--turn-start"></a>

#### ContingentPredicate::TurnStart

Select the turn start behavior.

<a id="contingent-predicate--turn-end"></a>

#### ContingentPredicate::TurnEnd

Select the turn end behavior.

<a id="contingent-predicate--takes-damage"></a>

#### ContingentPredicate::TakesDamage

Select the takes damage behavior.

<a id="contingent-timing"></a>

### ContingentTiming

Authorable `ContingentTiming` data exposed through the modding schema.

<a id="contingent-timing--before-event"></a>

#### ContingentTiming::BeforeEvent

Select the before event behavior.

<a id="contingent-timing--after-event"></a>

#### ContingentTiming::AfterEvent

Select the after event behavior.

<a id="d20-edge"></a>

### D20Edge

A one-shot d20 edge armed by a feature action.

<a id="d20-edge--self-advantage"></a>

#### D20Edge::SelfAdvantage

Advantage on the bearer's next eligible d20 test.

<a id="d20-edge--incoming-attack-disadvantage"></a>

#### D20Edge::IncomingAttackDisadvantage

Disadvantage on the next attack made against the bearer.

<a id="damage-roll-amount"></a>

### DamageRollAmount

A damage amount supplied by a generic damage-roll policy.

<a id="damage-roll-amount--dice-by-level"></a>

#### DamageRollAmount::DiceByLevel

Dice selected from a strictly increasing class-level table.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `by_level` | `[uint32, string][]` | required |  |

<a id="damage-roll-amount--ability-modifier"></a>

#### DamageRollAmount::AbilityModifier

One authored ability modifier, subject to an authored minimum.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `minimum` | `int64` | required |  |

<a id="damage-roll-amount--override-die-faces"></a>

#### DamageRollAmount::OverrideDieFaces

Replace one eligible damage die's faces with this die size.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `faces` | `uint32` | required |  |

<a id="damage-roll-outcome"></a>

### DamageRollOutcome

The resolved roll boundary at which a damage policy applies.

<a id="damage-roll-outcome--hit"></a>

#### DamageRollOutcome::Hit

An eligible attack hit.

<a id="damage-roll-outcome--miss"></a>

#### DamageRollOutcome::Miss

An eligible attack or spell missed.

<a id="damage-roll-outcome--failed-save"></a>

#### DamageRollOutcome::FailedSave

The target failed the effect's saving throw.

<a id="damage-roll-outcome--successful-save"></a>

#### DamageRollOutcome::SuccessfulSave

The target succeeded on the effect's saving throw.

<a id="damage-roll-source"></a>

### DamageRollSource

The authored attack or spell family whose damage a generic feature effect may inspect or amend.

<a id="damage-roll-source--weapon"></a>

#### DamageRollSource::Weapon

Any ordinary weapon attack.

<a id="damage-roll-source--melee-weapon"></a>

#### DamageRollSource::MeleeWeapon

An attack with a Melee weapon: a weapon of a melee category, whether it is swung or thrown.

<a id="damage-roll-source--unarmed-strike"></a>

#### DamageRollSource::UnarmedStrike

An unarmed strike.

<a id="damage-roll-source--bound-weapon"></a>

#### DamageRollSource::BoundWeapon

The weapon currently bound through an authored feature action.

<a id="damage-roll-source--cantrip"></a>

#### DamageRollSource::Cantrip

Any cantrip damage roll.

<a id="damage-roll-source--spell"></a>

#### DamageRollSource::Spell

One of the listed open spell ids.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ids` | `string[]` | required |  |

<a id="damage-roll-source--mark"></a>

#### DamageRollSource::Mark

Damage attached to the bearer's current authored mark.

<a id="damage-roll-source--attack-roll"></a>

#### DamageRollSource::AttackRoll

Any attack roll: one made with a weapon, an Unarmed Strike, a natural attack or a spell. A spell that makes several attack rolls, one for each ray or beam, makes each of them its own attack roll.

<a id="delivery"></a>

### Delivery

How a cast DELIVERS its effects: the ONE roll/selection gate between the caster and whoever the effect list lands on. A spell is `delivery × effects` — a modded spell composes these primitives freely with no engine code; only a new PRIMITIVE (and, later, a scripted one through the Layer-2 modhost) needs code.

<a id="delivery--weapon-attack"></a>

#### Delivery::WeaponAttack

Make one attack with a concrete carried melee weapon as part of this cast. The action names the reified weapon; a hit resolves its ordinary weapon effects and then this spell phase's effects.

<a id="delivery--attack"></a>

#### Delivery::Attack

A spell attack roll (d20 + PB + casting mod vs AC), once per ray — each hit delivers the effect list (scorching ray rolls three).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cantrip_rays` | `boolean` | default `false` | The rays step with character level the way a cantrip's dice do: twice as many at 5th level, three times at 11th, four times at 17th (eldritch blast's beams). The damage dice stay as written. Cantrips only. Omit for a fixed ray count. |
| `melee` | `boolean` | default `false` | Whether these are melee spell attacks. Omit for ranged spell attacks; the spell's range does not determine its attack kind. |
| `rays` | `uint32` | required |  |

<a id="delivery--auto"></a>

#### Delivery::Auto

Unerring bolts (magic missile): every dart lands, no roll.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `darts` | `uint32` | required |  |

<a id="delivery--auto-area"></a>

#### Delivery::AutoArea

Every subject in the area receives the effect list without a roll.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `area` | `Area` | required |  |

<a id="delivery--save"></a>

#### Delivery::Save

A saving throw against the caster's DC for everyone caught — the named target, or every combatant an [`Area`] takes in. A SUCCESS spares per [`OnSave`]; non-damage effects land only on a failure.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `area` | `Area` | optional |  |
| `on_save` | `OnSave` | required |  |

<a id="delivery--chain-save"></a>

#### Delivery::ChainSave

One primary in spell range plus up to `secondary_targets` distinct creatures within `chain_range_ft` of that primary. Every selected creature makes its own save and receives the effect list independently.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `chain_range_ft` | `uint32` | required |  |
| `on_save` | `OnSave` | required |  |
| `secondary_targets` | `uint32` | required |  |

<a id="delivery--allies"></a>

#### Delivery::Allies

The named ally plus the worst-hurt others in range, up to `targets` (mass healing word's six) — the derived-policy pick.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `targets` | `uint32` | required |  |

<a id="delivery--target"></a>

#### Delivery::Target

The named target alone, no roll — the touch utilities.

<a id="effect"></a>

### Effect

The shared mechanic vocabulary for spells and feature grants, including delivered effects, passive rules, activated actions, and combat triggers. It includes conditions, summons, forced movement, and ongoing effects governed by a spell's concentration. Supported effects depend on their context. Passives, actions, and triggers validate their own supported subsets; delivered spells follow their delivery and composition rules.

<a id="effect--cast-privilege"></a>

#### Effect::CastPrivilege

Authorize a cast matching an authored spell predicate and independently state which ordinary casting costs or form restrictions are exempt.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `allowed_while_transformed` | `boolean` | default `false` |  |
| `filter` | `CastSpellFilter` | required |  |
| `ignore_components` | `SpellComponents` | default `{"material":false,"material_consumed":false,"material_costly":false,"somatic":false,"verbal":false}` |  |
| `ignore_consumed_material` | `boolean` | default `false` |  |
| `ignore_costly_material` | `boolean` | default `false` |  |
| `profile` | `PrivilegedCastProfile` | optional | Optional bounded profile for an activated class-granted cast. |
| `requires_prepared` | `boolean` | default `false` |  |
| `requires_selected` | `boolean` | default `false` |  |
| `selection_capacity` | `uint32` | default `0` | Number of distinct spells selected for this privilege. |
| `selection_group` | `string` | optional | Open selection group used to store eligible spell choices. |
| `slotless` | `boolean` | default `false` |  |
| `uses_per_selection` | `integer` | optional | Free casts available independently for each selected spell. |

<a id="effect--cast-transform"></a>

#### Effect::CastTransform

Offer parameterized cast changes. Option ids carry provenance only; filters, costs, compatibility, and transformation values drive play.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `known_capacity` | `[uint32, uint32][]` | default `[]` | Strictly increasing `(class level, maximum known options)` rows. |
| `options` | `CastTransformOption[]` | required |  |
| `simultaneous_limit` | `[uint32, uint32][]` | default `[]` | Strictly increasing `(class level, simultaneous option limit)` rows. |

<a id="effect--choice-delivery"></a>

#### Effect::ChoiceDelivery

Offer mutually exclusive, explicitly delivered effect compositions.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `choices` | `ChoiceDeliveryOption[]` | required |  |

<a id="effect--preparation-access"></a>

#### Effect::PreparationAccess

Admit the spells `filter` accepts to preparation without changing the bearer's ordinary prepared-spell capacity. The filter must name at least one class list.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `exchange_per_rest` | `integer` | optional | Maximum prepared spells replaced through this access after a rest. Both the replaced and the incoming spell must pass `filter`. Absent grants ordinary add-or-replace preparation access. |
| `filter` | `CastSpellFilter` | required |  |
| `requires_spellbook` | `boolean` | default `false` |  |

<a id="effect--resource-exchange"></a>

#### Effect::ResourceExchange

Atomically exchange one authored resource ledger for another through a finite conversion table. Resource identity, rates, caps, and use economy are all parameters; a feature id never selects the rule.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `routes` | `ResourceExchangeRoute[]` | required |  |

<a id="effect--restore-resource-minimum"></a>

#### Effect::RestoreResourceMinimum

Raise a named resource ledger to at least an authored amount, without exceeding that ledger's ordinary capacity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ledger` | `FeatureResourceLedger` | required |  |
| `minimum` | `uint32` | required |  |

<a id="effect--hide-eligibility"></a>

#### Effect::HideEligibility

Permit an authored Hide context while its action and equipment gates hold. This describes the context, not the granting feature's identity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `allowed_armor` | `ArmorCategory[]` | default `[]` | Authored body-armor categories that remain eligible. |
| `allows_unarmored` | `boolean` | default `false` | Permit no body armor as an eligible equipment state. |
| `requires_bonus_hide` | `boolean` | default `false` | Require the bearer to have the generic bonus-Hide capability. |

<a id="effect--movement-surface-permission"></a>

#### Effect::MovementSurfacePermission

Permit one movement mode to traverse the listed otherwise-forbidden surfaces while an optional unarmored gate holds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `mode` | `MovementMode` | required | Movement mode used to cross those surfaces. |
| `requires_unarmored` | `boolean` | default `false` | Whether wearing body armor suppresses the permission. |
| `surfaces` | `MovementSurface[]` | required | Nonempty, duplicate-free surface set. |

<a id="effect--scaled-fall-reduction"></a>

#### Effect::ScaledFallReduction

Spend the creature's Reaction when it falls to reduce the fall's damage by an authored amount per granting-class level.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `damage_per_class_level` | `uint32` | required |  |

<a id="effect--source-linked-condition-lifecycle"></a>

#### Effect::SourceLinkedConditionLifecycle

End a source-owned condition when one of the authored lifecycle events occurs. Source ownership is retained by the ordinary persistent effect.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ends_on_damage` | `boolean` | default `false` |  |
| `ends_on_source_death` | `boolean` | default `false` |  |
| `ends_on_source_incapacitated` | `boolean` | default `false` |  |

<a id="effect--timed-resistance"></a>

#### Effect::TimedResistance

Grant resistance for a bounded duration after atomically charging an authored resource pool. Exactly one included or excluded set is used.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cost` | `uint32` | required | Positive fixed pool price. |
| `damage_kinds` | `string[]` | default `[]` | Explicit kinds resisted; empty when `excluded_damage_kinds` is used. |
| `excluded_damage_kinds` | `string[]` | default `[]` | Resist every loaded kind except these ids; empty for an include set. |
| `pool` | `string` | required | Authored resource pool charged on acceptance. |
| `rounds` | `uint32` | required | Duration in combat rounds. |

<a id="effect--ability-scaled-damage-dice"></a>

#### Effect::AbilityScaledDamageDice

Deal one die per derived ability modifier, subject to an authored positive minimum, using the ordinary damage ladder.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required | Ability whose modifier determines the number of dice. |
| `die_faces` | `uint32` | required | Faces on every die. |
| `kind` | `string` | required | A `tables/damage_kinds.srd.ron` id. |
| `minimum_dice` | `uint32` | required | Minimum number of dice rolled after deriving the modifier. |

<a id="effect--attack-damage-property"></a>

#### Effect::AttackDamageProperty

Give attacks selected by authored source filters a damage property.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `magical` | `boolean` | required | Whether matching damage counts as magical. |
| `sources` | `DamageRollSource[]` | required | Nonempty attack-source alternatives. |

<a id="effect--damage-roll-policy"></a>

#### Effect::DamageRollPolicy

Amend an eligible damage roll at authored outcomes, with optional once-per-turn accounting.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | `DamageRollAmount` | required | Damage dice, ability modifier, or die override to apply. |
| `kind` | `string` | optional | Optional replacement damage kind; absent preserves the parent kind. |
| `once_per_turn` | `boolean` | default `false` | Whether the policy may resolve only once during the bearer's turn. |
| `outcomes` | `DamageRollOutcome[]` | required | Nonempty resolved outcomes on which the amount applies. |
| `sources` | `DamageRollSource[]` | required | Nonempty attack, spell, or mark source alternatives. |

<a id="effect--rider-exchange"></a>

#### Effect::RiderExchange

Atomically exchange parent damage dice or attack Advantage for one or more distinct, level-gated effect compositions.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `budget` | `RiderExchangeBudget` | required | Kind of budget paid by the accepted choices. |
| `capacity` | `[uint32, uint32][]` | required | Strictly increasing `(class level, maximum choices)` ladder. |
| `choices` | `RiderExchangeChoice[]` | required | Open-id choices with authored prices and consequences. |
| `leave_one_die` | `boolean` | default `false` | For damage-dice budgets, require at least one die to remain. |

<a id="effect--ability-score-increase"></a>

#### Effect::AbilityScoreIncrease

Derive an increase for the listed ability scores, bounded by `cap`. This is read from the reached grant and is never repeatedly stamped.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `abilities` | `Ability[]` | required | Nonempty set of abilities receiving the same increase. |
| `amount` | `int64` | required | Positive amount added before applying the cap. |
| `cap` | `int64` | required | Highest derived score. The result is `min(score + amount, cap)`, so an input already above the cap is clamped down to it. |

<a id="effect--aging-rate"></a>

#### Effect::AgingRate

Derive apparent age as elapsed years divided by this positive rate. Elapsed world time itself is unchanged.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `divisor` | `uint32` | required |  |

<a id="effect--attunement-capacity"></a>

#### Effect::AttunementCapacity

Override the bearer's derived magic-item attunement capacity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `capacity` | `uint32` | required |  |

<a id="effect--arm-d20-edge"></a>

#### Effect::ArmD20Edge

Arm one typed one-shot d20 edge on the bearer.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `edge` | `D20Edge` | required |  |

<a id="effect--swap-initiative"></a>

#### Effect::SwapInitiative

Offer a willing, conscious ally and exchange the two Initiative values.

<a id="effect--best-of-two-weapon-damage"></a>

#### Effect::BestOfTwoWeaponDamage

Roll only the weapon's base damage dice twice and keep the greater sum.

<a id="effect--restore-turn-resource"></a>

#### Effect::RestoreTurnResource

Restore one already-spent turn resource to the acting creature.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `economy` | `FeatureActionEconomy` | required |  |

<a id="effect--restore-hit-points"></a>

#### Effect::RestoreHitPoints

Restore hit points from authored dice plus a value derived from the invoking grant and its bearer.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bonus` | `FeatureValue` | required |  |
| `dice` | `string` | required |  |

<a id="effect--grant-temporary-hit-points"></a>

#### Effect::GrantTemporaryHitPoints

Grant temporary hit points from authored dice plus a value derived from the invoking grant and its bearer.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bonus` | `FeatureValue` | required |  |
| `dice` | `string` | required |  |

<a id="effect--timed-condition"></a>

#### Effect::TimedCondition

Apply an authored condition to the bearer for a number of rounds. Lifecycle clauses belong to the application, while the condition's combat reads remain composed in `data/conditions`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `ends_without_attack_or_damage` | `boolean` | default `false` |  |
| `rounds` | `uint32` | required |  |

<a id="effect--one-of-next-turn"></a>

#### Effect::OneOfNextTurn

On the target's next turn, it can only move, take an action, or take a Bonus Action. Its first choice closes the other two for that turn.

<a id="effect--timed-melee-defense"></a>

#### Effect::TimedMeleeDefense

Apply a timed condition whose melee attacks receive a level-scaled flat damage bonus and whose bearer resists authored damage kinds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `damage_bonus` | `FeatureLevelValue[]` | required |  |
| `ends_without_attack_or_damage` | `boolean` | default `false` |  |
| `resistances` | `string[]` | required |  |
| `rounds` | `uint32` | required |  |

<a id="effect--timed-spell-enhancement"></a>

#### Effect::TimedSpellEnhancement

Apply a timed enhancement to spell attack rolls and spell save DCs.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `attack_advantage` | `boolean` | default `false` |  |
| `condition` | `string` | required |  |
| `fallback_cost` | `uint32` | required |  |
| `fallback_pool` | `string` | required |  |
| `rounds` | `uint32` | required |  |
| `save_dc_bonus` | `int64` | required |  |

<a id="effect--timed-movement-mode"></a>

#### Effect::TimedMovementMode

Grant an authored movement mode at walking speed for a duration. A dismissible grant may be ended by invoking the same action again.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `dismissible` | `boolean` | default `false` |  |
| `fallback_cost` | `uint32` | required |  |
| `fallback_pool` | `string` | required |  |
| `mode` | `MovementMode` | required |  |
| `rounds` | `uint32` | required |  |

<a id="effect--fallback-pool-cost"></a>

#### Effect::FallbackPoolCost

Charge a fixed amount from an authored fallback resource when the action's primary use store is unavailable.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | `uint32` | required |  |
| `pool` | `string` | required |  |

<a id="effect--timed-damage-aura"></a>

#### Effect::TimedDamageAura

Establish a mobile damaging aura around the bearer for the authored duration. Damage and radius are ordinary parameters, not content ids.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `damage` | `FeatureValue` | required |  |
| `kind` | `string` | required |  |
| `radius_ft` | `uint32` | required |  |
| `rounds` | `uint32` | required |  |

<a id="effect--heal-spread"></a>

#### Effect::HealSpread

Divide a level-derived healing budget among nearby allies without raising any recipient beyond the authored fraction of maximum HP.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `maximum_percent` | `uint8` | required |  |
| `points_per_level` | `uint32` | required |  |
| `radius_ft` | `uint32` | required |  |

<a id="effect--mark-target"></a>

#### Effect::MarkTarget

Install or transfer a source-owned mark onto one target in range.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `damage_die` | `string` | required |  |
| `damage_kind` | `string` | default `"force"` | Extra damage kind. Omitted marks deal Force damage. |
| `duration_by_slot` | `FeatureLevelValue[]` | default `[]` | Duration in seconds at each minimum spell-slot level. An empty ladder uses the spell's ordinary duration. |
| `range_ft` | `uint32` | required |  |

<a id="effect--restore-pool"></a>

#### Effect::RestorePool

Restore an authored resource pool to its capacity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `heal_with_capacity_die` | `boolean` | default `false` |  |
| `pool` | `string` | required |  |

<a id="effect--bonus-strikes"></a>

#### Effect::BonusStrikes

Offer an authored number of bonus strikes against one legal target.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | `uint8` | required |  |

<a id="effect--bonus-economy"></a>

#### Effect::BonusEconomy

Make selected ordinary actions available through the bonus-action economy for the current turn.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dash` | `boolean` | default `false` |  |
| `disengage` | `boolean` | default `false` |  |
| `dodge` | `boolean` | default `false` |  |
| `hide` | `boolean` | default `false` |  |
| `utilize` | `boolean` | default `false` |  |

<a id="effect--hit-rider"></a>

#### Effect::HitRider

Arm the bearer's next eligible hit with typed damage and/or a saving throw that applies an authored condition.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | optional |  |
| `damage` | `SlotScaledDamage` | optional |  |
| `save` | `Ability` | optional |  |

<a id="effect--attack-advantage"></a>

#### Effect::AttackAdvantage

Grant Advantage on the next eligible attack and optionally consume the bearer's remaining movement for this turn.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consume_movement` | `boolean` | default `false` |  |

<a id="effect--spend-healing-pool"></a>

#### Effect::SpendHealingPool

Spend points from an authored pool on HP restoration and selected condition removals in one touch of any creature. Cleansing points are paid separately from the points that restore HP.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cleanse_cost` | `uint32` | required |  |
| `points_per_level` | `uint32` | required |  |
| `pool` | `string` | required |  |

<a id="effect--grant-die"></a>

#### Effect::GrantDie

Grant a die selected from an authored level table to one ally in range.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `by_level` | `FeatureLevelValue[]` | required |  |
| `range_ft` | `uint32` | required |  |

<a id="effect--weapon-attack-ability-bonus"></a>

#### Effect::WeaponAttackAbilityBonus

Add one ability modifier to weapon attack rolls for the authored duration.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `rounds` | `uint32` | required |  |

<a id="effect--creature-type-save-or-heal"></a>

#### Effect::CreatureTypeSaveOrHeal

Offer a save against creatures of an authored type in an area or a level-scaled heal to one target. The choice is made by the action. Each creature that fails the save gains every one of `conditions` for `rounds`, against the action's save DC.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `conditions` | `string[]` | required |  |
| `creature_type` | `string` | required |  |
| `heal_bonus` | `FeatureValue` | required |  |
| `heal_die` | `string` | required |  |
| `radius_ft` | `uint32` | required |  |
| `rounds` | `uint32` | required |  |
| `save` | `Ability` | required |  |

<a id="effect--save-bonus-aura"></a>

#### Effect::SaveBonusAura

Add one ability modifier to allied saving throws made within an aura.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `radius_ft` | `uint32` | required |  |

<a id="effect--condition-immunity-aura"></a>

#### Effect::ConditionImmunityAura

Prevent allies within an aura from gaining one authored condition.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `radius_ft` | `uint32` | required |  |

<a id="effect--roll-bonus"></a>

#### Effect::RollBonus

Add authored dice to the roll currently crossing a trigger boundary.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |

<a id="effect--replace-roll"></a>

#### Effect::ReplaceRoll

Replace the d20 currently crossing a trigger boundary with an authored face value.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `value` | `uint8` | required |  |

<a id="effect--reroll-failed-save"></a>

#### Effect::RerollFailedSave

Reroll the failed save currently crossing a trigger boundary and add a value derived from the invoking grant and bearer.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bonus` | `FeatureValue` | required |  |

<a id="effect--conditional-save-reroll"></a>

#### Effect::ConditionalSaveReroll

Offer a willing target in range a reroll of a failed save against one of the authored conditions.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `conditions` | `string[]` | required | Nonempty condition ids which make this reroll eligible. |
| `radius_ft` | `uint32` | required | Maximum distance from the feature bearer to the saving creature. |
| `willing` | `boolean` | required | Whether the saving creature must accept the reroll. |
| `with_advantage` | `boolean` | required | Whether the replacement save rolls twice and keeps the higher d20. |

<a id="effect--return-reduced-attack"></a>

#### Effect::ReturnReducedAttack

After an incoming attack's damage is reduced to zero, permit an ordinary return attack against an eligible target in range.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cost` | `uint32` | required | Positive amount charged from `pool` for the return attack. |
| `damage_kinds` | `string[]` | required | Nonempty damage-kind ids eligible for the reduction and return. |
| `pool` | `string` | required | Authored resource pool charged only when the return is accepted. |
| `range_ft` | `uint32` | required | Maximum range of the ordinary return attack. |

<a id="effect--suppress-incoming-advantage"></a>

#### Effect::SuppressIncomingAdvantage

Suppress Advantage on incoming attacks while the authored awareness gate holds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `requires_conscious` | `boolean` | required | When true, an unconscious or otherwise incapacitated bearer cannot suppress the incoming Advantage. |

<a id="effect--extra-initiative-turn"></a>

#### Effect::ExtraInitiativeTurn

Insert another initiative turn in the first round at the authored penalty from the bearer's initiative.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `initiative_penalty` | `int64` | required |  |

<a id="effect--half-cover-aura"></a>

#### Effect::HalfCoverAura

Grant half cover to the bearer and nearby allies until the bearer's next turn begins.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `radius_ft` | `uint32` | required |  |

<a id="effect--move-by-speed-fraction"></a>

#### Effect::MoveBySpeedFraction

Move the bearer by a fraction of its current speed as part of the boundary transition.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `denominator` | `uint8` | required |  |

<a id="effect--movement-capability"></a>

#### Effect::MovementCapability

Use Dexterity for jump distance and/or grant a Climb Speed equal to walking speed while the row is active.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `climb_speed` | `boolean` | default `false` |  |
| `jump_uses_dexterity` | `boolean` | default `false` |  |

<a id="effect--school-damage-bonus"></a>

#### Effect::SchoolDamageBonus

Add one ability modifier to a damage roll for a spell of the authored school.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `school` | `string` | required |  |

<a id="effect--maximize-school-damage"></a>

#### Effect::MaximizeSchoolDamage

Maximize damage for a spell in the authored school through the stated level; repeated use may apply the ordinary escalating backlash.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `backlash` | `boolean` | default `false` |  |
| `maximum_spell_level` | `uint8` | required |  |
| `school` | `string` | required |  |

<a id="effect--cleanse-from-pool"></a>

#### Effect::CleanseFromPool

Spend authored pool points for each condition removed by a healing boundary.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `points_per_effect` | `uint32` | required |  |
| `pool` | `string` | required |  |

<a id="effect--area-save-condition"></a>

#### Effect::AreaSaveCondition

Make foes in range save or gain an authored condition for a number of rounds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `range_ft` | `uint32` | required |  |
| `rounds` | `uint32` | required |  |
| `save` | `Ability` | required |  |

<a id="effect--healing-bonus"></a>

#### Effect::HealingBonus

Add a flat amount plus an amount per spell level to healing crossing the current boundary.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `flat` | `int64` | required |  |
| `per_spell_level` | `int64` | required |  |

<a id="effect--persistent-spell"></a>

#### Effect::PersistentSpell

Select the persistent spell behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `payload` | `PersistentSpellPayload` | required |  |

<a id="effect--maximum-hit-points-change"></a>

#### Effect::MaximumHitPointsChange

Select the maximum hit points change behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | `int32` | required |  |

<a id="effect--maximum-hit-points-reduction-from-damage"></a>

#### Effect::MaximumHitPointsReductionFromDamage

Reduce the target's maximum HP by the damage the immediately preceding damage step actually dealt, after saves and damage modifiers, without reducing the maximum below 1. Other maximum-HP adjustments can reach 0.

<a id="effect--adjacent-target-damage"></a>

#### Effect::AdjacentTargetDamage

After a weapon-delivered spell hits its primary target, deal typed damage to one explicitly chosen different creature within this many feet of the primary. The casting ability modifier is optional and the dice follow the owning spell's ordinary cantrip ladder.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cantrip_step_offset` | `int8` | default `0` |  |
| `casting_modifier` | `boolean` | default `false` |  |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `max_distance_ft` | `uint32` | required |  |
| `requires_sight` | `boolean` | default `false` |  |

<a id="effect--voluntary-movement-damage"></a>

#### Effect::VoluntaryMovementDamage

Arm the delivered target until the source's next turn starts. The first voluntary move of at least `minimum_ft` consumes the handle and deals the scaled typed damage; forced movement never enters this door.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cantrip_step_offset` | `int8` | default `0` |  |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `minimum_ft` | `uint32` | default `5` |  |

<a id="effect--cantrip-step-damage"></a>

#### Effect::CantripStepDamage

Typed damage whose die count follows the cantrip tier multiplier plus an authored signed offset. An offset of -1 expresses riders that begin at level 5 without content-specific branching.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `step_offset` | `int8` | default `0` |  |

<a id="effect--death-prevention"></a>

#### Effect::DeathPrevention

Select the death prevention behavior.

<a id="effect--mode-choice"></a>

#### Effect::ModeChoice

Require one explicit closed authored option before applying this effect.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `choice` | `AuthoredChoicePayload` | required |  |

<a id="effect--ability-check-disadvantage"></a>

#### Effect::AbilityCheckDisadvantage

Give the target Disadvantage on checks using one ability for the effect's duration. An omitted ability offers the caster all six core abilities when the effect is applied. Saving throws are unaffected.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | optional |  |

<a id="effect--forced-action-control"></a>

#### Effect::ForcedActionControl

Compel one typed action; content identity never participates in dispatch.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | `AuthoredForcedAction` | required |  |

<a id="effect--forced-action-choice"></a>

#### Effect::ForcedActionChoice

Require the caster to choose one of several typed commands, then arm that exact forced action on the delivered target's next turn.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `option_set` | `string` | required |  |
| `options` | `AuthoredForcedAction[]` | required |  |

<a id="effect--contingent"></a>

#### Effect::Contingent

Arm a separately typed delayed predicate and consequence.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consequence` | `ContingentConsequence` | required |  |
| `predicate` | `ContingentPredicate` | required |  |
| `timing` | `ContingentTiming` | required |  |

<a id="effect--transform"></a>

#### Effect::Transform

Replace a target's authored combat form while preserving soul identity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `form` | `FormPayload` | required |  |

<a id="effect--change-size"></a>

#### Effect::ChangeSize

Change only the target's occupied size category; all other statistics remain.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `size` | `Size` | required |  |

<a id="effect--speed-grant"></a>

#### Effect::SpeedGrant

Temporarily add an authored number of feet to one closed movement mode.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount_ft` | `uint32` | required |  |
| `mode` | `MovementMode` | required |  |
| `source_owned` | `boolean` | default `false` |  |

<a id="effect--unarmed-strike-damage-grant"></a>

#### Effect::UnarmedStrikeDamageGrant

Add one separately typed damage roll to every Unarmed Strike hit for the effect's duration. The rider is its own damage instance (so its resistance and critical-hit dice are resolved independently).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |

<a id="effect--attack-hit-damage-grant"></a>

#### Effect::AttackHitDamageGrant

Add one separately typed damage roll whenever the bearer hits with an attack, provided the hit target is no farther away than the authored range. This applies uniformly to weapon, Unarmed Strike, natural, and spell attacks; the rider is a distinct damage instance and its dice double on a critical hit.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consequences` | `AttackHitDamageConsequence[]` | default `[]` |  |
| `dice` | `string` | required |  |
| `kinds` | `string[]` | required |  |
| `max_target_distance_ft` | `uint32` | required |  |

<a id="effect--turn-start-proximity-choice"></a>

#### Effect::TurnStartProximityChoice

While this source-owned effect lasts, the source is offered a no-cost accept/decline choice whenever a creature it can see starts its turn in the authored radius. Choices are queued independently in source order.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `consequence` | `OptionalEffectConsequence` | required |  |
| `radius_ft` | `uint32` | required |  |
| `requires_sight` | `boolean` | default `false` |  |

<a id="effect--strength-score-floor"></a>

#### Effect::StrengthScoreFloor

Raise the target's Strength score to at least this value for the effect's duration. The stored score is never lowered or mutated.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `score` | `uint8` | required |  |

<a id="effect--condition-immunity-grant"></a>

#### Effect::ConditionImmunityGrant

Grant immunity to one authored condition for this effect's duration. The grant is source-owned, so concentration loss removes only the granting source's immunity.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |

<a id="effect--breathing-grant"></a>

#### Effect::BreathingGrant

Temporarily grant one or both breathing media. This changes only the suffocation predicate; it grants no Swim Speed or movement permission.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `air` | `boolean` | default `false` |  |
| `water` | `boolean` | default `false` |  |

<a id="effect--turn-start-temp-hp"></a>

#### Effect::TurnStartTempHp

At the start of each target turn, grant temporary HP equal to the casting ability modifier (minimum zero). Multiple grants obey the ordinary non-stacking temporary-HP rule.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |

<a id="effect--turn-start-damage"></a>

#### Effect::TurnStartDamage

Deal typed damage at the start of each affected creature's turn for this effect's duration. An authored action-removal flag exposes the shared self-or-adjacent cleanse action rather than a spell-specific verb.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `plus` | `int64` | default `0` |  |
| `removable_by_action` | `boolean` | default `false` |  |

<a id="effect--vision-grant"></a>

#### Effect::VisionGrant

Temporarily grant Truesight to at least this range. Existing longer special senses remain authoritative; expiration reveals them again.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `truesight_ft` | `uint32` | required |  |

<a id="effect--reaction-defense"></a>

#### Effect::ReactionDefense

Install or resolve a typed pre-resolution defense/cancellation payload.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `payload` | `ReactionDefensePayload` | required |  |

<a id="effect--fall-protection"></a>

#### Effect::FallProtection

Modify the next pending fall impact on the target. This is an event primitive rather than a spell-id branch: reaction content supplies the exact reduction and optional controlled-descent rate.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `damage_divisor` | `uint32` | required | Divide rolled falling damage by this value (minimum 1). |
| `damage_reduction` | `uint32` | required | Flat reduction after division. |
| `descent_ft_per_round` | `integer` | optional | A controlled descent rate; while present, this pending impact deals no falling damage (the rate remains semantic state for consumers). |
| `max_damage` | `integer` | optional | Optional final damage ceiling. |

<a id="effect--damage"></a>

#### Effect::Damage

`dice` (+ `plus`) damage of `kind` — halved by a resistance, spared per the delivery's save. A crit doubles the dice (attack deliveries).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required | A `tables/damage_kinds.srd.ron` id, boot-resolved. |
| `plus` | `int64` | default `0` |  |

<a id="effect--conditional-damage"></a>

#### Effect::ConditionalDamage

Use `alternate_dice` when the delivered target is below maximum HP.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `alternate_dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `primary_dice` | `string` | required |  |

<a id="effect--damage-type-choice"></a>

#### Effect::DamageTypeChoice

Damage whose kind is chosen at cast time from this closed authored set. The live and forked policies choose the first kind with the greatest post-mitigation result; content names never enter combat dispatch.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kinds` | `string[]` | required |  |
| `plus` | `int64` | default `0` |  |

<a id="effect--heal"></a>

#### Effect::Heal

Restore `dice` (+ the casting mod if `add_mod`) hit points.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `add_mod` | `boolean` | required |  |
| `dice` | `string` | required |  |

<a id="effect--flat-heal"></a>

#### Effect::FlatHeal

Restore an exact authored number of hit points (no die or modifier).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount` | `int64` | required |  |

<a id="effect--healing-lock-until-source-next-turn-end"></a>

#### Effect::HealingLockUntilSourceNextTurnEnd

The delivered target cannot regain Hit Points until the end of the source's next turn. An attack delivery applies this only on a hit. Temporary Hit Points remain available because they are not healing.

<a id="effect--heal-from-damage"></a>

#### Effect::HealFromDamage

Restore HP to the effect's source from the immediately preceding damage step's actual post-mitigation applied amount.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `divisor` | `uint32` | required |  |

<a id="effect--self-damage-heal-target"></a>

#### Effect::SelfDamageHealTarget

Deal irreducible typed damage to the effect's source, then restore the delivered target by an authored multiple of that applied damage.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `heal_multiplier` | `uint32` | required |  |
| `kind` | `string` | required |  |

<a id="effect--cleanse-condition"></a>

#### Effect::CleanseCondition

Remove one currently borne condition from a closed authored set. When several qualify, authored order is the deterministic choice order.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `conditions` | `string[]` | required |  |

<a id="effect--remove-exhaustion"></a>

#### Effect::RemoveExhaustion

Remove up to this many levels from the target's world-authoritative Exhaustion track. A value of six expresses complete 2024 recovery without coupling the primitive to one item.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `levels` | `uint8` | required |  |

<a id="effect--maximize-hit-die-healing"></a>

#### Effect::MaximizeHitDieHealing

For the enclosing duration, every Hit Die the target spends restores the die's maximum result rather than its ordinary roll/average.

<a id="effect--skill-advantage"></a>

#### Effect::SkillAdvantage

Advantage on a closed set of skills only when the check explicitly influences a creature within the authored range.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `influence_within_ft` | `uint32` | required |  |
| `skills` | `Skill[]` | required |  |

<a id="effect--stabilize"></a>

#### Effect::Stabilize

End a dying ally's death saves (spare the dying).

<a id="effect--kindle"></a>

#### Effect::Kindle

Kindle the target with an independently timed illumination handle, cast instead of struck, throwing `bright_ft` of bright light and `dim_ft` MORE of dim — the SRD's own phrasing ("bright light in a 20-foot radius and dim light for an additional 20 feet"). Light is the torch's 20/20; daylight throws 60/60.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bright_ft` | `uint32` | required |  |
| `dim_ft` | `uint32` | required |  |

<a id="effect--guide"></a>

#### Effect::Guide

The glimmer (guiding bolt): the next attack roll against the target has advantage.

<a id="effect--modify"></a>

#### Effect::Modify

Bless/bane: `die` rides the bearer's own attack rolls and saving throws for the duration — added, or subtracted when `penalty`. A CONCENTRATION effect (the validator pins it), so it lifts when the caster's focus breaks.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `die` | `string` | required |  |
| `penalty` | `boolean` | default `false` |  |

<a id="effect--afflict"></a>

#### Effect::Afflict

Inflict a condition on the target: the id resolves against `data/conditions/` at load — a condition is a DATA bundle of engine [`ConditionComponent`] reads, so hold person's paralysis and a mod's own affliction are the same one-file shape. Behind a `Save` delivery the bearer repeats that save at each of its turns to shake it (SRD save-ends); a CONCENTRATION effect.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `beneficial` | `boolean` | default `false` | Some conditions are grants rather than hostile afflictions (for example an item granting Invisible). This controls side legality; condition identity remains data and is never special-cased here. |
| `condition` | `string` | required |  |
| `ends_on_attack_damage_or_cast` | `boolean` | default `false` | The granted condition ends immediately after its bearer makes an attack or casts a spell. The triggering attack still receives the condition's benefits; item activation itself is not a spell cast. |
| `ends_on_source_side_damage` | `boolean` | default `false` | The condition ends after the spell's source or one of that source's allies deals damage to the bearer. |
| `forced_turn` | `ForcedTurnRule` | optional | Source-relative turn behavior retained with this exact condition relation for as long as it remains active. |
| `initial_save_advantage_if_fighting` | `boolean` | default `false` | A hostile target makes the initial delivery save with Advantage when the source's side is already fighting it. |
| `on_failed_save` | `AfflictionEntryEffect[]` | default `[]` | Consequences applied once, only after the initial affliction lands. |
| `repeat_save` | `RepeatSaveRule` | optional | Whether the target repeats the delivery save at the end of each of its turns. Most combat afflictions do; Charm Person does not. |

<a id="effect--next-weapon-attack-disadvantage"></a>

#### Effect::NextWeaponAttackDisadvantage

The target's next weapon attack is made with Disadvantage; if unused, this expires at the end of that target's next turn.

<a id="effect--next-saving-throw-penalty"></a>

#### Effect::NextSavingThrowPenalty

Subtract `die` from the target's next saving throw before the end of the source's next turn. The rider is consumed by the first save attempt, whether that save succeeds or fails.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `die` | `string` | required |  |

<a id="effect--push"></a>

#### Effect::Push

Forced movement: shove the target `distance_ft` directly AWAY from the effect's origin (the caster, for the self-centered burst/cone/ line spells that carry it), stopping at the first wall, impassable creature's space, or board edge. It can end in an occupied space it may pass through. A harmful, instantaneous rider behind a Save — forgone on a success. Thunderwave's ten-foot push is the first. LEDGERED: pushing away from a SPHERE's center rather than the caster (no shipped sphere-push spell needs it) and prone-on-collision.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `distance_ft` | `uint32` | required |  |
| `max_target_size` | `Size` | optional | Largest creature size this effect can move. Absent means no limit; an ineligible target still receives the spell's other effects. |

<a id="effect--pull"></a>

#### Effect::Pull

A pull: forced movement TOWARD the caster — thorn whip's vine yank, the mirror of Push. Drags the struck target `distance_ft` toward the caster (halting adjacent, never onto it). HARMFUL (it rides a to-hit or a save, like Push). LEDGERED: a pull toward a POINT other than the caster.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `distance_ft` | `uint32` | required | Maximum distance the target is moved. |
| `max_target_size` | `Size` | optional | Largest creature size this effect can move. Absent means no limit; an ineligible target still receives the spell's other effects. |

<a id="effect--beam"></a>

#### Effect::Beam

A sustained beam: a CONCENTRATION drain that deals `dice` `kind` to the delivered target AUTOMATICALLY at the start of each of the caster's turns — vampiric touch's per-turn drain (the one-time hit is a separate `Damage` step; this is the sustain). HARMFUL (rides a to-hit or a save), an ongoing effect (concentration). LEDGERED: the SRD range-break (the beam ends if the target leaves range/cover — ours holds while concentration does), the life-drain self-HEAL (no heal-from-damage primitive yet), and the upcast.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |

<a id="effect--teleport"></a>

#### Effect::Teleport

Teleport: the delivered target vanishes and reappears up to `max_ft` away — misty step's blink. A BENEFICIAL self-move behind a Target delivery. The destination is AI-chosen (the unoccupied on-board square FARTHEST from the nearest enemy — the escape the world uses), following the world-first precedent; a PLAYER-picked destination, the "space you can see" line of sight, and bringing a willing creature (dimension door) are LEDGERED.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `max_ft` | `uint32` | required |  |

<a id="effect--aura"></a>

#### Effect::Aura

An aura: a CONCENTRATION area centered on the caster that bites foes who START their turn within `radius_ft` — an `ability` save for half of `dice` `kind` damage (spirit guardians). Established on the delivered target (the caster — a Target self-cast); BENEFICIAL for the delivery's side-legality (you cast it on yourself), the harm emergent per-turn. It moves WITH the caster and lifts when its concentration breaks. LEDGERED: the SRD "enters the area for the first time on a turn" movement trigger (start-turn-in only today), the speed-halving, and the upcast (+dice/slot).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `radius_ft` | `uint32` | required |  |

<a id="effect--obscuration-aura"></a>

#### Effect::ObscurationAura

A mobile heavily-obscured area centered on the delivered creature.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `radius_ft` | `uint32` | required |  |
| `source_sees_through` | `boolean` | default `false` |  |

<a id="effect--summon"></a>

#### Effect::Summon

A transient summon that mints `creature_id` from the bestiary onto its source's side mid-fight. It may be concentration-bound or independently timed, fights through the ordinary combatant machinery, takes no plunder, and is swept from the world when the fight ends.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `acts_after_source` | `boolean` | default `false` | Insert the summon immediately after its source in Initiative. |
| `augmentation` | `SummonAugmentation` | default `{"choice_binding":null,"dismiss":null,"linked_grants":[]}` | Optional selected-kind binding and source-linked grants. An activated cast privilege may overlay the same reusable shape. |
| `creature_id` | `string` | required |  |
| `dismiss` | `CastTime` | optional | Optional economy with which the source may dismiss this summon. |
| `requires_command` | `boolean` | default `false` | The summon must receive its source's free verbal command each round or it takes only the defensive default. |
| `scaling` | `SummonScaling` | optional | Optional slot/caster-derived stat-block formula for summoned spirits. Absent preserves an ordinary fixed bestiary body. |

<a id="effect--zone"></a>

#### Effect::Zone

A zone: a CONCENTRATION area anchored to a FIXED point on the board (the aura's board-bound sibling — an aura moves WITH its caster, a zone stands where it was cast) that bites whoever starts their turn within `radius_ft` — an `ability` save for half of `dice` `kind` damage (moonbeam). Established via a Target self-cast; BENEFICIAL for the delivery's side-legality (the harm is emergent per-turn, like the aura), the placement AI-chosen (the foe cluster within range, never an ally — the world-first precedent). LEDGERED: the SRD "enters the area" movement trigger (start-turn-in only today), a MOVABLE zone (moonbeam's beam-step), the cylinder/cube shapes (a Chebyshev radius today), the PLAYER-picked anchor, and the upcast. The movement-blocking WALL (Wall of Force/Stone — blocked squares + line-of-sight) is a distinct primitive, ledgered as the sibling.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `dice` | `string` | required |  |
| `dispersed_by_strong_wind` | `boolean` | default `false` |  |
| `kind` | `string` | required |  |
| `radius_ft` | `uint32` | required |  |

<a id="effect--triggered-zone"></a>

#### Effect::TriggeredZone

A board area whose consequence fires at turn start, on first entry, and/or at turn end. Unlike the older damage-only `Zone`, this carries the complete authored trigger, use ledger, mobility, exclusions, and removable riders needed by creature-selective healing and hazardous fields.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `exclusions` | `string[]` | default `[]` |  |
| `mobile_reposition_ft` | `integer` | optional |  |
| `optional_by_source` | `boolean` | default `false` |  |
| `outcome` | `TriggeredZoneOutcome` | required |  |
| `radius_ft` | `uint32` | required |  |
| `shape` | `TriggeredZoneShape` | default `"Sphere"` |  |
| `trigger_end` | `boolean` | default `false` |  |
| `trigger_entry` | `boolean` | default `true` |  |
| `trigger_start` | `boolean` | default `true` |  |
| `uses` | `TriggeredZoneUses` | optional |  |

<a id="effect--directional-field"></a>

#### Effect::DirectionalField

A sustained rectangular field anchored to its source's current square and an authored orientation. The caller establishes it once; creatures in its footprint are consequences of the field, not separate copies.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `length_ft` | `uint32` | required |  |
| `movement_toward_source_multiplier` | `uint8` | default `1` |  |
| `push_ft` | `uint32` | required |  |
| `reaim` | `CastTime` | optional |  |
| `strong_wind` | `boolean` | default `false` |  |
| `trigger_end` | `boolean` | default `false` |  |
| `trigger_initial` | `boolean` | default `true` |  |
| `width_ft` | `uint32` | required |  |

<a id="effect--wall"></a>

#### Effect::Wall

A wall: a CONCENTRATION barrier of `length_ft` that stands a line of BLOCKED squares on the board — Wall of Stone / Wall of Force. It deals no direct damage; it BLOCKS. Every mover, the king-step pathing, the cover / line-of-sight trace, teleport, and forced movement already read `board.open`, so the wall gates all of them for free (the board footprint + cover seam). Established via a Target self-cast; BENEFICIAL for the delivery's side-legality (it harms no creature directly), the placement AI-chosen (a line cutting the caster off from the foe cluster, never through a creature — the world-first precedent). LEDGERED: the PLAYER-drawn shape/anchor, the panel/ring/sphere forms (a straight line today), a DAMAGING wall (Wall of Fire — a Wall+Zone compose), and the "creatures in the wall's space are shoved clear" rule (gaps at occupants).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `length_ft` | `uint32` | required |  |

<a id="effect--wall-damage"></a>

#### Effect::WallDamage

A damaging wall: Wall of Fire — a CONCENTRATION barrier of `length_ft` that BLOCKS (like `Wall`) AND sears any of the caster's enemies who start their turn on or adjacent to it (an `ability` save for half of `dice` `kind`). Established via a Target self-cast; BENEFICIAL for side-legality (emergent per-turn, like the Zone). LEDGERED: the SRD wall of fire is PASSABLE (ours blocks — a fiery barrier, the fun-first read), its ONE damaging side (ours sears both), the opaque line-of-sight, the player-drawn shape/anchor, and the upcast.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |
| `length_ft` | `uint32` | required |  |

<a id="effect--zone-afflict"></a>

#### Effect::ZoneAfflict

A condition zone: the Zone's SNARING sibling — a CONCENTRATION area fixed to a board point that AFFLICTS rather than damages. A creature starting its turn within `radius_ft` makes an `ability` save; on a FAILURE it gains `condition` (a `conditions/` id) for that turn — web's restrained, sleet storm's prone, stinking cloud's incapacitated. Established via a Target self-cast; BENEFICIAL for side-legality (emergent per-turn, like the Zone), the placement AI-chosen. The condition RE-EVALUATES each turn the creature lingers (a made save frees it). LEDGERED: the escape/break-free check, the difficult-terrain rider, the enters-the-area trigger (start-turn-in only), and the upcast.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `condition` | `string` | required |  |
| `dispersed_by_strong_wind` | `boolean` | default `false` |  |
| `radius_ft` | `uint32` | required |  |
| `trigger_initial` | `boolean` | default `false` | Also require the zone's save from affected creatures when cast. |

<a id="effect--temp-hp"></a>

#### Effect::TempHp

A temporary hit-point grant: the target gains `dice` + `plus` temporary hit points. The receiver chooses whether to keep its current pool or take the new one. Unspent points last until a Long Rest unless the granting text links them to the effect's duration or concentration.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `expires_with_effect` | `boolean` | default `false` | Whether this grant expires with the effect's authored duration. |
| `plus` | `int64` | required |  |

<a id="effect--resist"></a>

#### Effect::Resist

A resistance grant: the delivered target gains resistance to `kind` damage — protection from energy's ward, halving that one kind — for the authored duration. A concentration grant is source-owned and lifts when focus breaks; non-concentration item magic expires on its own clock. LEDGERED: the player's choice among the five energy kinds (ship one — fire) and the SRD 1-hour cap outside a combat bubble.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | `string` | required |  |

<a id="effect--save-advantage"></a>

#### Effect::SaveAdvantage

Source-owned advantage on the listed saving throw abilities for the spell's duration.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `abilities` | `Ability[]` | required |  |

<a id="feature-action-economy"></a>

### FeatureActionEconomy

The turn resource paid when a feature action is used.

<a id="feature-action-economy--action"></a>

#### FeatureActionEconomy::Action

Spend the actor's Action.

<a id="feature-action-economy--bonus"></a>

#### FeatureActionEconomy::Bonus

Spend the actor's Bonus Action.

<a id="feature-action-economy--reaction"></a>

#### FeatureActionEconomy::Reaction

Spend the actor's Reaction.

<a id="feature-action-economy--free"></a>

#### FeatureActionEconomy::Free

Spend no turn resource.

<a id="feature-action-ledger"></a>

### FeatureActionLedger

The already-existing store from which a feature action draws uses.

<a id="feature-action-ledger--per-rest"></a>

#### FeatureActionLedger::PerRest

The grant's existing `uses` count, written to `FEATURES_SPENT` and restored by the feature's ordinary rest cadence.

<a id="feature-action-ledger--per-turn"></a>

#### FeatureActionLedger::PerTurn

One activation in the current turn, represented by a combat `FeatureClock` rather than a second world counter.

<a id="feature-action-ledger--pool"></a>

#### FeatureActionLedger::Pool

Spend points from the authored pool id.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | required | The data-authored pool id shared by every action that spends it. |

<a id="feature-action-ledger--uses"></a>

#### FeatureActionLedger::Uses

Spend one use from the authored use-counter id.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | required | The data-authored counter id shared by every action that spends it. |

<a id="feature-action-ledger--per-rest-or-spell-slot"></a>

#### FeatureActionLedger::PerRestOrSpellSlot

A feature use with the existing spell-slot fallback printed by the SRD.

<a id="feature-action-ledger--per-rest-or-pool"></a>

#### FeatureActionLedger::PerRestOrPool

A feature use with a fallback spend from an authored pool id.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | required | The data-authored pool used after the feature's own uses are spent. |

<a id="feature-action-ledger--recharge"></a>

#### FeatureActionLedger::Recharge

One in-combat use which returns when a d6 roll is at least `die_low`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `die_low` | `uint8` | required | Inclusive low face of the recharge range, from 1 through 6. |

<a id="feature-level-value"></a>

### FeatureLevelValue

One strictly increasing class-level step in an authored feature value.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `level` | `uint32` | required | First class level at which `value` applies. |
| `value` | `int64` | required | Value from this level until the next step. |

<a id="feature-resource-ledger"></a>

### FeatureResourceLedger

A resource ledger address used by generic exchanges and minimum restores.

<a id="feature-resource-ledger--pool"></a>

#### FeatureResourceLedger::Pool

A data-authored point pool.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | required |  |

<a id="feature-resource-ledger--uses"></a>

#### FeatureResourceLedger::Uses

A data-authored use counter.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | required |  |

<a id="feature-resource-ledger--spell-slots"></a>

#### FeatureResourceLedger::SpellSlots

The ordinary level-indexed spell-slot ledger.

<a id="feature-value"></a>

### FeatureValue

A numeric input a feature effect derives from the granting creature.

<a id="feature-value--flat"></a>

#### FeatureValue::Flat

The authored constant.

Carries `int64`.

<a id="feature-value--class-level"></a>

#### FeatureValue::ClassLevel

The level of the class whose reached grant supplied the action.

<a id="feature-value--ability-modifier"></a>

#### FeatureValue::AbilityModifier

The actor's modifier for the named ability.

Carries `Ability`.

<a id="feature-value--proficiency-bonus"></a>

#### FeatureValue::ProficiencyBonus

The actor's proficiency bonus.

<a id="feature-value--ability-modifier-plus-proficiency"></a>

#### FeatureValue::AbilityModifierPlusProficiency

The actor's modifier for the named ability plus its proficiency bonus.

Carries `Ability`.

<a id="forced-turn-rule"></a>

### ForcedTurnRule

Authorable `ForcedTurnRule` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | `AuthoredForcedAction` | required | Authored action. |
| `if_able` | `boolean` | default `true` | Authored if able. |

<a id="form-capability-policy"></a>

### FormCapabilityPolicy

Which ordinary capabilities the replacement body carries.

<a id="form-capability-policy--retain-mental-and-class-use-form-physical"></a>

#### FormCapabilityPolicy::RetainMentalAndClassUseFormPhysical

Retain mental and class capabilities while using form physical traits.

<a id="form-capability-policy--form-only"></a>

#### FormCapabilityPolicy::FormOnly

Use only the replacement form's capabilities.

<a id="form-ends"></a>

### FormEnds

Explicit form-ending predicates interpreted by the shared lifecycle.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dead` | `boolean` | default `false` | Death ends the form. |
| `elapsed` | `boolean` | default `false` | The authored duration ending restores the original body. |
| `incapacitated` | `boolean` | default `false` | Incapacitation ends the form. |
| `voluntary` | `boolean` | default `false` | The bearer may end the form voluntarily. |

<a id="form-equipment-disposition"></a>

### FormEquipmentDisposition

One authored disposition available for worn or carried equipment.

<a id="form-equipment-disposition--wear-if-fits"></a>

#### FormEquipmentDisposition::WearIfFits

Retain equipment the new body can wear.

<a id="form-equipment-disposition--drop"></a>

#### FormEquipmentDisposition::Drop

Drop equipment in the bearer's current space.

<a id="form-equipment-disposition--merge"></a>

#### FormEquipmentDisposition::Merge

Merge equipment into the form and suppress its use until reversion.

<a id="form-equipment-policy"></a>

### FormEquipmentPolicy

Equipment handling for a replacement form.

<a id="form-equipment-policy--choose"></a>

#### FormEquipmentPolicy::Choose

Offer exactly the listed distinct dispositions.

Carries `FormEquipmentDisposition[]`.

<a id="form-equipment-policy--fixed"></a>

#### FormEquipmentPolicy::Fixed

Apply one disposition without a pending choice.

Carries `FormEquipmentDisposition`.

<a id="form-payload"></a>

### FormPayload

Authorable `FormPayload` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `creature_id` | `string` | optional | Optional bestiary record supplying replacement physical statistics. |
| `duration_secs` | `LevelLadder` | optional | Duration in seconds, stepped by the granting class level. |
| `ends` | `FormEnds` | optional | Events that end this replacement through the ordinary form lifecycle. |
| `form_id` | `string` | required | Stable mechanics identity within the loaded corpus. |
| `policy` | `FormPolicy` | optional | Stat, proficiency, equipment, and capability arbitration for the form. |
| `replace_hit_points` | `boolean` | default `false` | True when the form owns a separate HP pool; false retains current HP. |
| `selection` | `FormSelection` | optional | Optional open-catalogue selection resolved before the cast transition. |
| `size` | `Size` | optional | Optional explicit size override, including size-only effects. |

<a id="form-policy"></a>

### FormPolicy

Shared replacement arbitration consumed by live play and search.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `capabilities` | `FormCapabilityPolicy` | required | Capability arbitration between bearer and replacement body. |
| `equipment` | `FormEquipmentPolicy` | required | Equipment disposition while the form is active. |
| `proficiencies` | `FormProficiencyPolicy` | required | Skill and saving-throw proficiency arbitration. |
| `retain_abilities` | `Ability[]` | required | Ability scores retained from the original body. |

<a id="form-proficiency-policy"></a>

### FormProficiencyPolicy

Arbitration used when both the bearer and form supply a proficiency.

<a id="form-proficiency-policy--higher-of-original-or-form"></a>

#### FormProficiencyPolicy::HigherOfOriginalOrForm

Use the greater of the original and form bonuses.

<a id="form-proficiency-policy--form"></a>

#### FormProficiencyPolicy::Form

Use only the form's authored bonus.

<a id="form-selection"></a>

### FormSelection

One open creature catalogue filtered entirely by authored parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `creature_types` | `string[]` | required | Nonempty set of allowed open creature-type ids. |
| `known` | `KnownFormSelection` | optional | Optional durable known-form catalogue and its capacity. |
| `maximum_cr_quarters` | `LevelLadder` | required | Maximum challenge rating in quarter-CR units by granting class level. |
| `movement_minimum_levels` | `[MovementMode, uint32][]` | default `[]` | Minimum granting class level for each restricted movement mode. |

<a id="known-form-selection"></a>

### KnownFormSelection

Durable form knowledge owned by the grant and filled deterministically.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | `LevelLadder` | required | Maximum number of retained known forms by granting class level. |
| `group` | `string` | required | Open storage group id; unrelated grants may keep separate catalogues. |
| `starters` | `string[]` | default `[]` | Ordered forms every bearer is assumed to have seen, admitted when legal. |

<a id="level-ladder"></a>

### LevelLadder

A positive value with strictly increasing granting-class-level steps.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `by_level` | `[uint32, uint32][]` | default `[]` | `(class level, value)` replacements, in ascending level order. |
| `count` | `uint32` | required | Value before the first reached step. |

<a id="movement-mode"></a>

### MovementMode

Authorable `MovementMode` data exposed through the modding schema.

<a id="movement-mode--walk"></a>

#### MovementMode::Walk

Select the walk behavior.

<a id="movement-mode--climb"></a>

#### MovementMode::Climb

Select the climb behavior.

<a id="movement-mode--swim"></a>

#### MovementMode::Swim

Select the swim behavior.

<a id="movement-mode--fly"></a>

#### MovementMode::Fly

Select the fly behavior.

<a id="movement-mode--burrow"></a>

#### MovementMode::Burrow

Select the burrow behavior.

<a id="movement-surface"></a>

### MovementSurface

A combat surface that ordinary walking does not otherwise permit.

<a id="movement-surface--vertical"></a>

#### MovementSurface::Vertical

A vertical wall or similar upright surface.

<a id="movement-surface--liquid"></a>

#### MovementSurface::Liquid

A liquid surface that would ordinarily require swimming.

<a id="on-save"></a>

### OnSave

What a failed save spares (SRD: "half as much damage on a successful one").

<a id="on-save--half"></a>

#### OnSave::Half

Select the half behavior.

<a id="on-save--nothing"></a>

#### OnSave::Nothing

Select the nothing behavior.

<a id="optional-effect-consequence"></a>

### OptionalEffectConsequence

A typed, optional consequence offered to the effect's source at a recurring event boundary. The choice is not a Reaction and spends no action economy.

<a id="optional-effect-consequence--speed-penalty-until-source-next-turn"></a>

#### OptionalEffectConsequence::SpeedPenaltyUntilSourceNextTurn

Reduce every movement mode by this many feet until the source's next turn starts. The reduction never lowers a mode below zero.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `amount_ft` | `uint32` | required |  |

<a id="persistent-reactivation"></a>

### PersistentReactivation

Authorable `PersistentReactivation` data exposed through the modding schema.

<a id="persistent-reactivation--action"></a>

#### PersistentReactivation::Action

Select the action behavior.

<a id="persistent-reactivation--bonus-action"></a>

#### PersistentReactivation::BonusAction

Select the bonus action behavior.

<a id="persistent-reactivation--movement"></a>

#### PersistentReactivation::Movement

Select the movement behavior.

<a id="persistent-reactivation-effect"></a>

### PersistentReactivationEffect

The typed consequence paid for by a persistent spell's later activation. Keeping this separate from the action economy prevents a spell from being transcribed as merely "reactivatable" when the reactivation does nothing.

<a id="persistent-reactivation-effect--teleport-self"></a>

#### PersistentReactivationEffect::TeleportSelf

Select the teleport self behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `max_ft` | `uint32` | required |  |

<a id="persistent-reactivation-effect--repeat-damage"></a>

#### PersistentReactivationEffect::RepeatDamage

Select the repeat damage behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `kind` | `string` | required |  |

<a id="persistent-spell-payload"></a>

### PersistentSpellPayload

Authorable `PersistentSpellPayload` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `antimagic` | `AntimagicPolicy` | required | Authored antimagic. |
| `duration_rounds` | `uint32` | required | Authored duration rounds. |
| `explicit_slot_choice` | `boolean` | default `false` | Authored explicit slot choice. |
| `reactivation` | `PersistentReactivation` | optional | Authored reactivation. |
| `reactivation_effect` | `PersistentReactivationEffect` | optional | Authored reactivation effect. |
| `reactivation_on_casting_turn` | `boolean` | default `false` | Allow reactivation on the casting turn. Omitted or false restricts it to the caster's later turns. |
| `reactivation_survives_miss` | `boolean` | default `false` | Install the persistent effect even when its initial spell attack misses. Omitted or false keeps installation conditional on a hit. |
| `tethered_to_target` | `boolean` | default `false` | End the spell if its target leaves the spell's range or has Total Cover from the caster. Omitted or false imposes neither ending. |

<a id="privileged-cast-mode"></a>

### PrivilegedCastMode

One legal profile for a class-granted cast.

<a id="privileged-cast-mode--base"></a>

#### PrivilegedCastMode::Base

Preserve the referenced spell's authored profile.

<a id="privileged-cast-mode--override"></a>

#### PrivilegedCastMode::Override

Apply bounded existing cast transformations and summon augmentation before the ordinary cast compiler sees the spell.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `transformations` | `CastTransformation[]` | required |  |

<a id="privileged-cast-payment"></a>

### PrivilegedCastPayment

The legal payment alternatives for one class-granted cast.

<a id="privileged-cast-payment--free-use-or-slot"></a>

#### PrivilegedCastPayment::FreeUseOrSlot

Spend the invoking grant's free use or one ordinary spell slot at or above this level. Availability is the union of the two alternatives.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `minimum_slot` | `uint32` | required |  |

<a id="privileged-cast-profile"></a>

### PrivilegedCastProfile

A bounded spell profile attached to an activated cast privilege.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `free_cast_level` | `uint32` | required | Fixed slot level used by the free alternative. |
| `modes` | `PrivilegedCastMode[]` | required | Complete legal profiles: an empty list is invalid. `Base` preserves the referenced spell; `Override` applies the listed transformations. |
| `payment` | `PrivilegedCastPayment` | required | Authored alternatives for paying the cast. |
| `summon` | `SummonAugmentation` | optional | Summon-only declaration data shared by every legal lifetime mode. |

<a id="reaction-defense-payload"></a>

### ReactionDefensePayload

Content-authored pre-resolution defense or cancellation. The event window determines when it may be offered; identity never participates in dispatch.

<a id="reaction-defense-payload--timed-ac"></a>

#### ReactionDefensePayload::TimedAc

Select the timed ac behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bonus` | `int64` | required |  |
| `rounds` | `uint32` | required |  |

<a id="reaction-defense-payload--damage-reduction"></a>

#### ReactionDefensePayload::DamageReduction

Select the damage reduction behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |
| `modifier` | `int64` | required |  |

<a id="reaction-defense-payload--cancel-pending-cast"></a>

#### ReactionDefensePayload::CancelPendingCast

Select the cancel pending cast behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `check` | `CancellationCheck` | required |  |

<a id="reaction-defense-payload--cancel-ongoing-effect"></a>

#### ReactionDefensePayload::CancelOngoingEffect

Select the cancel ongoing effect behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `check` | `CancellationCheck` | required |  |

<a id="reaction-spell-trigger"></a>

### ReactionSpellTrigger

The closed, perceivable event window in which a Reaction spell may be cast. Content identity does not participate in dispatch: every reaction spell declares one of these mechanical trigger shapes in data.

<a id="reaction-spell-trigger--see-creature-cast"></a>

#### ReactionSpellTrigger::SeeCreatureCast

Select the see creature cast behavior.

<a id="reaction-spell-trigger--creature-falls"></a>

#### ReactionSpellTrigger::CreatureFalls

Select the creature falls behavior.

<a id="reaction-spell-trigger--damaged-by-creature"></a>

#### ReactionSpellTrigger::DamagedByCreature

Select the damaged by creature behavior.

<a id="reaction-spell-trigger--hit-by-attack"></a>

#### ReactionSpellTrigger::HitByAttack

Select the hit by attack behavior.

<a id="repeat-save-gate"></a>

### RepeatSaveGate

Authorable `RepeatSaveGate` data exposed through the modding schema.

<a id="repeat-save-gate--always"></a>

#### RepeatSaveGate::Always

Select the always behavior.

<a id="repeat-save-gate--source-not-visible"></a>

#### RepeatSaveGate::SourceNotVisible

Select the source not visible behavior.

<a id="repeat-save-rule"></a>

### RepeatSaveRule

Authorable `RepeatSaveRule` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `boundary` | `TurnBoundary` | required | Authored boundary. |
| `gate` | `RepeatSaveGate` | required | Authored gate. |

<a id="resource-exchange-rate"></a>

### ResourceExchangeRate

One finite conversion row in a generic resource-exchange route.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `destination_amount` | `uint32` | required | Positive destination units granted atomically. |
| `destination_tier` | `uint8` | required | Destination tier, or zero for an un-tiered pool/use ledger. |
| `minimum_class_level` | `uint32` | required | First granting-class level at which this row is legal. |
| `source_amount` | `uint32` | required | Positive source units consumed atomically. |
| `source_tier` | `uint8` | required | Source tier, or zero for an un-tiered pool/use ledger. |

<a id="resource-exchange-route"></a>

### ResourceExchangeRoute

One direction offered by a generic resource exchange.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `capacity_cap` | `boolean` | default `false` | Clamp the credit to the destination ledger's authored capacity. |
| `destination` | `FeatureResourceLedger` | required | Ledger credited by the accepted conversion. |
| `economy` | `FeatureActionEconomy` | required | Turn economy paid when this route is accepted. |
| `limit` | `FeatureActionLedger` | optional | Optional per-turn/rest/use gate paid in addition to the exchanged source. |
| `rates` | `ResourceExchangeRate[]` | required | Finite, duplicate-free conversion table. |
| `source` | `FeatureResourceLedger` | required | Ledger paid by the accepted conversion. |
| `temporary_destination` | `boolean` | default `false` | Mark created destination spell slots as temporary until a long rest. |

<a id="rider-exchange-budget"></a>

### RiderExchangeBudget

The resource surrendered atomically when accepting authored hit riders.

<a id="rider-exchange-budget--damage-dice"></a>

#### RiderExchangeBudget::DamageDice

Remove this many dice from the parent damage roll.

<a id="rider-exchange-budget--advantage"></a>

#### RiderExchangeBudget::Advantage

Forgo Advantage on the parent attack.

<a id="rider-exchange-choice"></a>

### RiderExchangeChoice

One open-id option in a generic rider exchange.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `blocks_opportunity_attacks` | `boolean` | default `false` | Prevent the target from making Opportunity Attacks until the source's next turn. |
| `cost` | `uint32` | required | Positive units removed from the exchange budget. |
| `effects` | `Effect[]` | required | Ordered consequences interpreted through the ordinary effect readers. |
| `follow_speed_fraction_denominator` | `integer` | optional | Denominator of the source's Speed it may spend to follow forced movement without provoking Opportunity Attacks. |
| `id` | `string` | required | Open authored id used by UI and recorded decisions, never dispatch. |
| `level` | `uint32` | required | First granting-class level at which this option is legal. |
| `next_other_creature_attack_bonus` | `int64` | default `0` | Flat bonus to the next attack by a creature other than the source. |
| `next_save_disadvantage` | `boolean` | default `false` | Give the target Disadvantage on its next saving throw. This one-shot persists until the save, independently of a turn-boundary rider. |
| `requires_carried_item` | `string` | optional | A goods/ id the source must carry on its person for this choice to be offered or paid; absent = no item is needed. |
| `save` | `Ability` | optional | Optional saving throw governing this choice's consequences. |
| `speed_penalty_ft` | `uint32` | default `0` | Reduce every movement mode by this many feet until the source's next turn. Zero means no reduction. |

<a id="size"></a>

### Size

Creature size — the full SRD ladder (Tiny..Gargantuan). Races span Small/Medium; the bestiary's monsters reach the rest, and the hit die swings by it (`crate::srd::hit_die`).

<a id="size--tiny"></a>

#### Size::Tiny

Select the tiny behavior.

<a id="size--small"></a>

#### Size::Small

Select the small behavior.

<a id="size--medium"></a>

#### Size::Medium

Select the medium behavior.

<a id="size--large"></a>

#### Size::Large

Select the large behavior.

<a id="size--huge"></a>

#### Size::Huge

Select the huge behavior.

<a id="size--gargantuan"></a>

#### Size::Gargantuan

Select the gargantuan behavior.

<a id="skill"></a>

### Skill

An open, validated Skill id interned from authored data.

<a id="slot-scaled-damage"></a>

### SlotScaledDamage

Damage contributed by a hit rider whose size follows the spell-slot level spent at the hit boundary.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `base_dice` | `string` | required | Dice contributed at the first slot level. |
| `kind` | `string` | required | A `tables/damage_kinds.srd.ron` id. |
| `maximum_dice` | `integer` | optional | Optional cap on dice before creature-type or other ordinary bonuses. |
| `per_slot_die` | `string` | required | Dice added for every slot level above the first. |

<a id="source"></a>

### Source

Every file's top-level value carries `source`.

<a id="source--srd51"></a>

#### Source::Srd51

SRD 5.1 — retained nonconflicting catalogue material.

<a id="source--srd52"></a>

#### Source::Srd52

SRD 5.2.1 — the 2024-revision System Reference Document, the same CC-BY-4.0 grant as 5.1 and the current rules chassis. Its files carry the `.srd52.ron` suffix so provenance reads off the path; see `data/README.md` for which document rules a given value.

<a id="source--original"></a>

#### Source::Original

Original content authored for this game (not from the SRD).

<a id="source--phb2024"></a>

#### Source::Phb2024

Material transcribed from the 2024 Player's Handbook. This source is not redistributable by this project and belongs in a `phb2024` mod.

<a id="source--dmg2024"></a>

#### Source::Dmg2024

Material transcribed from the 2024 Dungeon Master's Guide. This source is not redistributable by this project and belongs in a `dmg2024` mod.

<a id="source--mm2024"></a>

#### Source::Mm2024

Material transcribed from the 2024 Monster Manual. This source is not redistributable by this project and belongs in an `mm2024` mod.

<a id="source--tce"></a>

#### Source::Tce

Material transcribed from Tasha's Cauldron of Everything. This source is not redistributable by this project and belongs in a `tce` mod.

<a id="source--xge"></a>

#### Source::Xge

Material transcribed from Xanathar's Guide to Everything. This source is not redistributable by this project and belongs in an `xge` mod.

<a id="spell-components"></a>

### SpellComponents

The spell's Verbal, Somatic and Material component requirements. A consumed material or one with a specified cost cannot be replaced by a Component Pouch or Spellcasting Focus.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `material` | `boolean` | default `false` | Authored material. |
| `material_consumed` | `boolean` | default `false` | Whether the spell consumes its material component. Defaults to false. |
| `material_costly` | `boolean` | default `false` | Whether the Components entry specifies a cost for the material. Records that requirement without storing a gold amount. Defaults to false. |
| `somatic` | `boolean` | default `false` | Authored somatic. |
| `verbal` | `boolean` | default `false` | Authored verbal. |

<a id="spell-phase"></a>

### SpellPhase

One independently gated phase in an ordered spell composition. The cast's aim is shared, while each phase owns the delivery gate and effects that follow it. This represents mechanics such as an attack followed by an explosion that occurs whether the attack hits or misses.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `delivery` | `Delivery` | required | Authored delivery. |
| `effects` | `Effect[]` | required | Authored effects. |
| `upcast` | `Upcast` | optional | Higher-slot scaling owned by this phase. Absence means this phase does not scale independently of the required first phase. |
| `upcast_effects` | `array` | optional | Zero-based positions in this phase's effects that receive roll scaling. Absence uses the first cast-time roll and each ongoing roll. An explicit list must be nonempty and name only effects with scalable dice. |

<a id="spell-range"></a>

### SpellRange

A spell's range. `Caster` is the SRD's "Self" (a Rust-reserved word).

<a id="spell-range--touch"></a>

#### SpellRange::Touch

Touch — the caster must reach the target (SRD "Touch").

<a id="spell-range--feet"></a>

#### SpellRange::Feet

A ranged spell out to this many feet.

Carries `uint32`.

<a id="spell-range--caster"></a>

#### SpellRange::Caster

Self — the spell affects only the caster (SRD "Self").

<a id="summon-augmentation"></a>

### SummonAugmentation

Reusable augmentation applied to an authored `Summon` recipe.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `choice_binding` | `SummonChoiceBinding` | optional | Optional binding from the cast choice into the joined body's action. |
| `dismiss` | `CastTime` | optional | Optional economy with which the source may dismiss the summon. |
| `linked_grants` | `SummonLinkedGrant[]` | default `[]` | Source-linked effects installed only when the generated body joins. |

<a id="summon-choice-binding"></a>

### SummonChoiceBinding

Bind an authored choice carried by the generated summon body.

<a id="summon-choice-binding--selected-damage-kind"></a>

#### SummonChoiceBinding::SelectedDamageKind

Select one kind from the joined body's authored `DamageTypeChoice`.

<a id="summon-grant-lifetime"></a>

### SummonGrantLifetime

The lifetime of a source-linked summon grant.

<a id="summon-grant-lifetime--same-summon"></a>

#### SummonGrantLifetime::SameSummon

The grant exists exactly while its joined source body exists.

<a id="summon-grant-participant"></a>

### SummonGrantParticipant

A participant in a source-linked summon grant.

<a id="summon-grant-participant--caster"></a>

#### SummonGrantParticipant::Caster

The creature that invoked the cast privilege.

<a id="summon-grant-participant--joined-body"></a>

#### SummonGrantParticipant::JoinedBody

The generated body written by the ordinary summon transition.

<a id="summon-linked-effect"></a>

### SummonLinkedEffect

An existing persistent effect installed when a generated body joins.

<a id="summon-linked-effect--selected-damage-kind-resistance"></a>

#### SummonLinkedEffect::SelectedDamageKindResistance

Resistance to the kind selected through `choice_binding`.

<a id="summon-linked-grant"></a>

### SummonLinkedGrant

One source-linked effect recipe installed by the ordinary summon join.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `effect` | `SummonLinkedEffect` | required | Existing persistent effect to instantiate. |
| `lifetime` | `SummonGrantLifetime` | required | Removal clock for the effect. |
| `recipient` | `SummonGrantParticipant` | required | Body receiving the effect. |
| `source` | `SummonGrantParticipant` | required | Body whose departure removes the effect. |

<a id="summon-scaling"></a>

### SummonScaling

Content-neutral formulas used by scalable summoned-spirit stat blocks.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ac_base` | `int64` | required | Authored ac base. |
| `base_slot` | `uint32` | required | Authored base slot. |
| `caster_spell_attack` | `boolean` | default `false` | Authored caster spell attack. |
| `controlled` | `boolean` | default `false` | A controlled spirit shares its summoner's Initiative and requires a fresh verbal command each round; without one it can only Dodge. |
| `damage_flat_base` | `int64` | required | Authored damage flat base. |
| `damage_flat_per_slot` | `int64` | required | Flat damage added per slot to the generated body's natural attack and each delivered damage action carried by its creature row. |
| `hp_base` | `int64` | required | Authored hp base. |
| `hp_per_slot` | `int64` | required | Authored hp per slot. |
| `strikes_divisor` | `uint32` | required | Authored strikes divisor. |
| `variants` | `SummonVariant[]` | default `[]` | Closed authored stat-block choices offered by the cast action. |

<a id="summon-variant"></a>

### SummonVariant

Authorable `SummonVariant` data exposed through the modding schema.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ac_base` | `integer` | optional | Optional AC base for a variant whose printed body changes the shared `ac_base + slot` formula. |
| `creature_id` | `string` | required | Authored creature id. |
| `damage_flat_base` | `integer` | optional | Optional flat-damage base for a variant whose printed attack changes the shared `damage_flat_base + slot * damage_flat_per_slot` formula. |
| `hp_base` | `int64` | required | Authored hp base. |
| `id` | `string` | required | Authored id. |

<a id="triggered-zone-outcome"></a>

### TriggeredZoneOutcome

The consequence of entering or starting a turn in a triggered area.

<a id="triggered-zone-outcome--heal"></a>

#### TriggeredZoneOutcome::Heal

Restore hit points; the upcast-adjusted dice are baked at cast time.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice` | `string` | required |  |

<a id="triggered-zone-outcome--save-negates-damage"></a>

#### TriggeredZoneOutcome::SaveNegatesDamage

Save-negates damage and source-owned riders. Riders are removed when the source's concentration ends.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `dice` | `string` | required |  |
| `exhaustion` | `uint8` | default `0` |  |
| `kind` | `string` | required |  |
| `light_radius_ft` | `uint32` | default `0` |  |
| `suppress_invisibility` | `boolean` | default `false` |  |

<a id="triggered-zone-outcome--movement-damage"></a>

#### TriggeredZoneOutcome::MovementDamage

Deal `dice_per_5ft` once for every five feet voluntarily or forcibly travelled inside the area; no start-turn consequence is implied.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dice_per_5ft` | `string` | required |  |
| `kind` | `string` | required |  |

<a id="triggered-zone-shape"></a>

### TriggeredZoneShape

Grid footprint used by a triggered spell area.

<a id="triggered-zone-shape--sphere"></a>

#### TriggeredZoneShape::Sphere

A radius measured with the board's square-grid distance.

<a id="triggered-zone-shape--cube"></a>

#### TriggeredZoneShape::Cube

A cube whose authored width is `radius_ft * 2` on this centered grid.

<a id="triggered-zone-uses"></a>

### TriggeredZoneUses

A finite zone-use ledger derived once when the spell is cast.

<a id="triggered-zone-uses--ability-modifier-plus"></a>

#### TriggeredZoneUses::AbilityModifierPlus

`plus + ability modifier`, clamped to at least `minimum` uses.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required |  |
| `minimum` | `uint32` | required |  |
| `plus` | `int32` | required |  |

<a id="turn-boundary"></a>

### TurnBoundary

Authorable `TurnBoundary` data exposed through the modding schema.

<a id="turn-boundary--start"></a>

#### TurnBoundary::Start

Select the start behavior.

<a id="turn-boundary--end"></a>

#### TurnBoundary::End

Select the end behavior.

<a id="upcast"></a>

### Upcast

How a spell scales (SRD "At Higher Levels" + the cantrip level steps).

<a id="upcast--none"></a>

#### Upcast::None

No higher-level text.

<a id="upcast--dice-per-slot"></a>

#### Upcast::DicePerSlot

+`String` dice per slot level above the spell's own, applied to the rolls selected by `upcast_effects`. Ongoing rolls store their scaled dice at cast time.

Carries `string`.

<a id="upcast--dice-per-two-slots"></a>

#### Upcast::DicePerTwoSlots

+the authored dice once for every two slot levels above the spell's base level (for example, 3rd -> 5th -> 7th -> 9th).

Carries `string`.

<a id="upcast--extra-per-slot"></a>

#### Upcast::ExtraPerSlot

+1 dart/ray per slot level above the spell's own.

<a id="upcast--extra-target-per-slot"></a>

#### Upcast::ExtraTargetPerSlot

+1 TARGET per slot level above the spell's own: bless's extra ally, hold person's extra foe. On an `Allies` delivery it bumps the target count; on a single-target `Save` (area `None`) it adds that many nearest enemies within range. The sibling of `ExtraPerSlot` — that fans out projectiles at one target, this fans out DISTINCT creatures.

<a id="upcast--flat-per-slot"></a>

#### Upcast::FlatPerSlot

+`i64` FLAT per slot level above the spell's own: false life's +5 temporary hit points a slot. Added to the targeted cast-time dice steps' flat totals (their rolled amounts), NOT their dice — the flat-number axis `DicePerSlot` (dice) cannot express.

Carries `int64`.

<a id="upcast--summons-per-two-slots"></a>

#### Upcast::SummonsPerTwoSlots

A conjuring's creature COUNT doubles per TWO slots above the spell's own: conjure animals' "twice as many at 5th, three times at 7th, four times at 9th". Mints `1 + (slot − level) / 2` copies of the summon.

<a id="upcast--cr-per-slot"></a>

#### Upcast::CrPerSlot

A conjuring's CHALLENGE RATING budget rises by one rung per slot level above the spell's own (conjure elemental's "the challenge rating increases by 1 for each slot level above 5th"), and the strongest creature of the summoned body's own TYPE within that budget is what answers the call. A better body, not more bodies.

<a id="upcast--cr-per-two-slots"></a>

#### Upcast::CrPerTwoSlots

The same CR budget, rising one rung per TWO slot levels above the spell's own — conjure celestial, whose higher-level text is a single step at 9th rather than a per-slot climb.