Multi-Roll Command¶

Roll dice multiple times with a single command.

Usage¶

!multiroll <iterations> <dice expression>

Shorthand is !rr

Description¶

The multi-roll command allows you to roll the same dice expression multiple times with a single command. Each roll is clearly labeled and displayed separately, making it easy to see all results at once.

Format¶

<iterations>: Number of times to roll (1-10)
<dice expression>: Any valid dice expression supported by the roll command

Examples¶

Basic Multi-Roll¶

!rr 3 1d20

Result:

🎲 **Roll by User**: `1d20 Result 1`
**Result 1**: 1d20 (15) = 15
**Total**: 15

🎲 **Roll by User**: `1d20 Result 2`
**Result 2**: 1d20 (8) = 8
**Total**: 8

🎲 **Roll by User**: `1d20 Result 3`
**Result 3**: 1d20 (19) = 19
**Total**: 19

Complex Dice Expressions¶

!rr 5 2d6+5

Rolls two 6-sided dice plus 5, five times.

Multiple Dice Types¶

!rr 2 1d20+1d4

Rolls a 20-sided die and a 4-sided die, twice.

With Comments¶

!rr 3 1d20+3 # attack roll

Each roll will be labeled as "Result 1", "Result 2", etc., but the original comment is preserved.

Limitations¶

Maximum iterations: 10 rolls per command (to prevent spam)
Minimum iterations: 1 roll
Fallback behavior: If the format is invalid, falls back to regular roll command

Error Handling¶

Too many iterations: Shows error message if you try more than 10 rolls
Invalid format: Falls back to regular roll command if the format doesn't match
Zero or negative: Shows error for invalid iteration counts

Integration¶

The multi-roll command: - Uses the same dice engine as the regular roll command - Supports all dice expressions that work with !roll - Includes critical hit/miss detection for each roll - Preserves comments and modifiers from the original expression - Works with all existing roll features (advantage, disadvantage, etc.)

Use Cases¶

Initiative rolls: !rr 5 1d20+2 for multiple NPCs
Damage rolls: !rr 3 2d6+3 for area effects
Skill checks: !rr 4 1d20+5 for group activities
Random tables: !rr 10 1d100 for random selection