roll
Roll dice using standard RPG notation and get the total result. Use for attack rolls, damage, ability checks, and saving throws in tabletop games.
Instructions
Roll dice using standard RPG notation and return the total result.
PURPOSE: Use this tool when you need a quick dice roll with just the total numeric result and a formatted output string. This is the most common tool for standard RPG scenarios like attack rolls, ability checks, saving throws, and damage calculations.
WHEN TO USE:
Making attack rolls (1d20+5)
Rolling damage (2d6+3, 8d6)
Ability checks and saves (1d20+modifier)
Any roll where you just need the total
Quick single rolls without needing detailed breakdown
WHEN NOT TO USE:
If you need to see individual die results, use roll_detailed instead
If you need to make multiple different rolls, use roll_batch instead
If you just want to validate syntax without rolling, use validate_syntax instead
SUPPORTED NOTATION:
Basic: 1d20, 3d6, d20 (equivalent to 1d20)
Arithmetic: 1d20+5, 2d6-1, 3d6*2, 1d20/2
Keep highest/lowest: 4d6kh3 (keep highest 3), 4d6kl1 (keep lowest 1)
Drop: 4d6p1 (drop lowest 1, equivalent to kh3)
Reroll: 1d20rr<10 (reroll until ≥10), 1d20ro1 (reroll 1s once)
Exploding: 1d6e (explode on max), 1d6e6 (explode on 6)
Min/Max: 1d20mi10 (minimum 10), 1d20ma20 (maximum 20)
Complex: (1d4+1)*2, (1d6, 3, 2d4)
COMMON EXAMPLES:
D&D Attack Roll: "1d20+5" → Check if hits AC
Ability Score: "4d6kh3" → Roll 4d6, keep highest 3
Fireball Damage: "8d6" → Total fire damage
Sneak Attack: "1d20+7" for attack, then "1d6+3d6" for damage
Critical Hit: "2d8+6" (doubled dice)
With Advantage: "2d20kh1" (roll 2d20, keep highest)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expression | Yes | Dice expression to evaluate (e.g., '1d20+5', '4d6kh3') | |
| allow_comments | No | Allow comments after the expression (e.g., '1d20 fire damage') |