The Dice capability adds RPG-style dice rolling to your bot. Users can roll dice using standard tabletop notation with modifiers and keep-highest/keep-lowest options.
Commands
!BotName roll <notation> !BotName roll (uses default notation)
Dice Notation
| Notation | Description | Example |
|---|---|---|
NdS |
Roll N dice with S sides | 2d6 |
dS |
Roll 1 die with S sides | d20 |
NdS+M |
Add modifier M | d20+5 |
NdS-M |
Subtract modifier M | d8-2 |
NdSkhK |
Keep highest K dice | 4d6kh3 |
NdSklK |
Keep lowest K dice | 2d20kl1 |
Configuration
Admins can configure the Dice capability using /bot set:
dice_max_dice— Maximum number of dice per roll (default: 100)dice_max_sides— Maximum sides per die (default: 1000)dice_default— Default notation when no argument given (default: d20)
/bot set MyBot dice_max_dice 20 /bot set MyBot dice_max_sides 100
Examples
!MyBot roll 2d6+3 → [4, 2] + 3 = 9 !MyBot roll 4d6kh3 → [6, 4, 3, 1] keep [6, 4, 3] = 13 !MyBot roll d20 → [17] = 17 !MyBot roll → (uses default notation)