combat_action
Resolve weapon attacks and saving throw spells in D&D 5e campaigns. Applies damage to target HP, triggers concentration checks, and returns formatted mechanical outcomes for combat actions.
Instructions
Resolve a combat action via the pipeline, apply results, and return a formatted outcome.
Supports weapon attacks (melee/ranged) and saving throw spells. Automatically applies damage to the target's HP, triggers concentration checks, and reports the full mechanical outcome. This is additive -- it does not replace manual roll_dice workflows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| attacker | Yes | Name of the attacking character or NPC | |
| target | Yes | Name of the target character or NPC | |
| action_type | No | Action type: 'attack' for weapon/melee/ranged, 'save_spell' for saving throw spells | attack |
| weapon_or_spell | No | Weapon name (from inventory) or spell name. None uses equipped main weapon. | |
| damage_dice | No | Override damage dice (e.g., '8d6' for fireball). Only for save_spell actions. | |
| damage_type | No | Damage type (e.g., 'fire', 'slashing'). Only for save_spell actions. | |
| save_ability | No | Saving throw ability (e.g., 'dexterity'). Required for save_spell actions. | |
| half_on_save | No | Whether successful save deals half damage. Only for save_spell actions. | |
| spell_dc | No | Override spell save DC. Only for save_spell actions. |