Skip to main content
Glama

Embers: Tabletop RPG Toolkit

Build a player character

vault_build_pc

Assemble a complete, playable player character in one call from a flat draft of choices, in a ruleset with guided creation (the ruleset field's list). Vault validates every pick against the user's own + stock content and the chosen campaigns' and Worlds' content, and builds the full sheet — ability scores (with background bump), skills, saves, hit points, starting equipment + derived weapon actions, granted rules / feats / abilities, trackables, and a creation-recap note. Read vault_get_pc_creation_options first to get legal ids and pools. Required: name, classRuleId, abilityScoreMethod, abilityScoreAssignments, skillProficiencies, toolProficiencies, and the equipment picks (startingEquipmentLabel for options without a set; startingEquipmentSetLabels where the class's options carry a set). What a ruleset asks for differs and the options and constants say which applies: a ruleset whose constants list no background bump modes and whose backgrounds carry no feat takes no background bump or background feat, gives ability score increases through the heritage rule and its subrace (fixed ones need no pick; chosen ones go in abilityBumpPicks keyed by that rule's _id), offers the roll method (abilityScoreRolls), and takes backgroundToolProficiencies, the background equipment picks, backgroundAbilityChoices, and skillReplacements / toolReplacements; where its class option carries startingGold dice it may take startingGold with startingGoldRolls in place of every equipment pick. Required when present: backgroundFeatRuleId (an open featOpen background's feat, from the originFeatCategory feats — the build rejects the draft without it). Optional: speciesRuleId, backgroundRuleId, backgroundSkillProficiencies (when the background grants skills as a choice), the background bump (backgroundBumpMode + backgroundBumpAssignments), backgroundFeatRuleId (as a swap on a fixed-feat background), languages, languageChoicePicks (background/species language-choice grants), alignment, description/image/appearances/token, and the choice maps (proficiencyChoicePicks, abilityChoices, speciesAbilityChoices, backgroundFeatChoices, equipmentChoices, weaponAbilityChoices, abilityBumpPicks) plus the spell maps (spellChoicePicks, spellListChoicePicks, preparedSpellPicks, castingAbilityPicks) for spellcasters / spell-list-choice grants. proficiencyChoicePicks and spellChoicePicks are keyed ":" and only needed where a grant's count is smaller than its option pool. castingAbilityPicks is required for any spellChoices block surfacing castingAbilityOptions — the projection only surfaces that array when a pick is genuinely needed (a spellListChoices block's ability pick rides its spellListChoicePicks entry as castingAbility instead). The projected spellChoices/spellListChoices arrays may hold null entries (blocks inert at the starting level) — count them when keying picks by index. A feat chosen via an ability's ruleChoice (in abilityChoices/speciesAbilityChoices) brings its own sub-choices — supply them in those same maps keyed by the picked feat's _id. A repeatable feat filling the background slot (backgroundFeatRuleId) instead prefixes its pick keys bg:<featId>. When the background option carries a non-null featSpellList, its own feat's spell-list pick must use that list. Campaigns and Worlds: pass the same campaignIds and worldIds the options were read with (none means stock plus the user's own content only). The character joins each chosen campaign and World when it is built and gets the chosen Worlds' extra skills as skill rows; a choice that can no longer be joined fails the build with CREATION_CONTEXT_LOST, naming it and the reason, and nothing is created. The created character is owned by the calling user and returned in full. On an invalid draft vault returns the specific reason (e.g. a pick out of pool, a wrong pick count, a missing required choice) as a tool error — fix the draft and retry.

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": {
      "ruleset": "<ruleset>",
      "name": "<name>",
      "classRuleId": "<classRuleId>",
      "abilityScoreMethod": "<abilityScoreMethod>",
      "abilityScoreAssignments": "<abilityScoreAssignments>",
      "skillProficiencies": "<skillProficiencies>",
      "toolProficiencies": "<toolProficiencies>"
    },
    "name": "vault_build_pc"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYesCharacter name. Required.
imageNoCharacter portrait — `{ url }`.
tokenNoDefault battlemap token art — `{ url }`.
rulesetYesA ruleset with guided character creation: the one the options were read for with `vault_get_pc_creation_options`.
worldIdsNoimagine Worlds the new character will join, by `_id`, from imagine_list_my_worlds (the user's own and role Worlds) and imagine_search_public_worlds (public Worlds by name). At most 10 (the app answers 400 for more). Each adds its house content and extra skills, and the stock every chosen World hides is left out of the options.
alignmentNo
languagesNoThe character's OWN chosen language names. The build adds any language the ruleset gives every character. `constants.languages.options` + `pickCount` are the conventional pool and count, but vault stores whatever is passed here — free-form names are allowed and the count is not enforced. (Languages a background/species GRANTS go in `languageChoicePicks`, not here.)
appearancesNoAppearance roster — `[{ url }]`. The portrait (`image`) is typically the default appearance.
campaignIdsNoCampaigns the new character will join, by `_id`, from play_list_joinable_campaigns for this ruleset, at most 10 (the app answers 400 for more). Each adds its house rules, spells, and items to the options.
classRuleIdYesRequired. `_id` of a base Class rule (from `vault_get_pc_creation_options({ kind: 'class' })`).
descriptionNoCharacter description / biography.
startingGoldNotrue takes the class's starting gold in place of the class's AND the background's starting equipment, where the class option carries `startingGold` dice (`{ count, sides, multiplier, label }`; null or absent = the option is not offered). The character gets the rolled gold in its Gold row and no starting equipment; every proficiency, spell, and trait is unchanged. Send `startingGoldRolls` with it and omit the equipment picks.
speciesRuleIdNo`_id` of the heritage rule (from `kind: 'species'`).
abilityChoicesNoPicks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability or a Feat), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat. A picked option's (or its abilities') own `choice` goes in this map too, keyed by that rule's `_id`.
abilityBumpPicksNoAbility-score-increase picks for any applied rule carrying an `abilityScoreBump` (a feat / ability that raises a score by your choice). Key is the granting rule `_id`; value is `{ option, lines }`: `option` is the 0-based index of the chosen alternative in that bump's `options` (the player picks exactly ONE — the OR), and `lines` is parallel to that option's `lines`, each entry the lowercase ability names assigned to that line (the AND). Each line needs exactly its `count` distinct abilities drawn from its `eligible` pool (empty = any ability in the schema's abilities list), none exceeding its `max`. The build bakes the increases onto the ability scores before it derives the rest of the sheet. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`.
backgroundRuleIdNo`_id` of a Background rule (from `kind: 'background'`).
equipmentChoicesNoResolves equipment groups in the chosen bundle or chosen set options. Key is the group parent item `_id` (a `startingEquipmentOptions[].items[]` entry that carries `group.options`); value is the picked member `_id`, or, for a group entry with a quantity above 1, a list of that many member `_id`s (one per unit, repeats allowed). Every group in the chosen options needs an entry.
spellChoicePicksNoPicks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `"<ruleId>:<blockIndex>"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at the starting level; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A block's `addedOptions` entry (it carries `addedBy`, rule `_id`s) is a spell a rule's expanded spell list adds — a subclass's, such as a Warlock patron's: it may be picked like an option only when one of those rules is in the build (picked through `abilityChoices` or granted by a pick); otherwise vault refuses it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`.
toolReplacementsNoAs `skillReplacements`, for a tool gained from two sources.
abilityScoreRollsNoFor the `roll` ability score method: one roll per ability score, each the dice faces as rolled, in the roll count, dice count, and face range this schema states. The app drops each roll's lowest faces; `abilityScoreAssignments` must assign each roll's total exactly once.
skillReplacementsNoWhere the ruleset lets a character that gains the same skill from two sources take a different skill instead: key is the duplicated skill, value is the replacement skill the character does not already have.
startingGoldRollsNoWith `startingGold`: the faces of the class's starting gold dice as rolled — exactly `startingGold.count` whole numbers from 1 to `startingGold.sides`. The gold is their sum times `startingGold.multiplier`. Roll them yourself; vault refuses faces that do not fit the dice.
toolProficienciesYesThe class tool picks. Exactly `class.toolChoices.count` names from `class.toolChoices.options`. If an option is a group, pick a concrete member name, not the group. Empty array if none.
abilityScoreMethodYesHow ability scores were chosen. See `constants.abilityScoreMethods` for the array / point-buy budget / costs.
backgroundBumpModeNoRequired when the background grants an ability bump; each mode's amounts are the wizard constants' `backgroundBumpModeOptions`.
preparedSpellPicksNoWhich spells the player keeps prepared, for rules carrying a `preparedSpells` count. Key is the granting rule `_id`; value is spell `_id`s drawn from the character's preparable granted spells — `spellChoices` picks, whole-pool fixed grants, and `spellListChoices` picks alike — EXCLUDING any granted by a block whose `prepared` flag is true (an always-prepared grant; the options projection ships `prepared` on each block so you can tell) and any the count does not cover (the rule authoring guide's preparedSpells section says which). The rule authoring guide.s preparedSpells section gives the required count; vault rejects picks that do not fit. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`.
skillProficienciesYesThe class skill picks. Exactly `class.skillChoices.count` names, each from `class.skillChoices.options`, no duplicates. Empty array if the class grants no skill choices.
castingAbilityPicksNoSpellcasting-ability picks for `spellChoices` blocks that carry `castingAbilityOptions` (a grant that lets the player choose the casting ability). Key is `"<ruleId>:<blockIndex>"` (same keying as `spellChoicePicks`); value is ONE lowercase ability name from that block's `castingAbilityOptions`. The projection surfaces `castingAbilityOptions` only when a pick is genuinely required (a fixed ability or a single option self-resolves server-side) — so whenever you see the array, supply a pick or the build rejects the draft. The resolved ability is stamped on each granted spell (`spells[].castingAbility`). A `repeatable` background feat prefixes the key `bg:<featId>:<blockIndex>` (same keying as spellChoicePicks).
languageChoicePicksNoPicks for a background's or species' language-CHOICE grant (`background.languages.choose` / `species.languages.choose`). Key is the granting rule's `_id`; value is exactly `languages.choose.count` names from `languages.choose.options` (an empty options pool means any `constants.languages.options`). The grant's `languages.fixed` are auto-applied and need no pick. Distinct from `languages` (the character's own picks).
backgroundFeatRuleIdNoThe background's feat, from the `originFeatCategory` feats. REQUIRED when `background.featOpen` is true (an open slot — the build rejects the draft without it); optional on a fixed-feat background, where supplying it swaps the authored default. Must be a feat in the `originFeatCategory` (from `kind: 'feat'`).
spellListChoicePicksNoPicks for `spellListChoices` blocks (choose ONE of the block's lists, then spells from that one list). Key is `"<ruleId>:<blockIndex>"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` (for the background's own feat, the background's `featSpellList` when it names one) and `picks` is `{ "<pickIndex>": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`.
weaponAbilityChoicesNoFor a weapon in the chosen bundle whose attack ability is a player pick: key is the item `_id`, value is the attack ability (one of the schema's enum).
backgroundFeatChoicesNoPicks for the background feat's `choice` (ruleChoice) AND for any choice carried by the feat's granted abilities. Key is the feat `_id` (its own choice) or the granted ability's `_id` (that ability's choice); value is the picked rule `_id`s. A picked option's own sub-choices go in the proficiency/spell pick maps keyed by that option's `_id`; its (or its abilities') own `choice` goes in this map, keyed by that rule's `_id`.
speciesAbilityChoicesNoSame as `abilityChoices`, for a species ability's `choice`. A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`; its (or its abilities') own `choice` goes in this map, keyed by that rule's `_id`.
proficiencyChoicePicksNoPicks for proficiencyChoices grants across ALL applied rules (class/species/feat/abilities). Key is `"<ruleId>:<grantIndex>"` (the Rule `_id` and the 0-based index into that rule's `proficiencyChoices`); value is the chosen names (skills/tools/saves/weapons/armor/languages). Only supply for grants where `count` < the option-pool size — fixed grants (count >= pool) are auto-applied and need no pick. A grant with `level: "expertise"` grants the expertise state rather than proficiency, from the pool the rule authoring guide describes (proficiencyChoices). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<grantIndex>` (not `<featId>:<grantIndex>`).
startingEquipmentLabelNoThe chosen equipment bundle among the class's options that carry no `set` — must equal one such `class.startingEquipmentOptions[].label` exactly. Required when the class has options without a `set`; omit when every option carries a `set`.
abilityScoreAssignmentsYesFinal ability scores by ability key, every key required. Must satisfy the chosen `abilityScoreMethod` as `constants.abilityScoreMethods` describes it (still send every value you intend).
abilityScorePointBudgetNoBudget override for an ability-score method that spends a budget. Defaults to that method's budget in `constants.abilityScoreMethods`. Ignored for a method without one.
backgroundAbilityChoicesNoPicks for a choice carried by one of the background's own `abilities` (its feature). Key is the ability `_id`; value is the picked rule `_id`s. A picked rule's (or its abilities') own `choice` goes here too, keyed by that rule's `_id`.
backgroundEquipmentLabelNoThe chosen bundle among the background's `startingEquipmentOptions` that carry no `set`, when the background has such options.
backgroundBumpAssignmentsNoBackground ability-score bump per key, as `backgroundBumpMode` distributes it (each mode's amounts are the wizard constants' `backgroundBumpModeOptions`, from `vault_get_pc_creation_options` kind `constants`). Keys not bumped are omitted or 0. Only the background's `abilityScores` keys are eligible.
backgroundEquipmentChoicesNoAs `equipmentChoices`, for groups in the background's chosen equipment.
startingEquipmentSetLabelsNoFor a class whose `startingEquipmentOptions` carry a `set` number (options sharing a set are alternatives): one pick per set that has more than one option. Key is the set number as a string; value is the chosen option's `label`. A set with a single option is given to every character and takes no entry.
backgroundToolProficienciesNoThe background tool picks, when the background offers tools as a choice (`background.toolChoices`): exactly `background.toolChoices.count` names from its options (a concrete member name for a group), no duplicates.
backgroundEquipmentSetLabelsNoAs `startingEquipmentSetLabels`, for the background's `startingEquipmentOptions`.
backgroundSkillProficienciesNoThe background skill picks, when the background grants skills as a CHOICE (`background.skillChoices`). Exactly `background.skillChoices.count` names from `background.skillChoices.options`, no duplicates. Parallel to `skillProficiencies` (the class picks). Omit when the background has no `skillChoices` block; a background's fixed `skillProficiencies` are auto-applied and need no pick.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / campaignIds / description
      Previous value: -"Campaigns the new character will join, by `_id`, from play_list_joinable_campaigns for this ruleset. Each adds its house rules, spells, and items to the options."New value: +"Campaigns the new character will join, by `_id`, from play_list_joinable_campaigns for this ruleset, at most 10 (the app answers 400 for more). Each adds its house rules, spells, and items to the options."
    • changedInput schema / properties / worldIds / description
      Previous value: -"imagine Worlds the new character will join, by `_id`, from imagine_list_my_worlds (the user's own and role Worlds) and imagine_search_public_worlds (public Worlds by name). Each adds its house content and extra skills, and the stock every chosen World hides is left out of the options."New value: +"imagine Worlds the new character will join, by `_id`, from imagine_list_my_worlds (the user's own and role Worlds) and imagine_search_public_worlds (public Worlds by name). At most 10 (the app answers 400 for more). Each adds its house content and extra skills, and the stock every chosen World hides is left out of the options."
  2. Changed2 schema fields changed
    • addedInput schema / properties / campaignIds
      Added value: +{
      +  "description": "Campaigns the new character will join, by `_id`, from play_list_joinable_campaigns for this ruleset. Each adds its house rules, spells, and items to the options.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / worldIds
      Added value: +{
      +  "description": "imagine Worlds the new character will join, by `_id`, from imagine_list_my_worlds (the user's own and role Worlds) and imagine_search_public_worlds (public Worlds by name). Each adds its house content and extra skills, and the stock every chosen World hides is left out of the options.",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / backgroundFeatChoices / description
      Previous value: -"Picks for the background feat's `choice` (ruleChoice) AND for any choice carried by the feat's granted abilities. Key is the feat `_id` (its own choice) or the granted ability's `_id` (that ability's choice); value is the picked rule `_id`s."New value: +"Picks for the background feat's `choice` (ruleChoice) AND for any choice carried by the feat's granted abilities. Key is the feat `_id` (its own choice) or the granted ability's `_id` (that ability's choice); value is the picked rule `_id`s. A picked option's own sub-choices go in the proficiency/spell pick maps keyed by that option's `_id`; its (or its abilities') own `choice` goes in this map, keyed by that rule's `_id`."
  4. Changed3 schema fields changed
    • changedInput schema / properties / abilityChoices / description
      Previous value: -"Picks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability or a Feat), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat."New value: +"Picks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability or a Feat), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat. A picked option's (or its abilities') own `choice` goes in this map too, keyed by that rule's `_id`."
    • changedInput schema / properties / backgroundAbilityChoices / description
      Previous value: -"Picks for a choice carried by one of the background's own `abilities` (its feature). Key is the ability `_id`; value is the picked rule `_id`s."New value: +"Picks for a choice carried by one of the background's own `abilities` (its feature). Key is the ability `_id`; value is the picked rule `_id`s. A picked rule's (or its abilities') own `choice` goes here too, keyed by that rule's `_id`."
    • changedInput schema / properties / speciesAbilityChoices / description
      Previous value: -"Same as `abilityChoices`, for a species ability's `choice`. A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`."New value: +"Same as `abilityChoices`, for a species ability's `choice`. A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`; its (or its abilities') own `choice` goes in this map, keyed by that rule's `_id`."
  5. Changed19 schema fields changed
    • changedInput schema / properties / abilityScoreMethod / enum
      Previous value: -[
      -  "standard-array",
      -  "point-buy",
      -  "class-array"
      -]New value: +[
      +  "standard-array",
      +  "point-buy",
      +  "roll",
      +  "class-array"
      +]
    • addedInput schema / properties / abilityScoreRolls
      Added value: +{
      +  "description": "For the `roll` ability score method: one roll per ability score, each the dice faces as rolled, in the roll count, dice count, and face range this schema states. The app drops each roll's lowest faces; `abilityScoreAssignments` must assign each roll's total exactly once.",
      +  "items": {
      +    "items": {
      +      "maximum": 6,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    "maxItems": 4,
      +    "minItems": 4,
      +    "type": "array"
      +  },
      +  "maxItems": 6,
      +  "minItems": 6,
      +  "type": "array"
      +}
    • addedInput schema / properties / backgroundAbilityChoices
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for a choice carried by one of the background's own `abilities` (its feature). Key is the ability `_id`; value is the picked rule `_id`s.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / backgroundEquipmentChoices
      Added value: +{
      +  "additionalProperties": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    ]
      +  },
      +  "description": "As `equipmentChoices`, for groups in the background's chosen equipment.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / backgroundEquipmentLabel
      Added value: +{
      +  "description": "The chosen bundle among the background's `startingEquipmentOptions` that carry no `set`, when the background has such options.",
      +  "type": "string"
      +}
    • addedInput schema / properties / backgroundEquipmentSetLabels
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "As `startingEquipmentSetLabels`, for the background's `startingEquipmentOptions`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / backgroundToolProficiencies
      Added value: +{
      +  "description": "The background tool picks, when the background offers tools as a choice (`background.toolChoices`): exactly `background.toolChoices.count` names from its options (a concrete member name for a group), no duplicates.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / equipmentChoices / additionalProperties / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / equipmentChoices / additionalProperties / type
      Removed value: -"string"
    • changedInput schema / properties / equipmentChoices / description
      Previous value: -"Resolves equipment groups in the chosen bundle. Key is the group parent item `_id` (a `startingEquipmentOptions[].items[]` entry that carries `group.options`); value is the picked member `_id`. Every group in the chosen bundle needs an entry."New value: +"Resolves equipment groups in the chosen bundle or chosen set options. Key is the group parent item `_id` (a `startingEquipmentOptions[].items[]` entry that carries `group.options`); value is the picked member `_id`, or, for a group entry with a quantity above 1, a list of that many member `_id`s (one per unit, repeats allowed). Every group in the chosen options needs an entry."
    • changedInput schema / properties / ruleset / enum
      Previous value: -[
      -  "5e24"
      -]New value: +[
      +  "5th Edition",
      +  "5e24"
      +]
    • addedInput schema / properties / skillReplacements
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "Where the ruleset lets a character that gains the same skill from two sources take a different skill instead: key is the duplicated skill, value is the replacement skill the character does not already have.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / spellChoicePicks / description
      Previous value: -"Picks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<blockIndex>\"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at the starting level; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."New value: +"Picks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<blockIndex>\"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at the starting level; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A block's `addedOptions` entry (it carries `addedBy`, rule `_id`s) is a spell a rule's expanded spell list adds — a subclass's, such as a Warlock patron's: it may be picked like an option only when one of those rules is in the build (picked through `abilityChoices` or granted by a pick); otherwise vault refuses it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."
    • changedInput schema / properties / startingEquipmentLabel / description
      Previous value: -"The chosen equipment bundle — must equal one `class.startingEquipmentOptions[].label` exactly."New value: +"The chosen equipment bundle among the class's options that carry no `set` — must equal one such `class.startingEquipmentOptions[].label` exactly. Required when the class has options without a `set`; omit when every option carries a `set`."
    • addedInput schema / properties / startingEquipmentSetLabels
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "For a class whose `startingEquipmentOptions` carry a `set` number (options sharing a set are alternatives): one pick per set that has more than one option. Key is the set number as a string; value is the chosen option's `label`. A set with a single option is given to every character and takes no entry.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / startingGold
      Added value: +{
      +  "description": "true takes the class's starting gold in place of the class's AND the background's starting equipment, where the class option carries `startingGold` dice (`{ count, sides, multiplier, label }`; null or absent = the option is not offered). The character gets the rolled gold in its Gold row and no starting equipment; every proficiency, spell, and trait is unchanged. Send `startingGoldRolls` with it and omit the equipment picks.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / startingGoldRolls
      Added value: +{
      +  "description": "With `startingGold`: the faces of the class's starting gold dice as rolled — exactly `startingGold.count` whole numbers from 1 to `startingGold.sides`. The gold is their sum times `startingGold.multiplier`. Roll them yourself; vault refuses faces that do not fit the dice.",
      +  "items": {
      +    "maximum": 9007199254740991,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / toolReplacements
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "As `skillReplacements`, for a tool gained from two sources.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "ruleset",
      -  "name",
      -  "classRuleId",
      -  "abilityScoreMethod",
      -  "abilityScoreAssignments",
      -  "skillProficiencies",
      -  "toolProficiencies",
      -  "startingEquipmentLabel"
      -]New value: +[
      +  "ruleset",
      +  "name",
      +  "classRuleId",
      +  "abilityScoreMethod",
      +  "abilityScoreAssignments",
      +  "skillProficiencies",
      +  "toolProficiencies"
      +]
  6. Changed1 schema field changed
    • changedInput schema / properties / spellListChoicePicks / description
      Previous value: -"Picks for `spellListChoices` blocks (choose ONE of the block's lists, then spells from that one list). Key is `\"<ruleId>:<blockIndex>\"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` and `picks` is `{ \"<pickIndex>\": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."New value: +"Picks for `spellListChoices` blocks (choose ONE of the block's lists, then spells from that one list). Key is `\"<ruleId>:<blockIndex>\"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` (for the background's own feat, the background's `featSpellList` when it names one) and `picks` is `{ \"<pickIndex>\": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."
  7. Changed20 schema fields changed
    • changedInput schema / properties / abilityBumpPicks / description
      Previous value: -"Ability-score-increase picks for any applied rule carrying an `abilityScoreBump` (a feat / ability that raises a score by your choice — e.g. an ASI). Key is the granting rule `_id`; value is `{ option, lines }`: `option` is the 0-based index of the chosen alternative in that bump's `options` (the player picks exactly ONE — the OR), and `lines` is parallel to that option's `lines`, each entry the lowercase ability names assigned to that line (the AND). Each line needs exactly its `count` distinct abilities drawn from its `eligible` pool (empty = any of the six), none exceeding its `max`. The build bakes the increases onto the ability scores before HP, so a Constitution increase feeds level-1 HP. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`."New value: +"Ability-score-increase picks for any applied rule carrying an `abilityScoreBump` (a feat / ability that raises a score by your choice). Key is the granting rule `_id`; value is `{ option, lines }`: `option` is the 0-based index of the chosen alternative in that bump's `options` (the player picks exactly ONE — the OR), and `lines` is parallel to that option's `lines`, each entry the lowercase ability names assigned to that line (the AND). Each line needs exactly its `count` distinct abilities drawn from its `eligible` pool (empty = any ability in the schema's abilities list), none exceeding its `max`. The build bakes the increases onto the ability scores before it derives the rest of the sheet. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`."
    • changedInput schema / properties / abilityChoices / description
      Previous value: -"Picks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability like a Cleric's Divine Order → Thaumaturge, or a Feat granted 'of your choice'), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat."New value: +"Picks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability or a Feat), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat."
    • changedInput schema / properties / abilityScoreAssignments / description
      Previous value: -"Final ability scores by key, all six required. Must satisfy the chosen `abilityScoreMethod`: standard-array uses [15,14,13,12,10,8] in any order; point-buy each in 8..15 within the budget; class-array is taken from the class's defaultAbilityScores (still send the six values you intend)."New value: +"Final ability scores by ability key, every key required. Must satisfy the chosen `abilityScoreMethod` as `constants.abilityScoreMethods` describes it (still send every value you intend)."
    • changedInput schema / properties / abilityScorePointBudget / description
      Previous value: -"Point-buy budget override. Defaults to 27 (5e24). Only used for `abilityScoreMethod: 'point-buy'`."New value: +"Budget override for an ability-score method that spends a budget. Defaults to that method's budget in `constants.abilityScoreMethods`. Ignored for a method without one."
    • changedInput schema / properties / alignment / enum
      Previous value: -[
      -  "Lawful Good",
      -  "Neutral Good",
      -  "Chaotic Good",
      -  "Lawful Neutral",
      -  "Neutral",
      -  "Chaotic Neutral",
      -  "Lawful Evil",
      -  "Neutral Evil",
      -  "Chaotic Evil"
      -]New value: +[
      +  "Lawful Good",
      +  "Lawful Neutral",
      +  "Lawful Evil",
      +  "Neutral Good",
      +  "Neutral",
      +  "Neutral Evil",
      +  "Chaotic Good",
      +  "Chaotic Neutral",
      +  "Chaotic Evil"
      +]
    • changedInput schema / properties / backgroundBumpAssignments / description
      Previous value: -"Background ability-score bump per key. 'twoOne' mode: one ability +2 and a different one +1. 'oneOneOne' mode: three different abilities +1. Keys not bumped are omitted or 0. Only the background's `abilityScores` keys are eligible."New value: +"Background ability-score bump per key, as `backgroundBumpMode` distributes it (each mode's amounts are the wizard constants' `backgroundBumpModeOptions`, from `vault_get_pc_creation_options` kind `constants`). Keys not bumped are omitted or 0. Only the background's `abilityScores` keys are eligible."
    • changedInput schema / properties / backgroundBumpMode / description
      Previous value: -"Required when the background grants an ability bump. 'twoOne' = +2/+1; 'oneOneOne' = +1/+1/+1."New value: +"Required when the background grants an ability bump; each mode's amounts are the wizard constants' `backgroundBumpModeOptions`."
    • changedInput schema / properties / backgroundFeatRuleId / description
      Previous value: -"The background's Origin feat. REQUIRED when `background.featOpen` is true (an open slot — the build rejects the draft without it); optional on a fixed-feat background, where supplying it swaps the authored default. Must be an Origin-category feat (from `kind: 'feat'`)."New value: +"The background's feat, from the `originFeatCategory` feats. REQUIRED when `background.featOpen` is true (an open slot — the build rejects the draft without it); optional on a fixed-feat background, where supplying it swaps the authored default. Must be a feat in the `originFeatCategory` (from `kind: 'feat'`)."
    • changedInput schema / properties / castingAbilityPicks / description
      Previous value: -"Spellcasting-ability picks for `spellChoices` blocks that carry `castingAbilityOptions` (the lineage \"Intelligence, Wisdom, or Charisma is your spellcasting ability\" wording). Key is `\"<ruleId>:<blockIndex>\"` (same keying as `spellChoicePicks`); value is ONE lowercase ability name from that block's `castingAbilityOptions`. The projection surfaces `castingAbilityOptions` only when a pick is genuinely required (a fixed ability or a single option self-resolves server-side) — so whenever you see the array, supply a pick or the build rejects the draft. The resolved ability is stamped on each granted spell (`spells[].castingAbility`). A `repeatable` background feat prefixes the key `bg:<featId>:<blockIndex>` (same keying as spellChoicePicks)."New value: +"Spellcasting-ability picks for `spellChoices` blocks that carry `castingAbilityOptions` (a grant that lets the player choose the casting ability). Key is `\"<ruleId>:<blockIndex>\"` (same keying as `spellChoicePicks`); value is ONE lowercase ability name from that block's `castingAbilityOptions`. The projection surfaces `castingAbilityOptions` only when a pick is genuinely required (a fixed ability or a single option self-resolves server-side) — so whenever you see the array, supply a pick or the build rejects the draft. The resolved ability is stamped on each granted spell (`spells[].castingAbility`). A `repeatable` background feat prefixes the key `bg:<featId>:<blockIndex>` (same keying as spellChoicePicks)."
    • changedInput schema / properties / languages / description
      Previous value: -"The character's OWN chosen language names (e.g. ['Elvish','Draconic']). 'Common' is added server-side. `constants.languages.options` + `pickCount` are the conventional pool and count, but vault stores whatever is passed here — free-form names are allowed and the count is not enforced. (Languages a background/species GRANTS go in `languageChoicePicks`, not here.)"New value: +"The character's OWN chosen language names. The build adds any language the ruleset gives every character. `constants.languages.options` + `pickCount` are the conventional pool and count, but vault stores whatever is passed here — free-form names are allowed and the count is not enforced. (Languages a background/species GRANTS go in `languageChoicePicks`, not here.)"
    • changedInput schema / properties / preparedSpellPicks / description
      Previous value: -"Which leveled spells the player keeps prepared, for rules carrying a `preparedSpells` count. Key is the granting rule `_id`; value is spell `_id`s drawn from the character's granted leveled spells — `spellChoices` picks, whole-pool fixed grants, and `spellListChoices` picks alike — EXCLUDING spells that are already prepared: cantrips, and any spell granted by a block whose `prepared` flag is true (an always-prepared grant; the options projection ships `prepared` on each block so you can tell). The required count is the grant's count CLAMPED to that pool's size — send exactly min(count, preparable leveled spells). A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`."New value: +"Which spells the player keeps prepared, for rules carrying a `preparedSpells` count. Key is the granting rule `_id`; value is spell `_id`s drawn from the character's preparable granted spells — `spellChoices` picks, whole-pool fixed grants, and `spellListChoices` picks alike — EXCLUDING any granted by a block whose `prepared` flag is true (an always-prepared grant; the options projection ships `prepared` on each block so you can tell) and any the count does not cover (the rule authoring guide's preparedSpells section says which). The rule authoring guide.s preparedSpells section gives the required count; vault rejects picks that do not fit. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`."
    • changedInput schema / properties / proficiencyChoicePicks / description
      Previous value: -"Picks for proficiencyChoices grants across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<grantIndex>\"` (the Rule `_id` and the 0-based index into that rule's `proficiencyChoices`); value is the chosen names (skills/tools/saves/weapons/armor/languages). Only supply for grants where `count` < the option-pool size — fixed grants (count >= pool) are auto-applied and need no pick. A grant with `level: \"expertise\"` draws from the character's PROFICIENT skills (proficiency from every source applies first, then expertise), granting the expertise state rather than proficiency. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<grantIndex>` (not `<featId>:<grantIndex>`)."New value: +"Picks for proficiencyChoices grants across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<grantIndex>\"` (the Rule `_id` and the 0-based index into that rule's `proficiencyChoices`); value is the chosen names (skills/tools/saves/weapons/armor/languages). Only supply for grants where `count` < the option-pool size — fixed grants (count >= pool) are auto-applied and need no pick. A grant with `level: \"expertise\"` grants the expertise state rather than proficiency, from the pool the rule authoring guide describes (proficiencyChoices). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<grantIndex>` (not `<featId>:<grantIndex>`)."
    • removedInput schema / properties / ruleset / default
      Removed value: -"5e24"
    • changedInput schema / properties / ruleset / description
      Previous value: -"Ruleset. Only '5e24' supports guided creation today."New value: +"A ruleset with guided character creation: the one the options were read for with `vault_get_pc_creation_options`."
    • changedInput schema / properties / speciesAbilityChoices / description
      Previous value: -"Same as `abilityChoices`, for a species ability's `choice` (e.g. a Human's 'Versatile' → an Origin feat). A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`."New value: +"Same as `abilityChoices`, for a species ability's `choice`. A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`."
    • changedInput schema / properties / speciesRuleId / description
      Previous value: -"`_id` of a Species/Race rule (from `kind: 'species'`)."New value: +"`_id` of the heritage rule (from `kind: 'species'`)."
    • changedInput schema / properties / spellChoicePicks / description
      Previous value: -"Picks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<blockIndex>\"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at level 1; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."New value: +"Picks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<blockIndex>\"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at the starting level; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."
    • changedInput schema / properties / spellListChoicePicks / description
      Previous value: -"Picks for `spellListChoices` blocks (the Magic Initiate shape: choose ONE class list, then spells from that one list). Key is `\"<ruleId>:<blockIndex>\"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` and `picks` is `{ \"<pickIndex>\": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."New value: +"Picks for `spellListChoices` blocks (choose ONE of the block's lists, then spells from that one list). Key is `\"<ruleId>:<blockIndex>\"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` and `picks` is `{ \"<pickIndex>\": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`."
    • changedInput schema / properties / weaponAbilityChoices / description
      Previous value: -"For finesse weapons in the chosen bundle: key is the item `_id`, value is the attack ability ('strength' or 'dexterity')."New value: +"For a weapon in the chosen bundle whose attack ability is a player pick: key is the item `_id`, value is the attack ability (one of the schema's enum)."
    • changedInput schema / required
      Previous value: -[
      -  "name",
      -  "classRuleId",
      -  "abilityScoreMethod",
      -  "abilityScoreAssignments",
      -  "skillProficiencies",
      -  "toolProficiencies",
      -  "startingEquipmentLabel"
      -]New value: +[
      +  "ruleset",
      +  "name",
      +  "classRuleId",
      +  "abilityScoreMethod",
      +  "abilityScoreAssignments",
      +  "skillProficiencies",
      +  "toolProficiencies",
      +  "startingEquipmentLabel"
      +]
  8. Changed36 schema fields changed
    • addedInput schema / $schema
      Added value: +"http://json-schema.org/draft-07/schema#"
    • addedInput schema / additionalProperties
      Added value: +{}
    • addedInput schema / properties / abilityBumpPicks
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "lines": {
      +        "items": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "option": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "description": "Ability-score-increase picks for any applied rule carrying an `abilityScoreBump` (a feat / ability that raises a score by your choice — e.g. an ASI). Key is the granting rule `_id`; value is `{ option, lines }`: `option` is the 0-based index of the chosen alternative in that bump's `options` (the player picks exactly ONE — the OR), and `lines` is parallel to that option's `lines`, each entry the lowercase ability names assigned to that line (the AND). Each line needs exactly its `count` distinct abilities drawn from its `eligible` pool (empty = any of the six), none exceeding its `max`. The build bakes the increases onto the ability scores before HP, so a Constitution increase feeds level-1 HP. A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / abilityChoices
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for a class ability's `choice` (ruleChoice). Key is the ability rule `_id`; value is exactly `choice.count` picked option `_id`s from `choice.options`. Each option carries a `type`. When a picked option carries its OWN sub-choices (any type — an Ability like a Cleric's Divine Order → Thaumaturge, or a Feat granted 'of your choice'), supply them in `proficiencyChoicePicks` / `spellChoicePicks` / `spellListChoicePicks` / `preparedSpellPicks` keyed by the picked option's `_id`, just like the background feat.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / abilityScoreAssignments
      Added value: +{
      +  "description": "Final ability scores by key, all six required. Must satisfy the chosen `abilityScoreMethod`: standard-array uses [15,14,13,12,10,8] in any order; point-buy each in 8..15 within the budget; class-array is taken from the class's defaultAbilityScores (still send the six values you intend).",
      +  "properties": {
      +    "charisma": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "constitution": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "dexterity": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "intelligence": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "strength": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    "wisdom": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "strength",
      +    "dexterity",
      +    "constitution",
      +    "intelligence",
      +    "wisdom",
      +    "charisma"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / abilityScoreMethod
      Added value: +{
      +  "description": "How ability scores were chosen. See `constants.abilityScoreMethods` for the array / point-buy budget / costs.",
      +  "enum": [
      +    "standard-array",
      +    "point-buy",
      +    "class-array"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / abilityScorePointBudget
      Added value: +{
      +  "description": "Point-buy budget override. Defaults to 27 (5e24). Only used for `abilityScoreMethod: 'point-buy'`.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / alignment
      Added value: +{
      +  "enum": [
      +    "Lawful Good",
      +    "Neutral Good",
      +    "Chaotic Good",
      +    "Lawful Neutral",
      +    "Neutral",
      +    "Chaotic Neutral",
      +    "Lawful Evil",
      +    "Neutral Evil",
      +    "Chaotic Evil"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / appearances
      Added value: +{
      +  "description": "Appearance roster — `[{ url }]`. The portrait (`image`) is typically the default appearance.",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "url": {
      +        "description": "Image URL hosted on Embers Images (or any addressable HTTPS URL).",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / backgroundBumpAssignments
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Background ability-score bump per key. 'twoOne' mode: one ability +2 and a different one +1. 'oneOneOne' mode: three different abilities +1. Keys not bumped are omitted or 0. Only the background's `abilityScores` keys are eligible.",
      +  "properties": {
      +    "charisma": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "constitution": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "dexterity": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "intelligence": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "strength": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "wisdom": {
      +      "maximum": 2,
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / backgroundBumpMode
      Added value: +{
      +  "description": "Required when the background grants an ability bump. 'twoOne' = +2/+1; 'oneOneOne' = +1/+1/+1.",
      +  "enum": [
      +    "twoOne",
      +    "oneOneOne"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / backgroundFeatChoices
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for the background feat's `choice` (ruleChoice) AND for any choice carried by the feat's granted abilities. Key is the feat `_id` (its own choice) or the granted ability's `_id` (that ability's choice); value is the picked rule `_id`s.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / backgroundFeatRuleId
      Added value: +{
      +  "description": "The background's Origin feat. REQUIRED when `background.featOpen` is true (an open slot — the build rejects the draft without it); optional on a fixed-feat background, where supplying it swaps the authored default. Must be an Origin-category feat (from `kind: 'feat'`).",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / backgroundRuleId
      Added value: +{
      +  "description": "`_id` of a Background rule (from `kind: 'background'`).",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / backgroundSkillProficiencies
      Added value: +{
      +  "description": "The background skill picks, when the background grants skills as a CHOICE (`background.skillChoices`). Exactly `background.skillChoices.count` names from `background.skillChoices.options`, no duplicates. Parallel to `skillProficiencies` (the class picks). Omit when the background has no `skillChoices` block; a background's fixed `skillProficiencies` are auto-applied and need no pick.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / castingAbilityPicks
      Added value: +{
      +  "additionalProperties": {
      +    "enum": [
      +      "strength",
      +      "dexterity",
      +      "constitution",
      +      "intelligence",
      +      "wisdom",
      +      "charisma"
      +    ],
      +    "type": "string"
      +  },
      +  "description": "Spellcasting-ability picks for `spellChoices` blocks that carry `castingAbilityOptions` (the lineage \"Intelligence, Wisdom, or Charisma is your spellcasting ability\" wording). Key is `\"<ruleId>:<blockIndex>\"` (same keying as `spellChoicePicks`); value is ONE lowercase ability name from that block's `castingAbilityOptions`. The projection surfaces `castingAbilityOptions` only when a pick is genuinely required (a fixed ability or a single option self-resolves server-side) — so whenever you see the array, supply a pick or the build rejects the draft. The resolved ability is stamped on each granted spell (`spells[].castingAbility`). A `repeatable` background feat prefixes the key `bg:<featId>:<blockIndex>` (same keying as spellChoicePicks).",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / classRuleId
      Added value: +{
      +  "description": "Required. `_id` of a base Class rule (from `vault_get_pc_creation_options({ kind: 'class' })`).",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / description
      Added value: +{
      +  "description": "Character description / biography.",
      +  "type": "string"
      +}
    • addedInput schema / properties / equipmentChoices
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "Resolves equipment groups in the chosen bundle. Key is the group parent item `_id` (a `startingEquipmentOptions[].items[]` entry that carries `group.options`); value is the picked member `_id`. Every group in the chosen bundle needs an entry.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / image
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Character portrait — `{ url }`.",
      +  "properties": {
      +    "url": {
      +      "description": "Image URL hosted on Embers Images (or any addressable HTTPS URL).",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / languageChoicePicks
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for a background's or species' language-CHOICE grant (`background.languages.choose` / `species.languages.choose`). Key is the granting rule's `_id`; value is exactly `languages.choose.count` names from `languages.choose.options` (an empty options pool means any `constants.languages.options`). The grant's `languages.fixed` are auto-applied and need no pick. Distinct from `languages` (the character's own picks).",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / languages
      Added value: +{
      +  "description": "The character's OWN chosen language names (e.g. ['Elvish','Draconic']). 'Common' is added server-side. `constants.languages.options` + `pickCount` are the conventional pool and count, but vault stores whatever is passed here — free-form names are allowed and the count is not enforced. (Languages a background/species GRANTS go in `languageChoicePicks`, not here.)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / name
      Added value: +{
      +  "description": "Character name. Required.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / preparedSpellPicks
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "description": "Mongo `_id` reference (24-character hex string).",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Which leveled spells the player keeps prepared, for rules carrying a `preparedSpells` count. Key is the granting rule `_id`; value is spell `_id`s drawn from the character's granted leveled spells — `spellChoices` picks, whole-pool fixed grants, and `spellListChoices` picks alike — EXCLUDING spells that are already prepared: cantrips, and any spell granted by a block whose `prepared` flag is true (an always-prepared grant; the options projection ships `prepared` on each block so you can tell). The required count is the grant's count CLAMPED to that pool's size — send exactly min(count, preparable leveled spells). A `repeatable` feat filling the background slot keys `bg:<featId>` instead of `<featId>`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / proficiencyChoicePicks
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for proficiencyChoices grants across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<grantIndex>\"` (the Rule `_id` and the 0-based index into that rule's `proficiencyChoices`); value is the chosen names (skills/tools/saves/weapons/armor/languages). Only supply for grants where `count` < the option-pool size — fixed grants (count >= pool) are auto-applied and need no pick. A grant with `level: \"expertise\"` draws from the character's PROFICIENT skills (proficiency from every source applies first, then expertise), granting the expertise state rather than proficiency. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<grantIndex>` (not `<featId>:<grantIndex>`).",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / ruleset
      Added value: +{
      +  "default": "5e24",
      +  "description": "Ruleset. Only '5e24' supports guided creation today.",
      +  "enum": [
      +    "5e24"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / skillProficiencies
      Added value: +{
      +  "description": "The class skill picks. Exactly `class.skillChoices.count` names, each from `class.skillChoices.options`, no duplicates. Empty array if the class grants no skill choices.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / speciesAbilityChoices
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Same as `abilityChoices`, for a species ability's `choice` (e.g. a Human's 'Versatile' → an Origin feat). A picked option's own sub-choices (any type — Ability or Feat) go in the proficiency/spell pick maps keyed by that option's `_id`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / speciesRuleId
      Added value: +{
      +  "description": "`_id` of a Species/Race rule (from `kind: 'species'`).",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / spellChoicePicks
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "description": "Mongo `_id` reference (24-character hex string).",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "Picks for `spellChoices` blocks across ALL applied rules (class/species/feat/abilities). Key is `\"<ruleId>:<blockIndex>\"` (the Rule `_id` and the 0-based index into that rule's `spellChoices` AS PROJECTED — the array may contain null entries holding the position of blocks that grant nothing at level 1; count them when indexing, never compact the array). Value is the chosen spell `_id`s. Only supply where a block's `count` < its option-pool size — a whole-pool block is granted automatically. Each block's options come from `vault_get_pc_creation_options` (an applied ability/feat's `spellChoices[].options`). A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / spellListChoicePicks
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "castingAbility": {
      +        "enum": [
      +          "strength",
      +          "dexterity",
      +          "constitution",
      +          "intelligence",
      +          "wisdom",
      +          "charisma"
      +        ],
      +        "type": "string"
      +      },
      +      "category": {
      +        "type": "string"
      +      },
      +      "picks": {
      +        "additionalProperties": {
      +          "items": {
      +            "description": "Mongo `_id` reference (24-character hex string).",
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "description": "Picks for `spellListChoices` blocks (the Magic Initiate shape: choose ONE class list, then spells from that one list). Key is `\"<ruleId>:<blockIndex>\"` (the projected array may contain null entries holding the position of blocks the build skips — count them when indexing, never compact); value is `{ category, picks }` where `category` is one of the block's `categories` and `picks` is `{ \"<pickIndex>\": [spellId, …] }` — the chosen spells for each pick, drawn from that pick's `optionsByCategory[category]`. When the block carries `castingAbilityOptions`, also set `castingAbility` (one lowercase ability name from those options) — the build rejects the draft without it. A `repeatable` feat filling the background slot prefixes its keys `bg:<featId>:<blockIndex>`.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / startingEquipmentLabel
      Added value: +{
      +  "description": "The chosen equipment bundle — must equal one `class.startingEquipmentOptions[].label` exactly.",
      +  "type": "string"
      +}
    • addedInput schema / properties / token
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Default battlemap token art — `{ url }`.",
      +  "properties": {
      +    "url": {
      +      "description": "Image URL hosted on Embers Images (or any addressable HTTPS URL).",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / toolProficiencies
      Added value: +{
      +  "description": "The class tool picks. Exactly `class.toolChoices.count` names from `class.toolChoices.options`. If an option is a group, pick a concrete member name, not the group. Empty array if none.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / weaponAbilityChoices
      Added value: +{
      +  "additionalProperties": {
      +    "enum": [
      +      "strength",
      +      "dexterity"
      +    ],
      +    "type": "string"
      +  },
      +  "description": "For finesse weapons in the chosen bundle: key is the item `_id`, value is the attack ability ('strength' or 'dexterity').",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / required
      Added value: +[
      +  "name",
      +  "classRuleId",
      +  "abilityScoreMethod",
      +  "abilityScoreAssignments",
      +  "skillProficiencies",
      +  "toolProficiencies",
      +  "startingEquipmentLabel"
      +]
  9. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Beyond the annotations, it discloses that validation checks user, stock, campaign, and World content; that the character joins chosen campaigns and Worlds during creation; and that a lost join context fails the whole build with CREATION_CONTEXT_LOST and creates nothing. It also states invalid drafts return specific tool errors and that the created character is owned by the caller and returned in full.

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

Conciseness3/5

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

The purpose and prerequisite are front-loaded, but the remaining text is a dense single paragraph with very long semicolon-linked clauses covering many conditional paths. Most details are relevant for a 46-parameter tool, yet the lack of structure and repeated schema-level information make it harder to scan than it needs to be.

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

Completeness5/5

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

For a complex guided character builder, the description covers the full workflow, conditional ruleset branches, campaign and World behavior, failure modes, and required keying conventions. An output schema exists, and the description still appropriately notes that the created character is returned in full.

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

Parameters5/5

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

Even with 98% schema coverage, the description adds substantial cross-parameter meaning: exact required combinations, the `"<ruleId>:<grantIndex>"` key formats, null entries in projected arrays, `bg:<featId>` prefixes for repeatable background feats, and when `castingAbilityPicks` is mandatory. These are not available from per-parameter schema text alone.

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

Purpose5/5

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

The description uses a specific verb and resource: 'Assemble a complete, playable player character in one call from a flat draft of choices.' It also scopes the operation to rulesets with guided creation and clarifies that `vault_get_pc_creation_options` supplies the legal ids, making its role distinct from the sibling options-reader.

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

Usage Guidelines4/5

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

It explicitly instructs the agent to read `vault_get_pc_creation_options` first and enumerates required and conditionally required inputs. It does not explicitly contrast this tool with `vault_create_character` or another build alternative, so it stops short of full when/when-not guidance.

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