update_character
Modify character attributes, ability scores, conditions, proficiencies, languages, and features in Dungeons & Dragons campaigns to reflect gameplay changes and progression.
Instructions
Update a character's properties.
Supports scalar field updates, ability score changes, and list add/remove operations for conditions, proficiencies, languages, and features. List parameters accept JSON arrays (e.g. '["poisoned","prone"]') or comma-separated strings (e.g. 'poisoned,prone').
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name_or_id | Yes | Character name, ID, or player name. | |
| name | No | New character name. If you change this, you must use the character's ID to identify them. | |
| player_name | No | The name of the player in control of this character | |
| description | No | A brief description of the character's appearance and demeanor. | |
| bio | No | The character's backstory, personality, and motivations. | |
| background | No | Character background | |
| alignment | No | Character alignment | |
| hit_points_current | No | Current hit points | |
| hit_points_max | No | Maximum hit points | |
| temporary_hit_points | No | Temporary hit points | |
| armor_class | No | Armor class | |
| experience_points | No | Experience points | |
| speed | No | Movement speed in feet | |
| character_level | No | Set the primary class level directly (e.g. to downgrade to level 1). Recalculates proficiency bonus automatically. | |
| hit_dice_remaining | No | Remaining hit dice, e.g. '1d8' or '3d10'. Use after a level change or manual rest. | |
| inspiration | No | Inspiration status | |
| notes | No | Additional notes about the character | |
| strength | No | Strength score | |
| dexterity | No | Dexterity score | |
| constitution | No | Constitution score | |
| intelligence | No | Intelligence score | |
| wisdom | No | Wisdom score | |
| charisma | No | Charisma score | |
| add_conditions | No | JSON list of conditions to add, e.g. '["poisoned","prone"]' | |
| remove_conditions | No | JSON list of conditions to remove | |
| add_skill_proficiencies | No | JSON list of skill proficiencies to add | |
| remove_skill_proficiencies | No | JSON list of skill proficiencies to remove | |
| add_tool_proficiencies | No | JSON list of tool proficiencies to add | |
| remove_tool_proficiencies | No | JSON list of tool proficiencies to remove | |
| add_languages | No | JSON list of languages to add | |
| remove_languages | No | JSON list of languages to remove | |
| add_saving_throw_proficiencies | No | JSON list of saving throw proficiencies to add | |
| remove_saving_throw_proficiencies | No | JSON list of saving throw proficiencies to remove | |
| add_features_and_traits | No | JSON list of features/traits to add | |
| remove_features_and_traits | No | JSON list of features/traits to remove | |
| player_id | No | Player ID for permission check (omit for single-player DM mode) |