Build a monster
vault_build_monsterCreate a complete monster character in one call, in a ruleset the monster builder supports (the ruleset field's list; list_rulesets gives each code's label). Replaces the vault_create_character + multiple vault_update_character pattern for monster authoring — fully typed input schema, so structured fields cannot be silently stringified. Caller passes source-text values (final AC, skill bonuses, attack bonuses); vault computes the stored base values, derives proficient / expertise / misc flags, formats spell-list markdown, creates recharge trackables, generates the challenge, legendary-intro, and alternate-form speed notes. Sets type: 'monster', settings.autoPassiveBonuses: false, and the derived core.experience automatically. The authoring guide at vault_get_authoring_guide({ rulesetCode: <the monster's ruleset>, entityType: 'monster' }) documents every field's source-text meaning and is the conventions reference for what shape to send. Returns the created character document.
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>",
"creatureType": "<creatureType>",
"size": "<size>",
"alignment": "<alignment>",
"cr": "<cr>",
"abilities": "<abilities>",
"ac": "<ac>",
"hp": "<hp>",
"hitDiceCount": "<hitDiceCount>",
"speed": "<speed>"
},
"name": "vault_build_monster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ac | Yes | AC block. `total` is the value the sheet should display (the source-text number). Vault computes the stored base from it, the `armorWeight` given, and any shield/magic/misc bonuses, per the guide Rule 1. | |
| cr | Yes | Challenge Rating as a number, a fraction as its decimal (e.g. 0.125 for CR 1/8); vault answers an error for a value that is not a challenge rating. Vault looks up XP reward + level-equivalent XP + proficiency bonus. | |
| hp | Yes | Maximum hit points. | |
| gear | No | Gear listed on the stat block, source text. Each becomes an items[] entry with `equipped: false` (monsters don't use equip slots) per Rule 19. Server-side template fill adds the currency items separately. | |
| name | Yes | Display name. Required. | |
| size | Yes | Size text, source-exact: a single value or the variable form ('X or Y') per the guide Rule 18. Stored verbatim in `core.size`. | |
| saves | No | Saving throw bonuses for the proficient ones only. Vault derives `attributes[].proficient = true` and a `misc` adjustment so the sheet total lands on the source bonus. | |
| speed | Yes | Speed block, in feet. `walk` is the base walking speed; the other modes become rules[] entries with the listed range. `alternateForm` carries a stat block's parenthetical alternate-form speed text, source-exact, per the guide Rule 5; lands in notes[]. | |
| senses | No | The stat block's senses other than the passive one the sheet derives, each as `name` and `detail` (the source text after the name). Each becomes a rules[] entry. The monster authoring guide covers which senses to author. | |
| skills | No | Skill bonuses for proficient / expertise skills only. Vault derives the proficient + expertise flags + misc so the sheet total matches the source bonus per the guide Rule 6. | |
| traits | No | Trait entries, source text. Use `summary` for a parenthetical usage limit per the guide Rule 14, and `detail` for a short qualifier per Rule 17; senses go under `senses`. | |
| actions | No | Action entries. `type` per the guide Rule 3. For attacks, pass `attackBonus` + `attackAttribute` + `damageDice` + `damageType` + `damageAttribute`; vault back-derives `attack.misc`. The guide Rule 3 gives `attackAttribute` for a spell attack. `recharge` takes the source's recharge text and creates a matching trackables[] checkbox the sheet renders as a cooldown; the guide gives the form. | |
| ruleset | No | A ruleset the monster builder supports. The authoring guide and the conversion math are ruleset-specific; other rulesets will land via their own build tools. | |
| abilities | Yes | Ability scores as numbers, one per ability score key. Vault computes modifiers, attack/damage/save/skill/initiative derivations. | |
| alignment | Yes | Alignment text, source-exact. | |
| languages | No | Languages text, source-exact. Stored in `core.languages`. | |
| immunities | No | Combined immunities row, source-exact, damage and condition entries as the source writes them. Use this when the source has one combined immunities row. | |
| hitDiceSize | No | Hit-die size from the stat block. Omitted, the app chooses the die. | |
| resistances | No | Resistances row, source-exact text. | |
| creatureType | Yes | Creature type, source text. Preserved verbatim into `core.race` per the guide Rule 16 'preserve original text'. | |
| hitDiceCount | Yes | Number of hit dice (the count, e.g. 12 for a creature with 12d8 listed in HP). | |
| spellcasting | No | Spellcasting block in one of two shapes; the ruleset's monster authoring guide says which shape its monsters take, and vault refuses the other. Trait shape: `abilityScore`, optional `saveDC` and `attackBonus` (each as the source prints it), optional `casterLevel` (when the source says the creature is an Nth-level spellcaster), optional `componentsNote`, and `groups` of `{ frequency, spells: [name] }` with the source frequency text; it lands as one rules[] entry. Action shape: `abilityScore`, optional `saveDC` and `attackBonus` (each as the source prints it), optional `components` (the spell components the source says the creature casts without), optional `creature` (the noun the entry calls the creature, e.g. `dragon`), and `groups` of `{ atWill: true, spells }` or `{ perDay: n, spells }`, each spell `{ name, note? }` with the source's parenthetical note (`level 3 version`, `self only`); it lands as the Spellcasting action in actions[]. Vault writes the wording and formats the spell list as markdown. | |
| legendaryIntro | No | Intro paragraph of the stat block's legendary section (the prose about how those actions work for this creature). Lands in notes[] under the name the guide Rule 8 gives. Individual legendary entries go in `actions[]` with the matching `type`. | |
| additionalNotes | No | Any free-form notes[] entries the LLM wants to author beyond the auto-generated challenge, legendary-intro, and alternate-form speed rows. Use sparingly — most stat-block content has a dedicated structured field above. | |
| initiativeBonus | No | The listed initiative bonus. Pass it only if it differs from the bonus the sheet derives; vault keeps the difference in `offense.initiative.misc` per the guide Rule 17. | |
| vulnerabilities | No | Vulnerabilities row. | |
| damageImmunities | No | Split form: damage-only immunities, source-exact. Use only if the source has a separate damage immunities row. | |
| damageResistances | No | Split form: damage-only resistances, source-exact. Use only if the source has a separate damage resistances row. | |
| conditionImmunities | No | Split form: condition-only immunities, source-exact. Use only if the source has a separate condition immunities row. | |
| damageVulnerabilities | No | Split form: damage-only vulnerabilities, source-exact. | |
| sourceProficiencyBonus | No | Override the PB derived from CR. Use only when the source stat block explicitly lists a PB other than the one its CR gives. A PB larger than the sheet's keeps the difference in misc automatically, per the guide Rule 15. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||