Npc
creatures/**/<id>.srd.ron — one per file; stem == id. PRIMITIVES ONLY; composites derive (data/README.md, "Derivations").
| Field | Type | Required | Description |
|---|---|---|---|
| abilities | [Ability, uint32][] | required | Base ability scores, BEFORE racial adjustments. |
| actions | FeatureGrant[] | optional | Self-defining stat-block actions. These are the same shared grants used by class, feat, race, and subrace rows; natural attacks remain separate. |
| alignment | AlignmentConstraint | required | The block's alignment line as a generation constraint, not a value. |
| armor | string[] | required | Armor ids, boot-resolved; empty = unarmored. |
| attacks | NaturalAttack[] | optional | The monster's natural attacks — read at combatant assemble so it strikes with its own bite/claw/slam, not a borrowed weapon. Empty on the humanoid blocks (they fight with |
| blindsight | integer | optional | Blindsight radius in feet; absent = none. |
| breathing | BreathingMode | optional | The exact environment(s) in which this creature can breathe. |
| burrow_speed | integer | optional | Authored burrow speed. |
| class_shaped | boolean | default false | Whether a soul borrowing this creature's combat archetype enters the class-shaped life at genesis. Absent means the archetype only supplies combat equipment and leaves its members classless. |
| climb_speed | integer | optional | Dedicated movement speeds in feet. Absence means the creature pays the ordinary extra movement cost for climbing/swimming and cannot fly or burrow. |
| condition_immunities | string[] | default [] | Conditions this creature can never suffer — |
| cr | string | required | The cr_xp key, boot-resolved — the stored primitive that feeds xp(cr). |
| creature_type | string | required | A |
| darkvision | boolean | default false | SRD senses off the stat block's "Senses" line — darkvision (a bool presence flag; monsters are raceless so it rides the block, not a composed race) and the special senses in FEET of radius. Stamped at |
| doors | CreatureDoor[] | default ["Encounter","Battle","Form","Summon"] | The closed set of game doors allowed to enumerate this creature. Absent means all four doors; an explicit list may narrow availability. A swarm ( |
| expertise | Skill[] | default [] | Printed skill expertise; every entry must also be proficient. |
| fly_speed | integer | optional | Authored fly speed. |
| flyby | boolean | default false | Movement does not provoke opportunity attacks. |
| hold_breath_rounds | integer | optional | An authored breath-holding duration in combat rounds. Absent creatures use the ordinary Constitution-derived suffocation capacity. |
| hover | boolean | default false | Authored hover. |
| id | string | required | Authored id. |
| illumination | MonsterIllumination | optional | Passive light shed by the creature itself, in feet: bright radius and the ADDITIONAL dim radius beyond it. Unlike a spell or torch this has no expiration window; combat projects it onto the same moving light-source representation consumed by live play and search. |
| immunities | string[] | default [] | SRD damage immunities / vulnerabilities on the creature stat block — damage-kind ids, read at bubble assemble like the kit ( |
| jump_ability | Ability | optional | Ability score used by the ordinary jump-distance formula. Absent uses Strength; authored monsters such as the 2024 Cat may name Dexterity. |
| languages | string[] | default [] | SRD known languages off the stat block — |
| leap | AuthoredLeap | optional | A printed Standing Leap or Running Leap profile. When absent, ordinary Strength-derived jump distances apply unchanged. |
| level | uint32 | required | Level == hit-dice count. |
| mount | MountTraining | optional | Annotation that this creature can serve as a trained mount. The engine does not currently read this field or implement riding rules. |
| multiattack | integer | optional | Attacks one Attack action makes — the printed Multiattack count, wired into the NPC turn like Extra Attack. ABSENT = one. A conditional/compound multiattack (grick's beak-on-hit, a dragon's distinct bite+claws) is LEDGERED — this is the simple count. |
| multiattack_sequence | string[] | default [] | Ordered natural-attack names made by one Multiattack action. This is the exact profile form for blocks such as "one Bite and one Claw"; the legacy count above remains for repeated copies of a single attack. |
| multiattack_steps | MonsterMultiattackStep[] | default [] | Typed sequence for Multiattacks which mix attack-roll actions with saving-throw actions. Mutually exclusive with |
| natural_armor | integer | optional | SRD natural armor: the AC base a monster's hide/scales/plating gives, to which its Dex mod adds ( |
| nimble_escape | boolean | default false | Authored nimble escape. |
| pack_tactics | boolean | default false | Advantage on attack rolls while a conscious ally threatens the target. |
| proficiencies | Skill[] | required | The skill-proficiency SET; bonuses derive. |
| resistances | string[] | default [] | SRD damage resistances on the creature stat block — damage-kind ids taken at HALF, read at bubble assemble beside the composed race/class resistances (a dretch halves fire, a gray ooze halves acid/cold/fire). Absent = none. The "from nonmagical attacks" qualifier a few blocks carry is LEDGERED (no magical-weapon distinction yet) — such a resistance is listed plainly or noted in the file. |
| save_proficiencies | Ability[] | default [] | Saving-throw proficiencies printed on the stat block. Raceless creatures have no class chassis, so combat derives these directly. |
| size | Size | optional | A monster's OWN size — monsters are raceless, so there is no composed race to derive it from; the hit die swings by it. ABSENT means the humanoid "(any race)" assumption (size comes from the composed race, Medium in the printed corpus) — no humanoid block carries it. |
| source | Source | required | Authored source. |
| speed | integer | optional | A monster's OWN speed in feet — raceless, so stamped from the block. ABSENT = the composed race's speed (the humanoid blocks). |
| swarm_member_size | Size | optional | The member size of a creature that is mechanically a swarm. Swarms may share creature spaces and cannot regain HP or gain temporary HP. |
| swim_speed | integer | optional | Authored swim speed. |
| tremorsense | integer | optional | Tremorsense radius in feet; absent = none. |
| truesight | integer | optional | Truesight radius in feet; absent = none. |
| vulnerabilities | string[] | default [] | Damage-kind ids taken at DOUBLE; absent = none. |
| weapons | string[] | required | Weapon ids, boot-resolved. |
Nested shapes
Every shape Npc closes over, so this page stands alone.
Ability
An open, validated Ability id interned from authored data.
AfflictionEntryEffect
Authorable AfflictionEntryEffect data exposed through the modding schema.
DropHeldItems
Select the drop held items behavior.
AlignmentConstraint
The blocks' printed alignment lines as generation constraints (data/README.md).
Any
Select the any behavior.
NonLawful
Select the non lawful behavior.
NonGood
Select the non good behavior.
Chaotic
Select the chaotic behavior.
AntimagicPolicy
Authorable AntimagicPolicy data exposed through the modding schema.
SuppressResume
Select the suppress resume behavior.
SuppressEnd
Select the suppress end behavior.
Immune
Select the immune behavior.
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).
Sphere
A sphere of radius_ft, centered on the target point (fireball).
| Field | Type | Required | Description |
|---|---|---|---|
| radius_ft | uint32 | required |
Cone
A cone of length_ft, thrown from the caster toward the target (burning hands).
| Field | Type | Required | Description |
|---|---|---|---|
| length_ft | uint32 | required |
Line
A line of length_ft, thrown from the caster toward the target (lightning bolt).
| Field | Type | Required | Description |
|---|---|---|---|
| length_ft | uint32 | required |
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 |
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 |
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 |
ArmorCategory
The SRD armor categories — light/medium/heavy body armor and the shield.
Light
Select the light behavior.
Medium
Select the medium behavior.
Heavy
Select the heavy behavior.
Shield
Select the shield behavior.
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.
PreventHealingUntilSourceNextTurn
Select the prevent healing until source next turn behavior.
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. |
AuthoredForcedAction
Authorable AuthoredForcedAction data exposed through the modding schema.
Approach
Select the approach behavior.
Drop
Select the drop behavior.
Flee
Select the flee behavior.
Grovel
Select the grovel behavior.
Halt
Select the halt behavior.
AuthoredLeap
An authored leap that overrides the ordinary Strength-derived maximum when its run-up requirement is met. Creatures and explicitly worn equipment use this same typed movement primitive. Distances are authored in feet.
| Field | Type | Required | Description |
|---|---|---|---|
| bonus_action | boolean | default false | This authored leap spends the creature's Bonus Action. |
| high_jump_ft | integer | optional | Authored high jump ft. |
| long_jump_ft | integer | optional | Authored long jump ft. |
| movement_cost_ft | integer | optional | Fixed movement paid for the leap, regardless of distance traveled. |
| once_per_turn | boolean | default false | This special leap can be used only once on each of the creature's turns. |
| requires_running_start | boolean | default false | Authored requires running start. |
BreathingMode
Native respiration for creatures whose stat block departs from the usual air-only physiology.
AirOnly
Select the air only behavior.
WaterOnly
Select the water only behavior.
Amphibious
Select the amphibious behavior.
CancellationCheck
The closed resolution gate for cancelling a spell or ongoing effect.
Automatic
Select the automatic behavior.
D20
Select the d20 behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| dc | int64 | required | |
| modifier | int64 | required |
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 |
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 |
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 |
CastSpellFilter
A spell catalogue predicate used by cast privileges and transformations. 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. |
CastTime
Casting times supported by the combat turn economy: Action, BonusAction, and Reaction. Longer castings, such as rituals, are not represented here.
Action
Select the action behavior.
BonusAction
Select the bonus action behavior.
Reaction
Select the reaction behavior.
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 |
| 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. |
CastTransformation
A bounded mechanical change an authored cast-transform option applies.
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 |
RangeMultiplier
Multiply a ranged spell and give a Touch spell the authored reach.
| Field | Type | Required | Description |
|---|---|---|---|
| multiplier | uint32 | required | |
| touch_feet | uint32 | required |
ExtraTargets
Add distinct targets near the first target.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint32 | required | |
| within_ft | uint32 | required |
DurationMultiplier
Multiply a finite duration by this positive factor.
| Field | Type | Required | Description |
|---|---|---|---|
| multiplier | uint32 | required |
DurationSeconds
Replace the spell's finite duration with this exact positive value.
| Field | Type | Required | Description |
|---|---|---|---|
| seconds | uint64 | required |
Concentration
Replace the spell's concentration requirement.
| Field | Type | Required | Description |
|---|---|---|---|
| required | boolean | required |
IgnoreComponents
Suppress the named ordinary component requirements.
| Field | Type | Required | Description |
|---|---|---|---|
| components | SpellComponents | required |
RerollDamageDice
Reroll up to this authored number of damage dice.
| Field | Type | Required | Description |
|---|---|---|---|
| maximum | FeatureValue | required |
RerollAttackRoll
Reroll a missed spell attack up to this many times.
| Field | Type | Required | Description |
|---|---|---|---|
| maximum | uint32 | required |
SaveDisadvantage
Give one target Disadvantage on its first save against the spell.
DamageKindChoice
Choose the resulting damage kind from this nonempty open-id set.
| Field | Type | Required | Description |
|---|---|---|---|
| kinds | string[] | required |
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 |
AddAbilityDamage
Add the named ability modifier once to one matching damage roll.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required |
MaximizeDamage
Maximize the spell's damage dice.
HalfDamageOnSuccessfulSave
A successful save against a damaging cantrip takes half damage.
WaiveCostPerTurn
Waive the option's resource cost for a bounded number of uses per turn.
| Field | Type | Required | Description |
|---|---|---|---|
| uses | uint32 | required |
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 |
| 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. |
ContingentConsequence
Authorable ContingentConsequence data exposed through the modding schema.
PreventDropToOne
Select the prevent drop to one behavior.
ContingentPredicate
Authorable ContingentPredicate data exposed through the modding schema.
WouldDropToZero
Select the would drop to zero behavior.
TurnStart
Select the turn start behavior.
TurnEnd
Select the turn end behavior.
TakesDamage
Select the takes damage behavior.
ContingentTiming
Authorable ContingentTiming data exposed through the modding schema.
BeforeEvent
Select the before event behavior.
AfterEvent
Select the after event behavior.
CreatureDoor
A game door allowed to enumerate a creature. Encounter is wild or ambient world spawning, Battle is the headless battle builder, Form is a transformation catalogue, and Summon is summon upcast substitution.
EncounterBattleFormSummonD20Edge
A one-shot d20 edge armed by a feature action.
SelfAdvantage
Advantage on the bearer's next eligible d20 test.
IncomingAttackDisadvantage
Disadvantage on the next attack made against the bearer.
Damage
Feat ids — the SRD's ONE feat, referenced where its grapple-dependent riders read (the Grappler advantage/pin). A damage roll: dice plus the kind they deal. The shared shape every attack, spell effect and trap payload reaches for, which is why it carries no id of its own — it is always a FIELD of the thing that inflicts it.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required | The damage dice, an |
| kind | string | required | A |
DamageRollAmount
A damage amount supplied by a generic damage-roll policy.
DiceByLevel
Dice selected from a strictly increasing class-level table.
| Field | Type | Required | Description |
|---|---|---|---|
| by_level | [uint32, string][] | required |
AbilityModifier
One authored ability modifier, subject to an authored minimum.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | |
| minimum | int64 | required |
OverrideDieFaces
Replace one eligible damage die's faces with this die size.
| Field | Type | Required | Description |
|---|---|---|---|
| faces | uint32 | required |
DamageRollOutcome
The resolved roll boundary at which a damage policy applies.
Hit
An eligible attack hit.
Miss
An eligible attack or spell missed.
FailedSave
The target failed the effect's saving throw.
SuccessfulSave
The target succeeded on the effect's saving throw.
DamageRollSource
The authored attack or spell family whose damage a generic feature effect may inspect or amend.
Weapon
Any ordinary weapon attack.
MeleeWeapon
An attack with a Melee weapon: a weapon of a melee category, whether it is swung or thrown.
UnarmedStrike
An unarmed strike.
BoundWeapon
The weapon currently bound through an authored feature action.
Cantrip
Any cantrip damage roll.
Spell
One of the listed open spell ids.
| Field | Type | Required | Description |
|---|---|---|---|
| ids | string[] | required |
Mark
Damage attached to the bearer's current authored mark.
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.
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.
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.
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 |
|---|---|---|---|
| rays | uint32 | required |
Auto
Unerring bolts (magic missile): every dart lands, no roll.
| Field | Type | Required | Description |
|---|---|---|---|
| darts | uint32 | required |
AutoArea
Every subject in the area receives the effect list without a roll.
| Field | Type | Required | Description |
|---|---|---|---|
| area | Area | required |
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.
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.
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 |
Target
The named target alone, no roll — the touch utilities.
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.
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. |
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 |
| options | CastTransformOption[] | required | |
| simultaneous_limit | [uint32, uint32][] | default [] | Strictly increasing |
ChoiceDelivery
Offer mutually exclusive, explicitly delivered effect compositions.
| Field | Type | Required | Description |
|---|---|---|---|
| choices | ChoiceDeliveryOption[] | required |
PreparationAccess
Admit spells from authored class lists to preparation without changing the bearer's ordinary prepared-spell capacity.
| Field | Type | Required | Description |
|---|---|---|---|
| classes | string[] | required | |
| exchange_per_rest | integer | optional | Maximum prepared spells replaced through this access after a rest. Absent grants ordinary add-or-replace preparation access. |
| maximum_spell_level | integer | optional | |
| requires_spellbook | boolean | default false |
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 |
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 |
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. |
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. |
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 |
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 |
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 | 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. |
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 |
| minimum_dice | uint32 | required | Minimum number of dice rolled after deriving the modifier. |
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. |
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. |
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 |
| 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. |
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 |
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 |
AttunementCapacity
Override the bearer's derived magic-item attunement capacity.
| Field | Type | Required | Description |
|---|---|---|---|
| capacity | uint32 | required |
ArmD20Edge
Arm one typed one-shot d20 edge on the bearer.
| Field | Type | Required | Description |
|---|---|---|---|
| edge | D20Edge | required |
SwapInitiative
Offer a willing, conscious ally and exchange the two Initiative values.
BestOfTwoWeaponDamage
Roll only the weapon's base damage dice twice and keep the greater sum.
RestoreTurnResource
Restore one already-spent turn resource to the acting creature.
| Field | Type | Required | Description |
|---|---|---|---|
| economy | FeatureActionEconomy | required |
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 |
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 |
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 |
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.
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 |
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 |
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 |
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 |
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 |
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 |
MarkTarget
Install or transfer a source-owned mark onto one target in range.
| Field | Type | Required | Description |
|---|---|---|---|
| damage_die | string | required | |
| range_ft | uint32 | required |
RestorePool
Restore an authored resource pool to its capacity.
| Field | Type | Required | Description |
|---|---|---|---|
| heal_with_capacity_die | boolean | default false | |
| pool | string | required |
BonusStrikes
Offer an authored number of bonus strikes against one legal target.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint8 | required |
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 |
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 |
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 |
SpendHealingPool
Spend points from an authored pool to heal a touched ally or remove one of its conditions at the authored cleanse price.
| Field | Type | Required | Description |
|---|---|---|---|
| cleanse_cost | uint32 | required | |
| points_per_level | uint32 | required | |
| pool | string | required |
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 |
WeaponAttackAbilityBonus
Add one ability modifier to weapon attack rolls for the authored duration.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | |
| rounds | uint32 | required |
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 |
SaveBonusAura
Add one ability modifier to allied saving throws made within an aura.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | |
| radius_ft | uint32 | required |
ConditionImmunityAura
Prevent allies within an aura from gaining one authored condition.
| Field | Type | Required | Description |
|---|---|---|---|
| condition | string | required | |
| radius_ft | uint32 | required |
RollBonus
Add authored dice to the roll currently crossing a trigger boundary.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required |
ReplaceRoll
Replace the d20 currently crossing a trigger boundary with an authored face value.
| Field | Type | Required | Description |
|---|---|---|---|
| value | uint8 | required |
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 |
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. |
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 |
| 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. |
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. |
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 |
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 |
MoveBySpeedFraction
Move the bearer by a fraction of its current speed as part of the boundary transition.
| Field | Type | Required | Description |
|---|---|---|---|
| denominator | uint8 | required |
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 |
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 |
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 |
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 |
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 |
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 |
PersistentSpell
Select the persistent spell behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| payload | PersistentSpellPayload | required |
MaximumHitPointsChange
Select the maximum hit points change behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| amount | int32 | required |
MaximumHitPointsReductionFromDamage
Reduce the target's maximum HP by the damage the immediately preceding damage step actually dealt, after saves and damage modifiers. The life state kernel floors effective maximum HP at 1.
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 |
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 |
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 |
DeathPrevention
Select the death prevention behavior.
ModeChoice
Require one explicit closed authored option before applying this effect.
| Field | Type | Required | Description |
|---|---|---|---|
| choice | AuthoredChoicePayload | required |
ForcedActionControl
Compel one typed action; content identity never participates in dispatch.
| Field | Type | Required | Description |
|---|---|---|---|
| action | AuthoredForcedAction | required |
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 |
Contingent
Arm a separately typed delayed predicate and consequence.
| Field | Type | Required | Description |
|---|---|---|---|
| consequence | ContingentConsequence | required | |
| predicate | ContingentPredicate | required | |
| timing | ContingentTiming | required |
Transform
Replace a target's authored combat form while preserving soul identity.
| Field | Type | Required | Description |
|---|---|---|---|
| form | FormPayload | required |
ChangeSize
Change only the target's occupied size category; all other statistics remain.
| Field | Type | Required | Description |
|---|---|---|---|
| size | Size | required |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
ReactionDefense
Install or resolve a typed pre-resolution defense/cancellation payload.
| Field | Type | Required | Description |
|---|---|---|---|
| payload | ReactionDefensePayload | required |
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. |
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 |
| plus | int64 | default 0 |
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 |
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 |
Heal
Restore dice (+ the casting mod if add_mod) hit points.
| Field | Type | Required | Description |
|---|---|---|---|
| add_mod | boolean | required | |
| dice | string | required |
FlatHeal
Restore an exact authored number of hit points (no die or modifier).
| Field | Type | Required | Description |
|---|---|---|---|
| amount | int64 | required |
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 |
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 |
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 |
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 |
MaximizeHitDieHealing
For the enclosing duration, every Hit Die the target spends restores the die's maximum result rather than its ordinary roll/average.
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 |
Stabilize
End a dying ally's death saves (spare the dying).
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 |
Guide
The glimmer (guiding bolt): the next attack roll against the target has advantage.
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 |
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. |
NextWeaponAttackDisadvantage
The target's next weapon attack is made with Disadvantage; if unused, this expires at the end of that target's next turn.
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 |
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. |
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. |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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.
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 |
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 |
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 |
TempHp
A temporary hit-point grant: the target gains dice + plus temporary hit points — false life's ward. BENEFICIAL, instantaneous (NOT concentration): temp HP sits on the combatant and is spent before real HP (the dark-one's-blessing pool), taking the HIGHER of any existing pool and the fresh grant (SRD "decide whether to keep"). The authored expiry applies only when expires_with_effect is true.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required | |
| expires_with_effect | boolean | default true | Whether this grant expires with the effect's authored duration. |
| plus | int64 | required |
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 |
SaveAdvantage
Source-owned advantage on the listed saving throw abilities for the spell's duration.
| Field | Type | Required | Description |
|---|---|---|---|
| abilities | Ability[] | required |
FeatureAction
One data-authored class-feature activation.
| Field | Type | Required | Description |
|---|---|---|---|
| delivery | Delivery | optional | Optional spell-shaped target, area, and saving-throw gate. When present, the action's effects resolve through the ordinary cast substrate. |
| economy | FeatureActionEconomy | required | Which shared turn resource the action spends. |
| effects | Effect[] | required | Ordered consequences from the shared |
| ledger | FeatureActionLedger | required | Which existing use ledger authorizes and records the activation. This field carries no count: per-rest capacity remains |
| range | SpellRange | optional | Range used when |
| save_dc | FeatureActionSaveDc | optional | Saving-throw DC provenance for a delivered action. Required when its delivery asks for a save; absent for deliveries without one. |
FeatureActionEconomy
The turn resource paid when a feature action is used.
Action
Spend the actor's Action.
Bonus
Spend the actor's Bonus Action.
Reaction
Spend the actor's Reaction.
Free
Spend no turn resource.
FeatureActionLedger
The already-existing store from which a feature action draws uses.
PerRest
The grant's existing uses count, written to FEATURES_SPENT and restored by the feature's ordinary rest cadence.
PerTurn
One activation in the current turn, represented by a combat FeatureClock rather than a second world counter.
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. |
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. |
PerRestOrSpellSlot
A feature use with the existing spell-slot fallback printed by the SRD.
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. |
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. |
FeatureActionSaveDc
How a delivered feature action derives the saving-throw DC used by the shared cast path.
Fixed
Use this exact authored DC, as printed on a creature stat block.
Carries int64.
CasterSpell
Use the spell save DC of the caster who generated this summoned body. This is valid only on an action carried by a scalable summon.
Ability
Use 8 + the bearer's proficiency bonus + this ability modifier.
Carries Ability.
FeatureFact
One typed fact projected from a reached class-feature grant.
Fact is boolean presence. Dice selects the last (class level, "NdM") step at or below the bearer’s level. Count is a nonzero integer in the units documented by its key, optionally replaced by its last reached level step. Level exposes the granting class level. An absent row means the packet receives no such fact. Level tables must be nonempty, strictly increasing, within levels 1–20, and contain legal dice.
Fact
Boolean presence of key.
Carries FeatureFactKey.
Dice
A dice expression selected from a class-level progression table.
| Field | Type | Required | Description |
|---|---|---|---|
| by_level | [uint32, string][] | required | Strictly increasing |
| key | FeatureFactKey | required | The packet fact receiving the selected dice. |
Count
A nonzero authored count in the units documented by key.
| Field | Type | Required | Description |
|---|---|---|---|
| by_level | [uint32, uint32][] | default [] | Optional strictly increasing |
| count | uint32 | required | The nonzero count written to the packet. |
| key | FeatureFactKey | required | The packet fact receiving the count. |
WeaponFilter
A disjunction of weapon predicates; a weapon qualifies when any member matches.
| Field | Type | Required | Description |
|---|---|---|---|
| any | WeaponPredicate[] | required | Nonempty alternatives evaluated in authored order. |
| key | FeatureFactKey | required | The packet fact receiving the authored predicates. |
Level
The reached grant's owning class level.
Carries FeatureFactKey.
SkillProficiencies
Grants the listed skill proficiencies once the feature is reached.
| Field | Type | Required | Description |
|---|---|---|---|
| skills | Skill[] | required | Nonempty skills granted to the composed soul. |
SaveAdvantage
Grants saving-throw advantage in the listed scopes once the feature is reached.
| Field | Type | Required | Description |
|---|---|---|---|
| scopes | SaveAdvantageScope[] | required | Nonempty scopes eligible for the advantage. |
FeatureFactKey
A closed class-feature fact key consumed by the combat entry projection. Each key names one typed packet fact; feature ids remain open data ids and combat never branches on those strings.
PreparedSlotRecovery
Makes prepared-slot recovery available while its grant has a use remaining.
SeenEffectSaveAdvantage
Grants advantage on eligible Dexterity saves.
SkillProficiencies
Grants the listed skill proficiencies once the feature is reached.
RerollNaturalOnes
Rerolls a natural one on an attack roll, check, or saving throw.
SaveAdvantage
Grants advantage on saving throws in the authored scopes.
TempHpOnEnemyFall
Enables temporary hit points when an enemy falls.
PactSlotRecovery
Enables complete pact-slot recovery.
OpportunityDisadvantage
Makes opportunity attacks against the bearer disadvantaged.
HalfOnFailIsNone
Turns a successful save's half damage into no damage.
SchoolCopyCostReduction
Reduces the time and price of copying eligible school spells.
UnseenSenseRadius
Carries an invisible-creature sensing radius in feet.
ExpandedSpellList
Enables an expanded patron spell list.
ChosenDamageResistance
Enables a chosen damage resistance.
AtWillFalseLife
Enables an at-will false-life casting.
AdjacentExtraAttack
Enables one adjacent-target attack after the bearer attacks.
RevealMarkedTargetDefenses
Reveals an affected target's defenses after a mark lands.
PlanarBanishDamage
Makes planar banishment damage available while its grant has a use remaining.
StrengthCheckFloor
Floors eligible Strength checks at the bearer's Strength score.
PartialSlotRecovery
Makes partial pact-slot recovery available while its grant has a use remaining.
RepeatedAttackerAc
Enables the defensive bonus after one creature hits repeatedly.
BoundWeaponCapability
Entitles the bearer to bound-weapon rules.
ConditionPersistence
Prevents an authored condition from ending for lack of attack or damage.
MarkedTargetAdvantage
Grants attack advantage against the current marked target.
MarkPersists
Preserves concentration on a mark when damage is taken.
ProficientCheckFloor
Sets a minimum natural roll for proficient checks.
CantripHitPush
Enables a forced-movement rider on an eligible cantrip hit.
SpellbookRitualCasting
Enables ritual casting from the wizard spellbook.
MovementBoost
Enables authored movement modes and a speed bonus.
KnowledgeExpertise
Enables expertise in an authored knowledge skill.
HitHalfCoverAura
Enables a half-cover aura created by an eligible hit.
DefensiveRiderChoice
Carries hit-rider damage dice by granting class level. Enables a choice among authored defensive riders.
DamageRiderChoice
Enables a choice among authored damage riders.
HalveDamageReaction
Enables the reaction that halves one incoming attack's damage.
WoundedTargetDamageDie
Enables a once-per-turn damage die against a wounded target.
AttacksPerAction
Carries the total number of attacks made by one Attack action.
OpeningInitiativeEdge
Grants initiative advantage and movement when an authored condition starts.
OffhandAbilityDamage
Adds the ability modifier to off-hand weapon damage.
ConditionStrengthSkills
Enables Strength-based authored skill checks while a condition holds.
StandAtOneHpUses
Enables a Constitution save to remain at one hit point and tracks its uses.
AlternateWeaponMasteries
Lets each attack choose among the bearer's mastered weapon properties.
ConstitutionUnarmoredAc
Enables Constitution in the unarmored barbarian AC calculation.
UnarmedDamageDie
Carries an unarmed damage die by granting class level.
UnarmedWeaponFilter
Carries the weapon predicates eligible to use an authored unarmed damage die.
GrappledTargetAdvantage
Grants Advantage against a target currently grappled by the bearer.
ChargeRetention
Gives an item charge a chance to remain unspent after use.
SteedCompanionSummon
Entitles the bearer to assume authored creature forms. Entitles the bearer to summon an authored steed companion profile.
ShortRestExhaustionRecovery
Removes one exhaustion level whenever the bearer finishes a short rest.
WisdomUnarmoredAc
Adds Wisdom to Armor Class while the bearer is unarmored and unshielded.
DexterityNaturalArmor
Sets an unarmored natural-armor base and adds Dexterity to Armor Class.
UntrainedCheckHalfProficiency
Adds half proficiency to an eligible check that otherwise lacks it.
ClassLevelHitPoints
Adds one hit point per granting class level to the derived maximum.
FeatureGrant
One self-defining feature grant: its open id, sheet name, and every mechanic or explicit flavor-only declaration owned by its class, subclass, or race row.
| Field | Type | Required | Description |
|---|---|---|---|
| action | FeatureAction | optional | An activated combat feature declared by this grant. The shared combat step pays the action economy; |
| advisory | string | optional | Optional player-facing guidance shown when this choice is selected. Absent means the option needs no additional advisory. |
| choice | string | optional | If set, this grant is one OPTION in a named choice group rather than an automatic class feature. Grants sharing a |
| facts | FeatureFact[] | optional | Typed combat facts this grant contributes once its class level is reached. Absent means the grant contributes no entry-packet fact. |
| flavor | boolean | default false | True when this named grant is intentionally sheet-only flavor. |
| id | string | required | Open authored id, unique within its owning class. |
| level | uint32 | required | The class level, or character level for a race row, at which the feature is granted. |
| levelup | LevelUpEffect | optional | Optional generic character-growth operation supplied by this grant. |
| modifiers | Modifier[] | optional | The passive mechanics this grant carries. |
| name | string | required | Required sheet name owned by this open-id grant. |
| passive | Effect[] | default [] | Persistent effects contributed while this grant is reached. Only effects with a passive reader are accepted by validation. |
| recharge | FeatureRecharge[] | optional | Generic resource refresh rules owned by this grant. |
| trigger | FeatureTrigger | optional | A combat reaction, rider, aura, or boundary grant declared by this feature. |
| uses | integer | optional | Base uses per rest from this level. A level-up resource row may instead derive or ladder the capacity. Absent means the grant has no own count. |
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 | int64 | required | Value from this level until the next step. |
FeatureRecharge
One generic recharge rule carried by a class-feature grant.
| Field | Type | Required | Description |
|---|---|---|---|
| amount | FeatureRechargeAmount | required | Whether the boundary restores all uses or a positive fixed count. |
| cadence | FeatureRechargeCadence | required | The boundary that performs this refresh. |
| countdown | RestCountdown | optional | Optional multi-rest cooldown sampled when this recovery rule fires. |
| ledger | FeatureRechargeLedger | required | The existing resource ledger refreshed at the boundary. |
FeatureRechargeAmount
How much of a feature-owned ledger one recharge boundary restores.
All
Restore the ledger completely.
Count
Restore at most count spent uses.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint32 | required | The positive number of uses restored at this boundary. |
ClassLevelDivisor
Restore one unit per divisor granting-class levels, rounded down.
| Field | Type | Required | Description |
|---|---|---|---|
| divisor | uint32 | required | Positive class-level divisor used to derive the restored amount. |
FeatureRechargeCadence
When a feature-owned ledger refreshes.
ShortRest
Refresh when a short rest completes; a long rest also refreshes it.
LongRest
Refresh only when a long rest completes.
Dawn
Refresh at the world's dawn boundary.
FeatureRechargeLedger
The existing resource store refreshed by a feature row.
GrantUses
The grant's own id in the per-rest feature-use ledger.
Pool
A data-authored point pool shared by compatible feature actions.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | required | The nonempty id of the pool to refresh. |
Uses
A data-authored use counter shared by compatible feature actions.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | required | The nonempty id of the use counter to refresh. |
FeatureResourceLedger
A resource ledger address used by generic exchanges and minimum restores.
Pool
A data-authored point pool.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | required |
Uses
A data-authored use counter.
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | required |
SpellSlots
The ordinary level-indexed spell-slot ledger.
FeatureTrigger
One data-authored class-feature trigger.
| Field | Type | Required | Description |
|---|---|---|---|
| at | FeatureTriggerBoundary | required | The one typed combat boundary which raises this row. |
| economy | FeatureActionEconomy | optional | Optional turn resource paid when the trigger is accepted. At TurnStart, Some(Free) offers an activation or decline before ordinary turn effects. |
| effects | Effect[] | required | Ordered consequences from the shared |
| ledger | FeatureActionLedger | optional | Optional existing ledger charged by the trigger. A paid TurnStart activation names Pool; its effects carry the cost in that pool. |
| when | FeatureTriggerCondition[] | default [] | Every condition must hold. Empty means the boundary alone is enough. |
FeatureTriggerBoundary
The combat boundary at which a feature trigger is considered.
Initiative
Initiative is being rolled for one combatant.
AfterInitiative
Immediately after every combatant's Initiative has been established.
TurnStart
The start of the feature bearer's turn.
FailedSave
A saving throw has failed.
Roll
A d20 roll has resolved.
Hit
An attack has landed.
WeaponDamageRoll
The base weapon-damage dice of a landed hit, before riders are added.
RageStart
The feature bearer has begun a Rage.
Cast
A spell has been cast.
Heal
Hit points have been restored.
Condition
A condition has been applied or evaluated.
TurnEnd
The end of the feature bearer's turn.
FeatureTriggerCondition
A closed predicate evaluated from the packet raised at a trigger boundary.
SelfActor
The creature acting at the boundary is this feature's bearer.
AllyWithin
An ally of the bearer, or the bearer, stands within radius_ft feet of the bearer when the boundary is raised.
| Field | Type | Required | Description |
|---|---|---|---|
| radius_ft | uint32 | required |
FailedSave
The saving throw rolled at the boundary failed.
HitLanded
The attack resolved at the boundary hit its target.
CastOfSchool
The spell cast at the boundary belongs to the named school (for example "evocation").
| Field | Type | Required | Description |
|---|---|---|---|
| school | string | required |
Heal
The boundary applies healing.
RageStarted
The boundary is the bearer's rage beginning.
TargetHasNotTakenTurn
The creature the boundary targets hasn't taken a turn yet in the current combat: its first turn in the fight has not begun.
FeatureValue
A numeric input a feature effect derives from the granting creature.
Flat
The authored constant.
Carries int64.
ClassLevel
The level of the class whose reached grant supplied the action.
AbilityModifier
The actor's modifier for the named ability.
Carries Ability.
ProficiencyBonus
The actor's proficiency bonus.
AbilityModifierPlusProficiency
The actor's modifier for the named ability plus its proficiency bonus.
Carries Ability.
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. |
FormCapabilityPolicy
Which ordinary capabilities the replacement body carries.
RetainMentalAndClassUseFormPhysical
Retain mental and class capabilities while using form physical traits.
FormOnly
Use only the replacement form's capabilities.
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. |
FormEquipmentDisposition
One authored disposition available for worn or carried equipment.
WearIfFits
Retain equipment the new body can wear.
Drop
Drop equipment in the bearer's current space.
Merge
Merge equipment into the form and suppress its use until reversion.
FormEquipmentPolicy
Equipment handling for a replacement form.
Choose
Offer exactly the listed distinct dispositions.
Carries FormEquipmentDisposition[].
Fixed
Apply one disposition without a pending choice.
Carries FormEquipmentDisposition.
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. |
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. |
FormProficiencyPolicy
Arbitration used when both the bearer and form supply a proficiency.
HigherOfOriginalOrForm
Use the greater of the original and form bonuses.
Form
Use only the form's authored bonus.
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. |
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. |
LevelLadder
A positive value with strictly increasing granting-class-level steps.
| Field | Type | Required | Description |
|---|---|---|---|
| by_level | [uint32, uint32][] | default [] |
|
| count | uint32 | required | Value before the first reached step. |
LevelUpEffect
A generic character-growth operation contributed by a feature grant.
AbilityPoints
Offer ability-score points under the ordinary score cap.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint32 | required | The positive number of points offered by this row. |
FightingStyle
Offer one selection from the authored fighting-style grant ids.
| Field | Type | Required | Description |
|---|---|---|---|
| from | string[] | required | The nonempty feature ids eligible for the selection. |
SkillExpertise
Double proficiency in eligible trained skills.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint32 | required | The positive number of skill proficiencies to double. |
TrainingPackage
Select one authored bundle of armor, weapon, cantrip, and skill training.
| Field | Type | Required | Description |
|---|---|---|---|
| options | TrainingPackageOption[] | required | Nonempty packages with distinct open ids; the growth choice selects one. |
LanguageTraining
Add languages when this growth row is reached.
| Field | Type | Required | Description |
|---|---|---|---|
| count | uint32 | required | Positive number of languages selected. |
| from | string[] | default [] | Optional authored language ids to choose from. Empty permits any language in the loaded language table. |
ChoiceCapacity
Define capacity for one authored choice group by class level.
| Field | Type | Required | Description |
|---|---|---|---|
| group | string | required | Nonempty open id shared by the choices whose capacity this controls. |
| ladder | [uint32, uint32][] | required | Strictly increasing |
SpellcastingResource
Define a level-scaled capacity for an authored spellcasting resource.
| Field | Type | Required | Description |
|---|---|---|---|
| kind | string | required | The nonempty generic resource kind, such as slots or pact slots. |
| ladder | [uint32, uint32][] | required | Strictly increasing |
SpellPreparationRule
Define how many spells the class may prepare by class level.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | The ability used by the preparation rule. |
| ladder | [uint32, uint32][] | required | Strictly increasing |
ResourceCapacity
Define a level-scaled capacity for a feature action's existing ledger.
| Field | Type | Required | Description |
|---|---|---|---|
| ladder | [uint32, uint32][] | required | Strictly increasing |
| ledger | FeatureActionLedger | required | The ledger whose capacity this row supplies. |
ClassLevelResource
Derive an existing resource capacity from the granting class level.
| Field | Type | Required | Description |
|---|---|---|---|
| ledger | FeatureActionLedger | required | The ledger whose capacity this row supplies. |
| minimum | uint32 | required | The minimum capacity after the grant is reached. |
| multiplier | uint32 | required | Capacity gained per granting class level. |
AbilityResourceCapacity
Derive an existing resource capacity from an ability modifier.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | The ability modifier used for the capacity. |
| ledger | FeatureActionLedger | required | The ledger whose capacity this row supplies. |
| minimum | uint32 | required | The minimum capacity after the grant is reached. |
ResourceValue
Derive an existing resource capacity from a generic feature value.
| Field | Type | Required | Description |
|---|---|---|---|
| ledger | FeatureActionLedger | required | The ledger whose capacity this row supplies. |
| value | FeatureValue | required | The bearer-derived value, clamped to zero. |
SavingThrowProficiency
Grant proficiency in the listed saving-throw abilities once reached.
| Field | Type | Required | Description |
|---|---|---|---|
| abilities | Ability[] | required | Nonempty list of saving-throw abilities granted by this row. |
PreparedSpells
Keep the listed spells prepared once their class-level rung is reached.
| Field | Type | Required | Description |
|---|---|---|---|
| ladder | [uint32, string[]][] | required | Strictly increasing |
ModHook
Where a passive modifier lands — the closed hook set: one variant per NUMBER the engine already reads. A hook without a consumer stays out (ledger-don't-fake): attack/damage hooks arrive with the kit's weapon-identity read so the skirmish and the bubble apply them alike; save/check/heal hooks with theirs.
Ac
Armor class — the shared fighter build and the sheet (one derivation).
CritRange
The critical floor drops by amount (Improved Critical's 1 → 19-20).
CritDice
Extra weapon damage dice on a critical hit (Savage Attacks' shape).
Speed
Foot-speed in FEET: the Barbarian's Fast Movement and the Monk's Unarmored Movement, gated by their own ModWhen at the bubble's move budget (the combat consumer; the travel-speed read is ledgered — sim-neutral, no worldgen soul takes these classes).
Initiative
Initiative rolls made when combat opens.
ModWhen
When a modifier applies.
Always
The modifier always applies (the default).
Armored
Only while wearing body armor (the Defense style's clause).
Unarmored
Only while wearing NO body armor: the barbarian/monk's speed bonuses, the inverse of [ModWhen::Armored].
NotHeavyArmor
Only while not wearing Heavy body armor: the 2024 Barbarian's Fast Movement clause. Medium and Light armor still receive the bonus.
Modifier
One passive adjustment: amount onto hook while when holds — the data half of a feature's mechanics. Registry features may carry their mechanics here (Defense, Improved Critical do); an OPEN-id grant (a mod's own passive) must.
| Field | Type | Required | Description |
|---|---|---|---|
| amount | int64 | required | The signed amount added onto |
| hook | ModHook | required | Where the adjustment lands. |
| value | FeatureValue | optional | Optional value derived from the bearer. When present, this replaces |
| when | ModWhen | optional | The clause under which it applies (default Always). |
MonsterIllumination
Authorable MonsterIllumination data exposed through the modding schema.
| Field | Type | Required | Description |
|---|---|---|---|
| bright_ft | uint32 | required | Authored bright ft. |
| dim_ft | uint32 | required | Authored dim ft. |
MonsterMultiattackStep
One ordered component of a monster's authored Multiattack action. Keeping attack rolls and saving-throw actions distinct prevents mixed stat blocks from being approximated as repeated attacks.
Attack
Select the attack behavior.
Carries string.
SaveAction
Select the save action behavior.
Carries string.
AttackOrSaveAction
At this sequence position the creature chooses either the named attack roll or the named save action (for example, Lion Rend or Roar).
| Field | Type | Required | Description |
|---|---|---|---|
| attack | string | required | |
| save_action | string | required |
MountTraining
Annotation describing a creature's authored mount training. The engine does not currently read this value or implement riding rules.
Independent
Annotate the creature as independently trained.
Controlled
Annotate the creature as trained for rider control.
MovementMode
Authorable MovementMode data exposed through the modding schema.
Walk
Select the walk behavior.
Climb
Select the climb behavior.
Swim
Select the swim behavior.
Fly
Select the fly behavior.
Burrow
Select the burrow behavior.
MovementSurface
A combat surface that ordinary walking does not otherwise permit.
Vertical
A vertical wall or similar upright surface.
Liquid
A liquid surface that would ordinarily require swimming.
NaturalAttack
One natural attack off a monster's stat block: a bite, claw, or slam the creature IS armed with — not a borrowed weapon. PRIMITIVES only: to-hit and the damage average DERIVE (pb_for_cr + the governing ability's mod), exactly as a humanoid's weapon line does. The ability names which mod feeds both (Str for a slam, Dex for a wolf's quick bite — the finesse rule made explicit for the raceless). reach_ft is the melee reach (5 ft on the grid = one square; a longer reach is ledgered); a ranged natural attack carries range (none in the starter bestiary — the substrate for a manticore's spikes, ledgered).
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | The ability whose mod feeds to-hit and damage (Str, or Dex for a finesse-like bite). |
| advantage_if_self_bloodied | boolean | default false | Advantage while the attacker itself is Bloodied (for example, Bloodied Fury). |
| advantage_if_target_bloodied | boolean | default false | Authored advantage if target bloodied. |
| advantage_if_target_wounded | boolean | default false | Advantage when the target has fewer than all of its Hit Points. |
| charge | NaturalAttackCharge | optional | Extra on-hit payload after a straight run toward the target. |
| damage | Damage | required | The attack's damage dice and kind. |
| damage_flat | integer | optional | Printed flat damage modifier when it differs from the attack ability modifier. Absent keeps the ordinary derived modifier. |
| damage_if_self_bloodied | Damage | optional | Replacement damage dice and kind when the attacker itself is Bloodied. Swarms use this to reduce their attack damage as their members fall. |
| damage_if_target_bloodied | Damage | optional | Replacement damage dice and kind when the target is Bloodied. The ordinary flat modifier remains unchanged unless |
| forbid_target_grappled_by_self | boolean | default false | This attack cannot target a creature currently grappled by its source. |
| name | string | required | Authored name. |
| on_hit | NaturalAttackOnHit[] | default [] | Typed mechanics that resolve only after this particular attack hits. Keeping them on the attack (rather than the creature body) preserves identity when a stat block has, for example, a plain Bite and a condition-bearing Tail. |
| range | Range | optional | Ranged natural-attack range; absent = melee only. |
| reach_ft | uint32 | required | Melee reach in feet (5 ft = one grid square). |
| recharge_low | uint8 | default 0 | The LOW d6 face that restores this attack at turn start (6 = "Recharge 6"). Zero means the attack is always available. |
NaturalAttackCharge
Authorable NaturalAttackCharge data exposed through the modding schema.
| Field | Type | Required | Description |
|---|---|---|---|
| condition | string | optional | Authored condition. |
| damage | Damage | required | Authored damage. |
| followup_attack | string | optional | A named natural attack made immediately after this charge attack hits. |
| max_target_size | Size | required | Authored max target size. |
| minimum_straight_ft | uint32 | required | Authored minimum straight ft. |
| replace_base_damage | boolean | default false | The charge payload replaces the ordinary hit damage instead of adding to it (the 2024 Goat's flat 1 becomes 1d4 after its run). |
NaturalAttackConditionDuration
The exact turn boundary that removes a natural-attack condition rider. Persistent retains the ordinary condition lifecycle (stand, escape, cleanse, and so on); the timed variants model printed monster clauses.
Persistent
Select the persistent behavior.
UntilSourceNextTurnStart
Select the until source next turn start behavior.
UntilSourceNextTurnEnd
Select the until source next turn end behavior.
UntilTargetNextTurnEnd
Select the until target next turn end behavior.
NaturalAttackOnHit
Authorable NaturalAttackOnHit data exposed through the modding schema.
Condition
Apply a condition when the target is no larger than max_target_size. save: None is the 2024 monster wording "the target has the condition"; an authored save branches through the ordinary saving-throw machinery.
| Field | Type | Required | Description |
|---|---|---|---|
| condition | string | required | |
| duration | NaturalAttackConditionDuration | default "Persistent" | |
| max_target_size | Size | optional | |
| save | NaturalAttackSave | optional |
Grapple
Select the grapple behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| escape_dc | int64 | required | |
| max_target_size | Size | required | |
| max_targets | integer | optional | Maximum creatures this attack's anatomy can hold at once. Absent means the stat block states no additional capacity limit. |
| pull_ft | uint32 | default 0 | Pull the newly grappled target straight toward the attacker. |
| restrained | boolean | default false |
Damage
Select the damage behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| condition_duration_secs | integer | optional | Absolute-world duration for the failed-save condition. Absent uses the condition's ordinary persistent lifecycle. |
| condition_on_failed_save | string | optional | |
| damage | Damage | required | |
| doubles_on_crit | boolean | default false | Whether these dice are part of the attack's critical damage roll. Monster poison/save riders default false; magic weapon damage such as Frost Brand authors true. |
| on_save | OnSave | optional | |
| save | NaturalAttackSave | optional |
NaturalAttackSave
Authorable NaturalAttackSave data exposed through the modding schema.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | Authored ability. |
| dc | int64 | required | Authored dc. |
OnSave
What a failed save spares (SRD: "half as much damage on a successful one").
Half
Select the half behavior.
Nothing
Select the nothing behavior.
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.
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 |
PersistentReactivation
Authorable PersistentReactivation data exposed through the modding schema.
Action
Select the action behavior.
BonusAction
Select the bonus action behavior.
Movement
Select the movement behavior.
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.
TeleportSelf
Select the teleport self behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| max_ft | uint32 | required |
RepeatDamage
Select the repeat damage behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required | |
| kind | string | required |
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_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. |
PrivilegedCastMode
One legal profile for a class-granted cast.
Base
Preserve the referenced spell's authored profile.
Override
Apply bounded existing cast transformations and summon augmentation before the ordinary cast compiler sees the spell.
| Field | Type | Required | Description |
|---|---|---|---|
| transformations | CastTransformation[] | required |
PrivilegedCastPayment
The legal payment alternatives for one class-granted cast.
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 |
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. |
| payment | PrivilegedCastPayment | required | Authored alternatives for paying the cast. |
| summon | SummonAugmentation | optional | Summon-only declaration data shared by every legal lifetime mode. |
Range
Weapon-range band in feet.
| Field | Type | Required | Description |
|---|---|---|---|
| long | uint32 | required | Long range in feet — an attack beyond |
| normal | uint32 | required | Normal range in feet — no penalty within it. |
ReactionDefensePayload
Content-authored pre-resolution defense or cancellation. The event window determines when it may be offered; identity never participates in dispatch.
TimedAc
Select the timed ac behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| bonus | int64 | required | |
| rounds | uint32 | required |
DamageReduction
Select the damage reduction behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required | |
| modifier | int64 | required |
CancelPendingCast
Select the cancel pending cast behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| check | CancellationCheck | required |
CancelOngoingEffect
Select the cancel ongoing effect behavior.
| Field | Type | Required | Description |
|---|---|---|---|
| check | CancellationCheck | required |
RepeatSaveGate
Authorable RepeatSaveGate data exposed through the modding schema.
Always
Select the always behavior.
SourceNotVisible
Select the source not visible behavior.
RepeatSaveRule
Authorable RepeatSaveRule data exposed through the modding schema.
| Field | Type | Required | Description |
|---|---|---|---|
| boundary | TurnBoundary | required | Authored boundary. |
| gate | RepeatSaveGate | required | Authored gate. |
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. |
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. |
RestCountdown
A positive dice expression sampled when a recovered feature begins a multi-rest cooldown. The persisted counter falls once per completed rest.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required | Positive dice expression whose total is the initial rest count. |
RiderExchangeBudget
The resource surrendered atomically when accepting authored hit riders.
DamageDice
Remove this many dice from the parent damage roll.
Advantage
Forgo Advantage on the parent attack.
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. |
SaveAdvantageScope
One context in which a feature grants saving-throw advantage.
MagicAbilities
A magical effect using one of the listed saving-throw abilities.
| Field | Type | Required | Description |
|---|---|---|---|
| abilities | Ability[] | required | Nonempty abilities eligible for the advantage. |
Poison
A poison damage or poison-effect saving throw.
Fear
A saving throw against becoming frightened.
Charm
A saving throw against becoming charmed.
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).
Tiny
Select the tiny behavior.
Small
Select the small behavior.
Medium
Select the medium behavior.
Large
Select the large behavior.
Huge
Select the huge behavior.
Gargantuan
Select the gargantuan behavior.
Skill
An open, validated Skill id interned from authored data.
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 |
| 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. |
Source
Every file's top-level value carries source.
Srd51
SRD 5.1 — retained nonconflicting catalogue material.
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.
Original
Original content authored for this game (not from the SRD).
Phb2024
Material transcribed from the 2024 Player's Handbook. This source is not redistributable by this project and belongs in a phb2024 mod.
Dmg2024
Material transcribed from the 2024 Dungeon Master's Guide. This source is not redistributable by this project and belongs in a dmg2024 mod.
Mm2024
Material transcribed from the 2024 Monster Manual. This source is not redistributable by this project and belongs in an mm2024 mod.
Tce
Material transcribed from Tasha's Cauldron of Everything. This source is not redistributable by this project and belongs in a tce mod.
Xge
Material transcribed from Xanathar's Guide to Everything. This source is not redistributable by this project and belongs in an xge mod.
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. |
SpellRange
A spell's range. Caster is the SRD's "Self" (a Rust-reserved word).
Touch
Touch — the caster must reach the target (SRD "Touch").
Feet
A ranged spell out to this many feet.
Carries uint32.
Caster
Self — the spell affects only the caster (SRD "Self").
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. |
SummonChoiceBinding
Bind an authored choice carried by the generated summon body.
SelectedDamageKind
Select one kind from the joined body's authored DamageTypeChoice.
SummonGrantLifetime
The lifetime of a source-linked summon grant.
SameSummon
The grant exists exactly while its joined source body exists.
SummonGrantParticipant
A participant in a source-linked summon grant.
Caster
The creature that invoked the cast privilege.
JoinedBody
The generated body written by the ordinary summon transition.
SummonLinkedEffect
An existing persistent effect installed when a generated body joins.
SelectedDamageKindResistance
Resistance to the kind selected through choice_binding.
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. |
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. |
| selected_variant | uint8 | default 0 | Cast-selected ordinal, zero for the first authored variant. |
| strikes_divisor | uint32 | required | Authored strikes divisor. |
| variants | SummonVariant[] | default [] | Closed authored stat-block choices offered by the cast action. |
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 |
| 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 |
| hp_base | int64 | required | Authored hp base. |
| id | string | required | Authored id. |
TrainingPackageOption
One selectable bundle of proficiencies and spell/skill training.
| Field | Type | Required | Description |
|---|---|---|---|
| ability_to_skills | array | optional | Ability added to checks using these skills while the option is active. |
| armor | ArmorCategory[] | default [] | Armor categories added by this option. |
| cantrips | uint32 | default 0 | Additional cantrips the option permits the bearer to select. |
| id | string | required | Open authored option id, unique inside its package row. |
| weapons | WeaponTraining | optional | Weapon categories and individual weapon ids added by this option. |
TriggeredZoneOutcome
The consequence of entering or starting a turn in a triggered area.
Heal
Restore hit points; the upcast-adjusted dice are baked at cast time.
| Field | Type | Required | Description |
|---|---|---|---|
| dice | string | required |
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 |
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 |
TriggeredZoneShape
Grid footprint used by a triggered spell area.
Sphere
A radius measured with the board's square-grid distance.
Cube
A cube whose authored width is radius_ft * 2 on this centered grid.
TriggeredZoneUses
A finite zone-use ledger derived once when the spell is cast.
AbilityModifierPlus
plus + ability modifier, clamped to at least minimum uses.
| Field | Type | Required | Description |
|---|---|---|---|
| ability | Ability | required | |
| minimum | uint32 | required | |
| plus | int32 | required |
TurnBoundary
Authorable TurnBoundary data exposed through the modding schema.
Start
Select the start behavior.
End
Select the end behavior.
WeaponCategory
The four SRD weapon categories (simple/martial × melee/ranged) — proficiency gates on this.
SimpleMelee
Select the simple melee behavior.
SimpleRanged
Select the simple ranged behavior.
MartialMelee
Select the martial melee behavior.
MartialRanged
Select the martial ranged behavior.
WeaponPredicate
One generic weapon predicate in a feature fact.
A weapon matches when its category is listed, every required property is present, and every forbidden property is absent.
| Field | Type | Required | Description |
|---|---|---|---|
| categories | WeaponCategory[] | required | Nonempty weapon categories eligible for this alternative. |
| forbidden_properties | WeaponProperty[] | optional | Properties no eligible weapon may carry; empty means no exclusion. |
| required_properties | WeaponProperty[] | optional | Properties all eligible weapons must carry; empty means no requirement. |
WeaponProperty
An SRD weapon property (finesse, heavy, thrown, …) — a tag that bends how a weapon is wielded or rolled.
Ammunition
Fires ammunition within the given [Range] (bows, crossbows, slings).
Carries Range.
Finesse
May use Dexterity instead of Strength for attack and damage rolls.
Heavy
Small creatures attack with disadvantage (too large to wield well).
Light
Light enough for two-weapon fighting (the off-hand bonus attack).
Loading
Only one shot per action, however many attacks the wielder has.
Reach
Adds 5 ft to the wielder's reach for attacks and opportunity attacks.
Special
Carries special rules given in the weapon's own text (SRD "Special").
Thrown
May be thrown for a ranged attack within the given [Range].
Carries Range.
TwoHanded
Requires two hands to wield.
Versatile
May be wielded one- or two-handed; the two-handed damage die is the given NdM string.
Carries string.
WeaponTraining
Weapon training: the category flags plus any named ids (the rogue's hand-crossbow/longsword/rapier/shortsword list).
| Field | Type | Required | Description |
|---|---|---|---|
| ids | string[] | required | Extra individual weapon ids trained (the rogue's rapier/shortsword list). |
| martial | boolean | required | True = trained in all martial weapons. |
| simple | boolean | required | True = trained in all simple weapons. |