Level up a 5e24 player character
vault_level_up_pcAdvance a 5e24 character one level in a class, in one call, from a flat draft of choices. A class-less character (no Class entries) is rejected — record its existing classes with vault_record_pc_classes first. Vault validates every pick against the plan's pools (prerequisites enforced; grown choices demand only their delta counts) and mutates the character: the class entry's stored level bumps (or a new class entry lands at level 1 with the restricted multiclass proficiency set — no saves, no equipment), the level's features snapshot onto the sheet (a subclass picked through the class's subclass-choice ability lands as its own Origin entry and cascades its features), ability-score increases bake (Constitution raises HP retroactively), HP and hit dice grow (average or the player's roll + Constitution), use-counters resize (spent uses stay spent), the combined multiclass spell-slot pool reconciles when 2+ classes contribute (Pact Magic stays separate), core.class updates to " , ...", XP floors at the new level's minimum (or your exact xp), and a level-up note records the choices. Read vault_get_levelup_options first — required: characterId, classRuleId, hitPoints. Supply abilityChoices for every feature choice the plan surfaced (the subclass pick at 3, the ASI's feat at 4+, grown invocation lists), the sub-pick maps for anything the picked options themselves carry, multiclassSkillProficiencies/multiclassToolProficiencies when entering a class, and optional exact xp. The updated character and a summary of what changed are returned. On an invalid draft vault returns the specific reason as a tool error — fix the draft and retry; if a surfaced pick genuinely cannot be satisfied, allowIncomplete: true applies the level and skips the shortfall instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||