Skip to main content
Glama

Embers: Tabletop RPG Toolkit

Create a vault item

vault_create_item

Create a new user-authored item of any of the ruleset's item types. Vault validates ruleset-specific fields (damage, properties, equip slots, weight); send them via the passthrough schema. The new item is owned by the calling user.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "type": "<type>"
    },
    "name": "vault_create_item"
  }
}

Input Schema

NameRequiredDescriptionDefault
oglNo
costNoCost in gold pieces (max 2 decimal places). Vault enforces non-negativity and precision.
nameYesDisplay name. Required.
typeYesItem type. Required.
usesNo
imageNo
activeNo
damageNo
effectNo
groupsNoFurther "one kind of" group items this item belongs to beside its `_parent` (a longsword in both Martial Weapon and Martial Melee Weapon). A starting-equipment entry naming a group offers every item naming it as `_parent` or in `groups`.
sourceNo
weightNo
_parentNoParent item ObjectId for variant items.
healingNo
masteryNoWeapon mastery name, for rulesets whose weapons carry one, as the ruleset's catalog names it.
rulesetNoRuleset code, from list_rulesets.
summaryNoShort one-line summary.
durationNo
rollModsNo
publisherNo
spellSwapNoKnown-spell swap: on gaining a level in this rule's class the character may replace up to `count` of the spells this rule's spellChoices gave it with others they allow. Absent = no swap. The rule authoring guide's spellSwap section has the shape.
actionTypeNoAuthoring hint — when set, the character sheet's rule modal shows an 'Add to Actions' button that mints an action row with this `type`.
armorClassNoBase AC value the armor provides.
damageDiceNoThe weapon's damage. A ruleset that writes damage as one line (the ruleset's monster authoring guide says so, and it holds for that ruleset's items and Character actions too: vault_get_authoring_guide, with the code from list_rulesets) writes it here, parts joined by '+', each an amount then its damage types: '1d8 slashing', '1d8 slashing + 2d6 fire', '1d6 piercing or slashing' (one roll that may be either type); a plain '1d8' with the type in `damageType` is also read. A Versatile weapon's two-handed die goes on its Versatile property, not here. Other rulesets: the base damage expression (e.g. '1d8'). The app files a line it can express as a plain dice value and type that way, so a read-back may differ in form from what you sent while meaning the same damage.
damageTypeNoDamage types as an array of strings (most items have one type; some have multiples), for a plain dice value.
diceFloorsNo
equipSlotsNoAllowed equip slot ids, from the ruleset's own slots (an existing item's equipSlots, via vault_get_item, shows them).
parametersNo
propertiesNo
ruleChoiceNo
weaponTypeNoWeapon category, as the ruleset's catalog names it (vault_search_items shows them).
descriptionNoFull item description. Markdown is supported.
extraDamageNo
resistancesNo
statBonusesNo
mechanicsKeyNo
spellChoicesNoSpells this rule grants or lets the player choose, as independent blocks. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list.
armorCategoryNoArmor category, as the ruleset's catalog names it (vault_search_items shows them).
prerequisitesNo
forcedMovementNo
maxDexModifierNoCap on the DEX bonus this armor allows, from the item's source text.
preparedSpellsNo
abilityScoreSetNo
damageReductionNo
recurringDamageNo
abilityScoreBumpNo
diceReplacementsNo
spellListChoicesNoSpell-list choices (the Magic Initiate shape): the player picks one list, then spells from it. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list. On a Feat, vault refuses an update whose choices would no longer all offer a list that a background names as its `featSpellList`, or that moves the feat to another ruleset while one does. Only backgrounds in the feat's ruleset whose owners can use the feat count (stock, their own, or a house rule of their campaign, active or not).
expandedSpellListNoSpells this rule adds to a class's spell list for a character who holds it (a Warlock patron's Expanded Spell List): `list` is the list's name as spell choices filter by it (their allowedCategories, e.g. "Warlock"), `spells` the added spells' ids. Every filter spellChoices block naming the list then offers them within its own levels and schools. Absent = adds nothing.
prerequisitesLogicNo
proficiencyChoicesNoProficiencies this rule grants or lets the player choose. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list.
stealthDisadvantageNo
strengthRequirementNo

Output Schema

NameRequiredDescriptionDefault
_idNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / damageDice / description
      Previous value: -"Base damage expression (e.g. '1d8')."New value: +"The weapon's damage. A ruleset that writes damage as one line (the ruleset's monster authoring guide says so, and it holds for that ruleset's items and Character actions too: vault_get_authoring_guide, with the code from list_rulesets) writes it here, parts joined by '+', each an amount then its damage types: '1d8 slashing', '1d8 slashing + 2d6 fire', '1d6 piercing or slashing' (one roll that may be either type); a plain '1d8' with the type in `damageType` is also read. A Versatile weapon's two-handed die goes on its Versatile property, not here. Other rulesets: the base damage expression (e.g. '1d8'). The app files a line it can express as a plain dice value and type that way, so a read-back may differ in form from what you sent while meaning the same damage."
    • changedInput schema / properties / damageType / description
      Previous value: -"Damage types as an array of strings (most items have one type; some have multiples)."New value: +"Damage types as an array of strings (most items have one type; some have multiples), for a plain dice value."
  2. Changed6 schema fields changed
    • changedInput schema / properties / prerequisites / items / properties / type / enum
      Previous value: -[
      -  "level",
      -  "abilityScore",
      -  "rule",
      -  "spell",
      -  "proficiency",
      -  "spellcasting"
      -]New value: +[
      +  "level",
      +  "abilityScore",
      +  "rule",
      +  "spell",
      +  "proficiency",
      +  "spellcasting",
      +  "spellcastingFeature"
      +]
    • addedInput schema / properties / proficiencyChoices / description
      Added value: +"Proficiencies this rule grants or lets the player choose. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list."
    • addedInput schema / properties / ruleChoice / properties / allowedRules / description
      Added value: +"The rules a 'specific' choice offers. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most one choice may name; vault refuses a longer list."
    • addedInput schema / properties / spellChoices / description
      Added value: +"Spells this rule grants or lets the player choose, as independent blocks. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list."
    • changedInput schema / properties / spellListChoices / description
      Previous value: -"Spell-list choices (the Magic Initiate shape): the player picks one list, then spells from it. On a Feat, vault refuses an update whose choices would no longer all offer a list that a background names as its `featSpellList`, or that moves the feat to another ruleset while one does. Only backgrounds in the feat's ruleset whose owners can use the feat count (stock, their own, or a house rule of their campaign, active or not)."New value: +"Spell-list choices (the Magic Initiate shape): the player picks one list, then spells from it. The rule authoring guide (vault_get_authoring_guide, entityType 'rule') gives the most blocks one rule may carry; vault refuses a longer list. On a Feat, vault refuses an update whose choices would no longer all offer a list that a background names as its `featSpellList`, or that moves the feat to another ruleset while one does. Only backgrounds in the feat's ruleset whose owners can use the feat count (stock, their own, or a house rule of their campaign, active or not)."
    • addedInput schema / properties / spellListChoices / items / properties / picks / description
      Added value: +"The picks made from the chosen list. The rule authoring guide gives the most picks one block, and the most blocks one rule, may carry; vault refuses a longer list."
  3. Changed1 schema field changed
    • addedInput schema / properties / prerequisites / items / properties / pactMagic
      Added value: +{
      +  "description": "For spellcastingFeature: true accepts a Pact Magic feature as well as a Spellcasting feature; absent requires a Spellcasting feature.",
      +  "type": "boolean"
      +}
  4. Changed8 schema fields changed
    • addedInput schema / properties / damage / properties / autoHit
      Added value: +{
      +  "description": "True when the damage hits automatically with no attack roll and no save (Magic Missile). Absent = damage without a save rolls an attack. Ignored when the block has a save.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / expandedSpellList
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Spells this rule adds to a class's spell list for a character who holds it (a Warlock patron's Expanded Spell List): `list` is the list's name as spell choices filter by it (their allowedCategories, e.g. \"Warlock\"), `spells` the added spells' ids. Every filter spellChoices block naming the list then offers them within its own levels and schools. Absent = adds nothing.",
      +  "properties": {
      +    "list": {
      +      "type": "string"
      +    },
      +    "spells": {
      +      "items": {
      +        "description": "Mongo `_id` reference (24-character hex string).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / groups
      Added value: +{
      +  "description": "Further \"one kind of\" group items this item belongs to beside its `_parent` (a longsword in both Martial Weapon and Martial Melee Weapon). A starting-equipment entry naming a group offers every item naming it as `_parent` or in `groups`.",
      +  "items": {
      +    "description": "Mongo `_id` reference (24-character hex string).",
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / preparedSpells / properties / countSource
      Added value: +{
      +  "description": "Where the prepared count comes from. Absent means fixed: the count and progression below. Otherwise the count comes from the character: the casting ability modifier plus the class level, or plus half the class level rounded down, never less than 1.",
      +  "enum": [
      +    "fixed",
      +    "castingModPlusLevel",
      +    "castingModPlusHalfLevel"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / spellChoices / items / properties / wholeList
      Added value: +{
      +  "description": "When true, the block gives every spell its filters allow at the levels the character has spell slots for, with nothing to pick (a caster that prepares from its whole class list). count and progression are not read. Absent means the player picks count.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / spellSwap
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Known-spell swap: on gaining a level in this rule's class the character may replace up to `count` of the spells this rule's spellChoices gave it with others they allow. Absent = no swap. The rule authoring guide's spellSwap section has the shape.",
      +  "properties": {
      +    "count": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / uses / items / properties / progression / items / properties / countBonus
      Added value: +{
      +  "description": "Added to a derived count (proficiency or abilityMod), for example 1 for '1 + your Charisma modifier'.",
      +  "type": "number"
      +}
    • addedInput schema / properties / uses / items / properties / progression / items / properties / countMin
      Added value: +{
      +  "description": "Floor for a derived count (proficiency or abilityMod): the result is never less than this, for example 1 for 'a minimum of once'.",
      +  "minimum": 0,
      +  "type": "number"
      +}
  5. Changed6 schema fields changed
    • addedInput schema / properties / extraDamage
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "appliesTo": {
      +        "enum": [
      +          "melee",
      +          "ranged",
      +          "either"
      +        ],
      +        "type": "string"
      +      },
      +      "area": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "shape": {
      +              "enum": [
      +                "cone",
      +                "line",
      +                "sphere",
      +                "cube",
      +                "cylinder",
      +                "emanation",
      +                "radius"
      +              ],
      +              "type": "string"
      +            },
      +            "size": {
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "width": {
      +              "minimum": 0,
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "dice": {
      +        "type": "string"
      +      },
      +      "flat": {
      +        "type": "number"
      +      },
      +      "modifierAbility": {
      +        "enum": [
      +          "strength",
      +          "dexterity",
      +          "constitution",
      +          "intelligence",
      +          "wisdom",
      +          "charisma"
      +        ],
      +        "type": "string"
      +      },
      +      "modifierType": {
      +        "enum": [
      +          "flat",
      +          "proficiency",
      +          "ability"
      +        ],
      +        "type": "string"
      +      },
      +      "onSave": {
      +        "enum": [
      +          "half",
      +          "negates",
      +          "full"
      +        ],
      +        "type": "string"
      +      },
      +      "progression": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "dice": {
      +              "type": "string"
      +            },
      +            "flat": {
      +              "type": "number"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "save": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "ability": {
      +            "enum": [
      +              "none",
      +              "spellcasting",
      +              "attackAttribute",
      +              "strength",
      +              "dexterity",
      +              "constitution",
      +              "intelligence",
      +              "wisdom",
      +              "charisma"
      +            ],
      +            "type": "string"
      +          },
      +          "dcBase": {
      +            "type": "number"
      +          },
      +          "includesProficiency": {
      +            "type": "boolean"
      +          },
      +          "saveType": {
      +            "enum": [
      +              "strength",
      +              "dexterity",
      +              "constitution",
      +              "intelligence",
      +              "wisdom",
      +              "charisma"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "scaling": {
      +        "enum": [
      +          "fixed",
      +          "byLevel",
      +          "spellSlot"
      +        ],
      +        "type": "string"
      +      },
      +      "scalingAttribute": {
      +        "type": "string"
      +      },
      +      "slotIncrement": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "dice": {
      +            "type": "string"
      +          },
      +          "flat": {
      +            "type": "number"
      +          },
      +          "targets": {
      +            "maximum": 9007199254740991,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "targets": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "count": {
      +            "maximum": 9007199254740991,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "trigger": {
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      },
      +      "types": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / recurringDamage / items / properties / amount / properties / progression
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "dice": {
      +        "type": "string"
      +      },
      +      "flat": {
      +        "type": "number"
      +      },
      +      "level": {
      +        "maximum": 20,
      +        "minimum": 1,
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / recurringDamage / items / properties / amount / properties / scaling
      Added value: +{
      +  "enum": [
      +    "fixed",
      +    "byLevel",
      +    "spellSlot"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / recurringDamage / items / properties / amount / properties / slotIncrement
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "dice": {
      +      "type": "string"
      +    },
      +    "flat": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / recurringDamage / items / properties / onSave
      Added value: +{
      +  "enum": [
      +    "half",
      +    "negates",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / recurringDamage / items / properties / save
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "ability": {
      +      "enum": [
      +        "none",
      +        "spellcasting",
      +        "attackAttribute",
      +        "strength",
      +        "dexterity",
      +        "constitution",
      +        "intelligence",
      +        "wisdom",
      +        "charisma"
      +      ],
      +      "type": "string"
      +    },
      +    "dcBase": {
      +      "type": "number"
      +    },
      +    "includesProficiency": {
      +      "type": "boolean"
      +    },
      +    "saveType": {
      +      "enum": [
      +        "strength",
      +        "dexterity",
      +        "constitution",
      +        "intelligence",
      +        "wisdom",
      +        "charisma"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  6. Changed1 schema field changed
    • addedInput schema / properties / spellListChoices / description
      Added value: +"Spell-list choices (the Magic Initiate shape): the player picks one list, then spells from it. On a Feat, vault refuses an update whose choices would no longer all offer a list that a background names as its `featSpellList`, or that moves the feat to another ruleset while one does. Only backgrounds in the feat's ruleset whose owners can use the feat count (stock, their own, or a house rule of their campaign, active or not)."
  7. Changed26 schema fields changed
    • addedInput schema / properties / damageReduction / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / diceFloors / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / diceReplacements / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / forcedMovement / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / recurringDamage / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / resistances / items / properties / requires
      Added value: +{
      +  "description": "Predicates that gate the resistance (Rage's: a 'condition' predicate on 'raging'). Absent = always.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "abilities": {
      +        "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +        "items": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "armorCategories": {
      +        "description": "Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "condition": {
      +        "description": "For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there.",
      +        "enum": [
      +          "blinded",
      +          "charmed",
      +          "concentration",
      +          "deafened",
      +          "exhaustion",
      +          "frightened",
      +          "grappled",
      +          "incapacitated",
      +          "invisible",
      +          "paralyzed",
      +          "petrified",
      +          "poisoned",
      +          "prone",
      +          "restrained",
      +          "stunned",
      +          "unconscious",
      +          "dazed",
      +          "grappling",
      +          "dodging",
      +          "hiding",
      +          "raging"
      +        ],
      +        "type": "string"
      +      },
      +      "equipSlot": {
      +        "description": "Body slot the matched weapon must occupy (one of the schema's enum).",
      +        "enum": [
      +          "mainHand",
      +          "offHand"
      +        ],
      +        "type": "string"
      +      },
      +      "negate": {
      +        "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +        "type": "boolean"
      +      },
      +      "slot": {
      +        "description": "The equipped body category to match (one of the schema's enum).",
      +        "enum": [
      +          "armor",
      +          "shield",
      +          "weapon"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "Predicate type (one of the schema's enum): what the predicate gates on.",
      +        "enum": [
      +          "equipped",
      +          "attackingWeapon",
      +          "condition",
      +          "attackAbility"
      +        ],
      +        "type": "string"
      +      },
      +      "weaponProperties": {
      +        "description": "Weapon properties to match. AND semantics — match all.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / resistances / items / properties / requiresLogic
      Added value: +{
      +  "enum": [
      +    "and",
      +    "or"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / resistances / items / properties / trigger / description
      Added value: +"'passive' with an absent, self, or any target makes the character sheet list the resistance while `requires` holds."
    • addedInput schema / properties / rollMods / items / properties / abilities
      Added value: +{
      +  "description": "The abilities whose rolls the modifier covers (lowercase ids). Empty or absent covers every ability.",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / rollMods / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
    • addedInput schema / properties / rollMods / items / properties / trigger / description
      Added value: +"'passive' with an absent, self, or any audience, and not `consumeOnUse`, opens the character sheet's dice roller in this mode on the rolls it covers while `requires` holds."
    • addedInput schema / properties / statBonuses / items / properties / requires / items / properties / abilities
      Added value: +{
      +  "description": "For 'attackAbility' predicates: the attack-roll abilities that match (lowercase ids; any one matches). Empty or absent matches any ability. Rage's damage uses ['strength'].",
      +  "items": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states). The sheet evaluates only the declared states (the character's `activeStates`); a predicate on any other condition never holds there."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / type / enum
      Previous value: -[
      -  "equipped",
      -  "attackingWeapon",
      -  "condition"
      -]New value: +[
      +  "equipped",
      +  "attackingWeapon",
      +  "condition",
      +  "attackAbility"
      +]
  8. Changed73 schema fields changed
    • changedInput schema / properties / abilityScoreBump / properties / options / items / properties / lines / items / properties / eligible / description
      Previous value: -"Pool to choose from. Empty / absent = any of the six."New value: +"Pool to choose from. Empty / absent = any ability in the schema's abilities list."
    • changedInput schema / properties / abilityScoreBump / properties / options / items / properties / lines / items / properties / max / description
      Previous value: -"Ceiling no chosen score may exceed after the bump (ASI = 20)."New value: +"Ceiling no chosen score may exceed after the bump. The rule authoring guide's abilityScoreBump section shows the values."
    • changedInput schema / properties / abilityScoreBump / properties / options / items / properties / lines / items / properties / max / maximum
      Previous value: -9007199254740991New value: +30
    • changedInput schema / properties / abilityScoreSet / items / properties / value / maximum
      Previous value: -9007199254740991New value: +30
    • changedInput schema / properties / armorCategory / description
      Previous value: -"Armor category ('Light', 'Medium', 'Heavy', 'Shield')."New value: +"Armor category, as the ruleset's catalog names it (vault_search_items shows them)."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / damageReduction / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / diceFloors / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / diceReplacements / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / equipSlots / description
      Previous value: -"Allowed equip slot ids (e.g. 'mainHand', 'offHand', 'body'). Vocabulary is ruleset-specific."New value: +"Allowed equip slot ids, from the ruleset's own slots (an existing item's equipSlots, via vault_get_item, shows them)."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / forcedMovement / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / mastery / description
      Previous value: -"5e24 weapon mastery name (e.g. 'Topple', 'Vex', 'Slow')."New value: +"Weapon mastery name, for rulesets whose weapons carry one, as the ruleset's catalog names it."
    • changedInput schema / properties / maxDexModifier / description
      Previous value: -"Cap on DEX bonus from this armor (medium = 2; heavy = 0 typically)."New value: +"Cap on the DEX bonus this armor allows, from the item's source text."
    • changedInput schema / properties / prerequisites / items / properties / abilities / description
      Previous value: -"For abilityScore: ANY listed ability meeting `min` satisfies ('Str or Dex 13+')."New value: +"For abilityScore: ANY listed ability meeting `min` satisfies."
    • changedInput schema / properties / prerequisites / items / properties / proficiency / description
      Previous value: -"For proficiency: the proficiency name (e.g. 'Martial', 'Stealth')."New value: +"For proficiency: the proficiency name, as the ruleset names it."
    • changedInput schema / properties / prerequisites / items / properties / proficiencyType / enum
      Previous value: -[
      -  "skill",
      -  "tool",
      -  "weapon",
      -  "armor",
      -  "save",
      -  "language"
      -]New value: +[
      +  "skill",
      +  "tool",
      +  "save",
      +  "weapon",
      +  "armor",
      +  "language"
      +]
    • changedInput schema / properties / prerequisites / items / properties / type / description
      Previous value: -"Predicate kind: level / abilityScore / rule / spell / proficiency / spellcasting. (A class is required via a `rule` predicate pointing at the class rule.)"New value: +"Predicate kind. (A class is required via a `rule` predicate pointing at the class rule.)"
    • changedInput schema / properties / properties / items / properties / ammoType / description
      Previous value: -"Ammunition type for the Ammunition property (e.g. 'Arrow', 'Bolt')."New value: +"Ammunition type, for a property that uses ammunition."
    • changedInput schema / properties / properties / items / properties / damage / description
      Previous value: -"Per-property damage dice override (e.g. Versatile's two-hand dice)."New value: +"Per-property damage dice override, for a property that changes the weapon's damage."
    • changedInput schema / properties / properties / items / properties / name / description
      Previous value: -"Property identifier (e.g. 'Finesse', 'Versatile', 'Ammunition')."New value: +"Property identifier, as the ruleset's catalog names it (vault_search_items shows them)."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / recurringDamage / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / resistances / items / properties / range / description
      Previous value: -"Aura radius in feet for ally/any-targeted resistances (Warding Aura's 10 ft.). Absent = self-only."New value: +"Aura radius in feet for ally/any-targeted resistances. Absent = self-only."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / rollMods / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / ruleset / description
      Previous value: -"Ruleset code (e.g. '5th Edition', '5e24', 'PFRPG', 'Savage Worlds')."New value: +"Ruleset code, from list_rulesets."
    • changedInput schema / properties / statBonuses / items / properties / durationCount / description
      Previous value: -"Numeric count paired with durationUnit (e.g. count: 3, unit: 'round')."New value: +"Numeric count paired with durationUnit."
    • changedInput schema / properties / statBonuses / items / properties / range / description
      Previous value: -"Aura radius in feet for ally/any-audience bonuses (Aura of Protection's 10 ft.). Absent = no range filter."New value: +"Aura radius in feet for ally/any-audience bonuses. Absent = no range filter."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / armorCategories / description
      Previous value: -"For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any."New value: +"Armor categories to match, as the items' `armorCategory` values name them. OR semantics — match any."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / condition / description
      Previous value: -"For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states)."New value: +"For 'condition' predicates: the character-state condition to gate on (named conditions and ongoing-action states)."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / condition / enum
      Previous value: -[
      -  "blinded",
      -  "charmed",
      -  "dazed",
      -  "deafened",
      -  "exhaustion",
      -  "frightened",
      -  "grappled",
      -  "incapacitated",
      -  "invisible",
      -  "paralyzed",
      -  "petrified",
      -  "poisoned",
      -  "prone",
      -  "restrained",
      -  "stunned",
      -  "unconscious",
      -  "concentrating",
      -  "grappling",
      -  "dodging",
      -  "hiding",
      -  "raging"
      -]New value: +[
      +  "blinded",
      +  "charmed",
      +  "concentration",
      +  "deafened",
      +  "exhaustion",
      +  "frightened",
      +  "grappled",
      +  "incapacitated",
      +  "invisible",
      +  "paralyzed",
      +  "petrified",
      +  "poisoned",
      +  "prone",
      +  "restrained",
      +  "stunned",
      +  "unconscious",
      +  "dazed",
      +  "grappling",
      +  "dodging",
      +  "hiding",
      +  "raging"
      +]
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / equipSlot / description
      Previous value: -"Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both."New value: +"Body slot the matched weapon must occupy (one of the schema's enum)."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / slot / description
      Previous value: -"For 'equipped' predicates: the body category to match (armor / shield / weapon)."New value: +"The equipped body category to match (one of the schema's enum)."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / type / description
      Previous value: -"Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition."New value: +"Predicate type (one of the schema's enum): what the predicate gates on."
    • changedInput schema / properties / statBonuses / items / properties / requires / items / properties / weaponProperties / description
      Previous value: -"For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all."New value: +"Weapon properties to match. AND semantics — match all."
    • changedInput schema / properties / statBonuses / items / properties / target / description
      Previous value: -"Stat the bonus contributes to (e.g. 'skills.Acrobatics.misc', 'attributes.strength.misc')."New value: +"Stat the bonus contributes to (e.g. 'skills.<skill>.misc', 'attributes.<ability>.misc')."
    • changedInput schema / properties / statBonuses / items / properties / trigger / description
      Previous value: -"Action-economy / cost shape of the bonus. passive / toggled / reaction / perRoll / resource / targetBound."New value: +"Action-economy / cost shape of the bonus."
    • changedInput schema / properties / statBonuses / items / properties / triggerEvent / description
      Previous value: -"Game-time event that fires the bonus (onHit / onDamage / startOfYourTurn / etc.). Absent = not event-driven (passive walker contributes whenever `requires` holds)."New value: +"Game-time event that fires the bonus (one of the schema's trigger events). Absent = not event-driven (passive walker contributes whenever `requires` holds)."
    • changedInput schema / properties / statBonuses / items / properties / valueType / enum
      Previous value: -[
      -  "fixed",
      -  "attribute",
      -  "proficiency",
      -  "level",
      -  "halfLevel",
      -  "dice",
      -  "byLevel",
      -  "attackAttribute"
      -]New value: +[
      +  "fixed",
      +  "attribute",
      +  "attackAttribute",
      +  "proficiency",
      +  "level",
      +  "halfLevel",
      +  "dice",
      +  "byLevel"
      +]
    • changedInput schema / properties / weaponType / description
      Previous value: -"Weapon category ('Simple Melee', 'Martial Ranged', etc.)."New value: +"Weapon category, as the ruleset's catalog names it (vault_search_items shows them)."
  9. Changed52 schema fields changed
    • addedInput schema / $schema
      Added value: +"http://json-schema.org/draft-07/schema#"
    • addedInput schema / additionalProperties
      Added value: +{}
    • addedInput schema / properties / _parent
      Added value: +{
      +  "description": "Parent item ObjectId for variant items.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / abilityScoreBump
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "options": {
      +      "description": "Alternatives the player picks exactly ONE of (OR).",
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "lines": {
      +            "description": "Lines that ALL apply when this option is chosen (AND).",
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "amount": {
      +                  "description": "How much each chosen ability goes up (usually positive).",
      +                  "type": "number"
      +                },
      +                "count": {
      +                  "description": "How many distinct abilities this line raises.",
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "eligible": {
      +                  "description": "Pool to choose from. Empty / absent = any of the six.",
      +                  "items": {
      +                    "enum": [
      +                      "strength",
      +                      "dexterity",
      +                      "constitution",
      +                      "intelligence",
      +                      "wisdom",
      +                      "charisma"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "max": {
      +                  "description": "Ceiling no chosen score may exceed after the bump (ASI = 20).",
      +                  "maximum": 9007199254740991,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / abilityScoreSet
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "ability": {
      +        "enum": [
      +          "strength",
      +          "dexterity",
      +          "constitution",
      +          "intelligence",
      +          "wisdom",
      +          "charisma"
      +        ],
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "Score to set the ability to while in effect.",
      +        "maximum": 9007199254740991,
      +        "minimum": 1,
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / actionType
      Added value: +{
      +  "description": "Authoring hint — when set, the character sheet's rule modal shows an 'Add to Actions' button that mints an action row with this `type`.",
      +  "type": "string"
      +}
    • addedInput schema / properties / active
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / armorCategory
      Added value: +{
      +  "description": "Armor category ('Light', 'Medium', 'Heavy', 'Shield').",
      +  "type": "string"
      +}
    • addedInput schema / properties / armorClass
      Added value: +{
      +  "description": "Base AC value the armor provides.",
      +  "type": "number"
      +}
    • addedInput schema / properties / cost
      Added value: +{
      +  "description": "Cost in gold pieces (max 2 decimal places). Vault enforces non-negativity and precision.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / damage
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "appliesTo": {
      +      "enum": [
      +        "melee",
      +        "ranged",
      +        "either"
      +      ],
      +      "type": "string"
      +    },
      +    "area": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "shape": {
      +            "enum": [
      +              "cone",
      +              "line",
      +              "sphere",
      +              "cube",
      +              "cylinder",
      +              "emanation",
      +              "radius"
      +            ],
      +            "type": "string"
      +          },
      +          "size": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "width": {
      +            "minimum": 0,
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "dice": {
      +      "type": "string"
      +    },
      +    "flat": {
      +      "type": "number"
      +    },
      +    "modifierAbility": {
      +      "enum": [
      +        "strength",
      +        "dexterity",
      +        "constitution",
      +        "intelligence",
      +        "wisdom",
      +        "charisma"
      +      ],
      +      "type": "string"
      +    },
      +    "modifierType": {
      +      "enum": [
      +        "flat",
      +        "proficiency",
      +        "ability"
      +      ],
      +      "type": "string"
      +    },
      +    "onSave": {
      +      "enum": [
      +        "half",
      +        "negates",
      +        "full"
      +      ],
      +      "type": "string"
      +    },
      +    "progression": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "dice": {
      +            "type": "string"
      +          },
      +          "flat": {
      +            "type": "number"
      +          },
      +          "level": {
      +            "maximum": 20,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "save": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "ability": {
      +          "enum": [
      +            "none",
      +            "spellcasting",
      +            "attackAttribute",
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "dcBase": {
      +          "type": "number"
      +        },
      +        "includesProficiency": {
      +          "type": "boolean"
      +        },
      +        "saveType": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "scaling": {
      +      "enum": [
      +        "fixed",
      +        "byLevel",
      +        "spellSlot"
      +      ],
      +      "type": "string"
      +    },
      +    "scalingAttribute": {
      +      "type": "string"
      +    },
      +    "slotIncrement": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "dice": {
      +          "type": "string"
      +        },
      +        "flat": {
      +          "type": "number"
      +        },
      +        "targets": {
      +          "maximum": 9007199254740991,
      +          "minimum": 1,
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "targets": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "count": {
      +          "maximum": 9007199254740991,
      +          "minimum": 1,
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "trigger": {
      +      "enum": [
      +        "passive",
      +        "toggled",
      +        "reaction",
      +        "perRoll",
      +        "resource",
      +        "targetBound"
      +      ],
      +      "type": "string"
      +    },
      +    "types": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / damageDice
      Added value: +{
      +  "description": "Base damage expression (e.g. '1d8').",
      +  "type": "string"
      +}
    • addedInput schema / properties / damageReduction
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amount": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "dice": {
      +            "type": "string"
      +          },
      +          "flat": {
      +            "type": "number"
      +          },
      +          "includesProficiency": {
      +            "type": "boolean"
      +          },
      +          "modifierSource": {
      +            "enum": [
      +              "spellcasting",
      +              "attackAttribute",
      +              "strength",
      +              "dexterity",
      +              "constitution",
      +              "intelligence",
      +              "wisdom",
      +              "charisma"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "range": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "target": {
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "trigger": {
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      },
      +      "types": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / damageType
      Added value: +{
      +  "description": "Damage types as an array of strings (most items have one type; some have multiples).",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / description
      Added value: +{
      +  "description": "Full item description. Markdown is supported.",
      +  "type": "string"
      +}
    • addedInput schema / properties / diceFloors
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "appliesTo": {
      +        "enum": [
      +          "damage",
      +          "damage.melee",
      +          "damage.ranged",
      +          "damage.spell",
      +          "healing"
      +        ],
      +        "type": "string"
      +      },
      +      "floor": {
      +        "maximum": 9007199254740991,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "threshold": {
      +        "maximum": 9007199254740991,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "trigger": {
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / diceReplacements
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "_target": {
      +        "description": "Mongo `_id` reference (24-character hex string).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "dice": {
      +        "type": "string"
      +      },
      +      "progression": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "dice": {
      +              "type": "string"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / duration
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "concentration": {
      +      "type": "boolean"
      +    },
      +    "count": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "unit": {
      +      "enum": [
      +        "round",
      +        "minute",
      +        "hour",
      +        "day",
      +        "untilShortRest",
      +        "untilLongRest",
      +        "special"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / effect
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "audience": {
      +      "enum": [
      +        "self",
      +        "ally",
      +        "any",
      +        "target",
      +        "enemy"
      +      ],
      +      "type": "string"
      +    },
      +    "conditions": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "applyWhen": {
      +            "enum": [
      +              "always",
      +              "onFail",
      +              "onSuccess"
      +            ],
      +            "type": "string"
      +          },
      +          "durationCount": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "durationUnit": {
      +            "enum": [
      +              "round",
      +              "minute",
      +              "hour",
      +              "day",
      +              "untilShortRest",
      +              "untilLongRest",
      +              "special"
      +            ],
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "enum": [
      +              "self",
      +              "target"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "save": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "ability": {
      +          "enum": [
      +            "none",
      +            "spellcasting",
      +            "attackAttribute",
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "dcBase": {
      +          "type": "number"
      +        },
      +        "includesProficiency": {
      +          "type": "boolean"
      +        },
      +        "saveType": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "triggerEvent": {
      +      "enum": [
      +        "onHit",
      +        "onMiss",
      +        "onDamage",
      +        "startOfYourTurn",
      +        "endOfYourTurn",
      +        "startOfTargetTurn",
      +        "endOfTargetTurn"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / equipSlots
      Added value: +{
      +  "description": "Allowed equip slot ids (e.g. 'mainHand', 'offHand', 'body'). Vocabulary is ruleset-specific.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / forcedMovement
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "audience": {
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "direction": {
      +        "enum": [
      +          "awayFromSelf",
      +          "towardSelf",
      +          "anywhere"
      +        ],
      +        "type": "string"
      +      },
      +      "distance": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "maxTargetSize": {
      +        "enum": [
      +          "tiny",
      +          "small",
      +          "medium",
      +          "large",
      +          "huge",
      +          "gargantuan"
      +        ],
      +        "type": "string"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "triggerEvent": {
      +        "enum": [
      +          "onHit",
      +          "onMiss",
      +          "onDamage",
      +          "startOfYourTurn",
      +          "endOfYourTurn",
      +          "startOfTargetTurn",
      +          "endOfTargetTurn"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / healing
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "dice": {
      +      "type": "string"
      +    },
      +    "flat": {
      +      "type": "number"
      +    },
      +    "modifierSource": {
      +      "enum": [
      +        "level",
      +        "spellcasting",
      +        "strength",
      +        "dexterity",
      +        "constitution",
      +        "intelligence",
      +        "wisdom",
      +        "charisma"
      +      ],
      +      "type": "string"
      +    },
      +    "progression": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "dice": {
      +            "type": "string"
      +          },
      +          "flat": {
      +            "type": "number"
      +          },
      +          "level": {
      +            "maximum": 20,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "scaling": {
      +      "enum": [
      +        "fixed",
      +        "byLevel",
      +        "proficiency",
      +        "spellSlot"
      +      ],
      +      "type": "string"
      +    },
      +    "slotIncrement": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "dice": {
      +          "type": "string"
      +        },
      +        "flat": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "target": {
      +      "enum": [
      +        "self",
      +        "ally",
      +        "any",
      +        "multiple"
      +      ],
      +      "type": "string"
      +    },
      +    "targets": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "count": {
      +          "maximum": 9007199254740991,
      +          "minimum": 1,
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / image
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "url": {
      +      "description": "Image URL hosted on Embers Images (or any addressable HTTPS URL).",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / mastery
      Added value: +{
      +  "description": "5e24 weapon mastery name (e.g. 'Topple', 'Vex', 'Slow').",
      +  "type": "string"
      +}
    • addedInput schema / properties / maxDexModifier
      Added value: +{
      +  "description": "Cap on DEX bonus from this armor (medium = 2; heavy = 0 typically).",
      +  "type": "number"
      +}
    • addedInput schema / properties / mechanicsKey
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / name
      Added value: +{
      +  "description": "Display name. Required.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / ogl
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / parameters
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "label": {
      +        "type": "string"
      +      },
      +      "max": {
      +        "type": "number"
      +      },
      +      "min": {
      +        "type": "number"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "number",
      +          "string",
      +          "enum"
      +        ],
      +        "type": "string"
      +      },
      +      "unit": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / preparedSpells
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "count": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "progression": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "count": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "level": {
      +            "maximum": 20,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / prerequisites
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "abilities": {
      +        "description": "For abilityScore: ANY listed ability meeting `min` satisfies ('Str or Dex 13+').",
      +        "items": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "category": {
      +        "description": "For rule (filter): matches any held rule in this category.",
      +        "type": "string"
      +      },
      +      "class": {
      +        "description": "For a `level` predicate: a Class rule id that scopes `min` to 'Nth level in that class'. Absent = total character level.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "min": {
      +        "description": "Numeric minimum — character level (level), class level (class), or ability score (abilityScore).",
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "negate": {
      +        "description": "true inverts the predicate — 'must NOT meet this'.",
      +        "type": "boolean"
      +      },
      +      "proficiency": {
      +        "description": "For proficiency: the proficiency name (e.g. 'Martial', 'Stealth').",
      +        "type": "string"
      +      },
      +      "proficiencyType": {
      +        "description": "For proficiency: the family.",
      +        "enum": [
      +          "skill",
      +          "tool",
      +          "weapon",
      +          "armor",
      +          "save",
      +          "language"
      +        ],
      +        "type": "string"
      +      },
      +      "rule": {
      +        "description": "For rule: a specific held Rule id.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "ruleType": {
      +        "description": "For rule (filter): matches any held rule of this type.",
      +        "type": "string"
      +      },
      +      "spell": {
      +        "description": "For spell: a specific known Spell id.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "spellList": {
      +        "description": "For spell (filter): knows any spell from this class list.",
      +        "type": "string"
      +      },
      +      "type": {
      +        "description": "Predicate kind: level / abilityScore / rule / spell / proficiency / spellcasting. (A class is required via a `rule` predicate pointing at the class rule.)",
      +        "enum": [
      +          "level",
      +          "abilityScore",
      +          "rule",
      +          "spell",
      +          "proficiency",
      +          "spellcasting"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / prerequisitesLogic
      Added value: +{
      +  "enum": [
      +    "and",
      +    "or"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / proficiencyChoices
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "allowedItems": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "level": {
      +        "enum": [
      +          "proficient",
      +          "expertise"
      +        ],
      +        "type": "string"
      +      },
      +      "mode": {
      +        "enum": [
      +          "specific",
      +          "all"
      +        ],
      +        "type": "string"
      +      },
      +      "progression": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "types": {
      +        "items": {
      +          "enum": [
      +            "skill",
      +            "tool",
      +            "save",
      +            "weapon",
      +            "armor",
      +            "language"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / properties
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "ammoType": {
      +        "description": "Ammunition type for the Ammunition property (e.g. 'Arrow', 'Bolt').",
      +        "type": "string"
      +      },
      +      "damage": {
      +        "description": "Per-property damage dice override (e.g. Versatile's two-hand dice).",
      +        "type": "string"
      +      },
      +      "display": {
      +        "description": "Display string overriding the raw name.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Property identifier (e.g. 'Finesse', 'Versatile', 'Ammunition').",
      +        "type": "string"
      +      },
      +      "range": {
      +        "additionalProperties": {},
      +        "description": "For ranged properties: normal / long reach in feet.",
      +        "properties": {
      +          "long": {
      +            "type": "number"
      +          },
      +          "normal": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / publisher
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / recurringDamage
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "amount": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "dice": {
      +            "type": "string"
      +          },
      +          "flat": {
      +            "type": "number"
      +          },
      +          "includesProficiency": {
      +            "type": "boolean"
      +          },
      +          "modifierSource": {
      +            "enum": [
      +              "spellcasting",
      +              "attackAttribute",
      +              "strength",
      +              "dexterity",
      +              "constitution",
      +              "intelligence",
      +              "wisdom",
      +              "charisma"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "audience": {
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "durationCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "durationUnit": {
      +        "enum": [
      +          "instantaneous",
      +          "untilStartOfNextTurn",
      +          "untilEndOfNextTurn",
      +          "round",
      +          "minute",
      +          "hour",
      +          "untilShortRest",
      +          "untilLongRest"
      +        ],
      +        "type": "string"
      +      },
      +      "ignoreResistances": {
      +        "type": "boolean"
      +      },
      +      "inheritDamageType": {
      +        "type": "boolean"
      +      },
      +      "range": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "triggerEvent": {
      +        "enum": [
      +          "startOfYourTurn",
      +          "endOfYourTurn",
      +          "startOfTargetTurn",
      +          "endOfTargetTurn",
      +          "whenTargetEntersArea",
      +          "onHit",
      +          "onMiss",
      +          "onDamage"
      +        ],
      +        "type": "string"
      +      },
      +      "types": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / resistances
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "mode": {
      +        "enum": [
      +          "resistance",
      +          "immunity",
      +          "vulnerability"
      +        ],
      +        "type": "string"
      +      },
      +      "range": {
      +        "description": "Aura radius in feet for ally/any-targeted resistances (Warding Aura's 10 ft.). Absent = self-only.",
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "target": {
      +        "description": "Who the resistance protects — mirrors damageReduction's target/range pair. Absent = self.",
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "trigger": {
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      },
      +      "types": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / rollMods
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "audience": {
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "consumeOnUse": {
      +        "type": "boolean"
      +      },
      +      "durationCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "durationUnit": {
      +        "enum": [
      +          "instantaneous",
      +          "untilStartOfNextTurn",
      +          "untilEndOfNextTurn",
      +          "round",
      +          "minute",
      +          "hour",
      +          "untilShortRest",
      +          "untilLongRest"
      +        ],
      +        "type": "string"
      +      },
      +      "mode": {
      +        "enum": [
      +          "advantage",
      +          "disadvantage"
      +        ],
      +        "type": "string"
      +      },
      +      "range": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "requires": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "rollScope": {
      +        "enum": [
      +          "attack",
      +          "save",
      +          "abilityCheck",
      +          "skillCheck"
      +        ],
      +        "type": "string"
      +      },
      +      "trigger": {
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      },
      +      "triggerEvent": {
      +        "enum": [
      +          "onHit",
      +          "onMiss",
      +          "onDamage",
      +          "startOfYourTurn",
      +          "endOfYourTurn",
      +          "startOfTargetTurn",
      +          "endOfTargetTurn"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / ruleChoice
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "allowedCategories": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "allowedRuleParameters": {
      +      "additionalProperties": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "damageType": {
      +            "type": "string"
      +          },
      +          "number": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "range": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "speed": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "allowedRules": {
      +      "items": {
      +        "description": "Mongo `_id` reference (24-character hex string).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "allowedTypes": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "count": {
      +      "maximum": 9007199254740991,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "label": {
      +      "type": "string"
      +    },
      +    "mode": {
      +      "enum": [
      +        "filter",
      +        "specific"
      +      ],
      +      "type": "string"
      +    },
      +    "progression": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "count": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "level": {
      +            "maximum": 20,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "scaling": {
      +      "enum": [
      +        "fixed",
      +        "byLevel"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / ruleset
      Added value: +{
      +  "description": "Ruleset code (e.g. '5th Edition', '5e24', 'PFRPG', 'Savage Worlds').",
      +  "type": "string"
      +}
    • addedInput schema / properties / source
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / spellChoices
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "allowedCategories": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "allowedSchools": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "allowedSpells": {
      +        "items": {
      +          "description": "Mongo `_id` reference (24-character hex string).",
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "castingAbility": {
      +        "enum": [
      +          "strength",
      +          "dexterity",
      +          "constitution",
      +          "intelligence",
      +          "wisdom",
      +          "charisma"
      +        ],
      +        "type": "string"
      +      },
      +      "castingAbilityOptions": {
      +        "items": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "freeCast": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "atWill": {
      +            "type": "boolean"
      +          },
      +          "count": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "progression": {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "count": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "level": {
      +                  "maximum": 20,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "recovery": {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "count": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "on": {
      +                  "enum": [
      +                    "Short",
      +                    "Long"
      +                  ],
      +                  "type": "string"
      +                },
      +                "restoreAll": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "maxLevel": {
      +        "maximum": 9,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "minLevel": {
      +        "maximum": 9,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "mode": {
      +        "enum": [
      +          "filter",
      +          "specific"
      +        ],
      +        "type": "string"
      +      },
      +      "prepared": {
      +        "type": "boolean"
      +      },
      +      "progression": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / spellListChoices
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "allowedCategories": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "castingAbility": {
      +        "enum": [
      +          "strength",
      +          "dexterity",
      +          "constitution",
      +          "intelligence",
      +          "wisdom",
      +          "charisma"
      +        ],
      +        "type": "string"
      +      },
      +      "castingAbilityOptions": {
      +        "items": {
      +          "enum": [
      +            "strength",
      +            "dexterity",
      +            "constitution",
      +            "intelligence",
      +            "wisdom",
      +            "charisma"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "picks": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "freeCast": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "atWill": {
      +                  "type": "boolean"
      +                },
      +                "count": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "progression": {
      +                  "items": {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "count": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      },
      +                      "level": {
      +                        "maximum": 20,
      +                        "minimum": 1,
      +                        "type": "integer"
      +                      }
      +                    },
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "recovery": {
      +                  "items": {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "count": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      },
      +                      "on": {
      +                        "enum": [
      +                          "Short",
      +                          "Long"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "restoreAll": {
      +                        "type": "boolean"
      +                      }
      +                    },
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "maxLevel": {
      +              "maximum": 9,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "minLevel": {
      +              "maximum": 9,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "prepared": {
      +        "type": "boolean"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / statBonuses
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "attribute": {
      +        "description": "For valueType: 'attribute' — which ability's modifier to use.",
      +        "type": "string"
      +      },
      +      "audience": {
      +        "description": "Who the bonus contributes to. Absent = self.",
      +        "enum": [
      +          "self",
      +          "ally",
      +          "any",
      +          "target",
      +          "enemy"
      +        ],
      +        "type": "string"
      +      },
      +      "dice": {
      +        "description": "For valueType: 'dice' — dice expression (e.g. '1d4').",
      +        "type": "string"
      +      },
      +      "durationCount": {
      +        "description": "Numeric count paired with durationUnit (e.g. count: 3, unit: 'round').",
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "durationUnit": {
      +        "description": "How long the bonus persists once fired. Only meaningful for event-driven bonuses.",
      +        "enum": [
      +          "instantaneous",
      +          "untilStartOfNextTurn",
      +          "untilEndOfNextTurn",
      +          "round",
      +          "minute",
      +          "hour",
      +          "untilShortRest",
      +          "untilLongRest"
      +        ],
      +        "type": "string"
      +      },
      +      "fixed": {
      +        "description": "For valueType: 'fixed' — the literal numeric contribution.",
      +        "type": "number"
      +      },
      +      "progression": {
      +        "description": "For valueType: 'byLevel' — per-level rows; walker picks the row with level <= current level.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "dice": {
      +              "type": "string"
      +            },
      +            "flat": {
      +              "type": "number"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "range": {
      +        "description": "Aura radius in feet for ally/any-audience bonuses (Aura of Protection's 10 ft.). Absent = no range filter.",
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "requires": {
      +        "description": "Optional predicate list that gates this bonus. Absent / empty = always-on.",
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "armorCategories": {
      +              "description": "For 'equipped' + slot:armor: armor category list (Light / Medium / Heavy). OR semantics — match any.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            "condition": {
      +              "description": "For 'condition' predicates: the character-state condition to gate on (5e24 named conditions and ongoing-action states).",
      +              "enum": [
      +                "blinded",
      +                "charmed",
      +                "dazed",
      +                "deafened",
      +                "exhaustion",
      +                "frightened",
      +                "grappled",
      +                "incapacitated",
      +                "invisible",
      +                "paralyzed",
      +                "petrified",
      +                "poisoned",
      +                "prone",
      +                "restrained",
      +                "stunned",
      +                "unconscious",
      +                "concentrating",
      +                "grappling",
      +                "dodging",
      +                "hiding",
      +                "raging"
      +              ],
      +              "type": "string"
      +            },
      +            "equipSlot": {
      +              "description": "Body slot the matched weapon must occupy. mainHand / offHand. Resolved via getRequiredSlots so two-handed grips occupy both.",
      +              "enum": [
      +                "mainHand",
      +                "offHand"
      +              ],
      +              "type": "string"
      +            },
      +            "negate": {
      +              "description": "true inverts the predicate — 'while NOT matching' instead of 'while matching'.",
      +              "type": "boolean"
      +            },
      +            "slot": {
      +              "description": "For 'equipped' predicates: the body category to match (armor / shield / weapon).",
      +              "enum": [
      +                "armor",
      +                "shield",
      +                "weapon"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "description": "Predicate type. 'equipped' = character-scoped (gates on what's equipped). 'attackingWeapon' = attack-scoped (gates on the current action's source weapon). 'condition' = gates on a character-state condition.",
      +              "enum": [
      +                "equipped",
      +                "attackingWeapon",
      +                "condition"
      +              ],
      +              "type": "string"
      +            },
      +            "weaponProperties": {
      +              "description": "For 'equipped' + slot:weapon OR 'attackingWeapon': weapon-property list. AND semantics — match all.",
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "requiresLogic": {
      +        "description": "How `requires` predicates compose. 'and' (default) = ALL must hold. 'or' = ANY one is sufficient.",
      +        "enum": [
      +          "and",
      +          "or"
      +        ],
      +        "type": "string"
      +      },
      +      "target": {
      +        "description": "Stat the bonus contributes to (e.g. 'skills.Acrobatics.misc', 'attributes.strength.misc').",
      +        "type": "string"
      +      },
      +      "trigger": {
      +        "description": "Action-economy / cost shape of the bonus. passive / toggled / reaction / perRoll / resource / targetBound.",
      +        "enum": [
      +          "passive",
      +          "toggled",
      +          "reaction",
      +          "perRoll",
      +          "resource",
      +          "targetBound"
      +        ],
      +        "type": "string"
      +      },
      +      "triggerEvent": {
      +        "description": "Game-time event that fires the bonus (onHit / onDamage / startOfYourTurn / etc.). Absent = not event-driven (passive walker contributes whenever `requires` holds).",
      +        "enum": [
      +          "onHit",
      +          "onMiss",
      +          "onDamage",
      +          "startOfYourTurn",
      +          "endOfYourTurn",
      +          "startOfTargetTurn",
      +          "endOfTargetTurn"
      +        ],
      +        "type": "string"
      +      },
      +      "types": {
      +        "description": "Damage type tags for damage.* targets. No-op for non-damage targets.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "valueType": {
      +        "description": "How the contribution is computed. 'fixed' uses `fixed`; 'attribute' uses the mod of `attribute`; 'attackAttribute' uses the action's attack-roll ability (per-attack only); others scale by level/PB/dice.",
      +        "enum": [
      +          "fixed",
      +          "attribute",
      +          "proficiency",
      +          "level",
      +          "halfLevel",
      +          "dice",
      +          "byLevel",
      +          "attackAttribute"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / stealthDisadvantage
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / strengthRequirement
      Added value: +{
      +  "type": "number"
      +}
    • addedInput schema / properties / summary
      Added value: +{
      +  "description": "Short one-line summary.",
      +  "type": "string"
      +}
    • addedInput schema / properties / type
      Added value: +{
      +  "description": "Item type. Required.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / uses
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "count": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "mode": {
      +        "enum": [
      +          "fixed",
      +          "byLevel",
      +          "proficiency"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "progression": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "countAbility": {
      +              "enum": [
      +                "strength",
      +                "dexterity",
      +                "constitution",
      +                "intelligence",
      +                "wisdom",
      +                "charisma"
      +              ],
      +              "type": "string"
      +            },
      +            "countSource": {
      +              "enum": [
      +                "fixed",
      +                "proficiency",
      +                "abilityMod"
      +              ],
      +              "type": "string"
      +            },
      +            "level": {
      +              "maximum": 20,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "slotLevel": {
      +              "maximum": 9,
      +              "minimum": 1,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "recovery": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "on": {
      +              "enum": [
      +                "Short",
      +                "Long"
      +              ],
      +              "type": "string"
      +            },
      +            "restoreAll": {
      +              "type": "boolean"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "rest": {
      +        "enum": [
      +          "Short",
      +          "Long"
      +        ],
      +        "type": "string"
      +      },
      +      "slotLevel": {
      +        "maximum": 9,
      +        "minimum": 1,
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / weaponType
      Added value: +{
      +  "description": "Weapon category ('Simple Melee', 'Martial Ranged', etc.).",
      +  "type": "string"
      +}
    • addedInput schema / properties / weight
      Added value: +{
      +  "type": "number"
      +}
    • addedInput schema / required
      Added value: +[
      +  "name",
      +  "type"
      +]
  10. First observed

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, destructiveHint=false, and idempotentHint=false, so the safety profile is covered. The description adds two genuinely new facts beyond that: that Vault performs ruleset-specific field validation, and that the created item is attributed to the calling user. It omits auth requirements and how validation failures surface.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences, front-loaded with the core action; the parenthetical field examples and the ownership note both carry information. No filler, though no explicit routing structure either.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values need no explanation, and the schema heavily documents individual fields. However, for a 53-parameter nested creation tool the description is thin on cross-tool context—it never points to the authoring guide or catalog lookup tools the schema references, nor to the ruleset scoping requirement.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 53 parameters and only 42% schema description coverage, the schema does not carry the full burden. The description partially compensates by explaining that the schema is a passthrough for ruleset-specific data and by naming representative fields (damage, properties, equip slots, weight), which clarifies why the schema is so permissive—but it does not explain syntax or required-parameter semantics beyond what the schema already says.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Create a new user-authored item of any of the ruleset's item types.' The resource noun ('item') implicitly separates it from vault_create_rule, vault_create_spell, and vault_create_character, though no sibling is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Creation intent is clear from the first sentence, but there is no explicit when-to-use guidance against alternatives, no statement of prerequisites (e.g. needing a valid ruleset code or catalog values), and no note on what to do when a ruleset-specific field is rejected.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources