Syntax
Two ways to roll: the prefix (like !r) or the /roll slash command. Here's everything the bot understands.
The basics
- Rolls a single 20-sided die. Exactly the same as /roll 1d20.
- The 1 is optional: d20 is one 20-sided die.
- Rolls a few dice at once. 2d6 is two six-sided dice.
- Adds or subtracts a flat number.
- Mixes different dice and modifiers in the same roll.
- Spaces and capitals are fine: this is the same roll as 1d20+5.
Keep and drop
- Keeps the 3 highest dice (kh). The usual way to roll up stats.
- Drops the lowest die (dl).
- Drops the highest die (dh).
Advantage and disadvantage
Two ways to write it: keep the better of two dice yourself, or add the word after a roll of one die.
- Advantage: rolls two d20 and keeps the higher one. With no number after kh, it keeps one die.
- Disadvantage: keeps the lower of the two (kl).
- Advantage in a word: adv (or advantage) after a roll of one die rolls it twice and keeps the higher, here 2d20kh+5. dis (or disadvantage) keeps the lower.
- The word works in front of the roll too.
- Each language's word works: advantage, avantage, Vorteil, ventaja, and for the lower die disadvantage, désavantage, Nachteil, desventaja.
- Only on a roll of one die: on several dice it has no single meaning, so the bot refuses and shows how to say which dice to keep, like 4d6kh3.
Exploding dice
- Exploding dice: any die landing on its maximum is rolled again and added to itself.
- Explodes and keeps the best three. The exploded die counts as one die, worth its total.
Repeating a roll
- Rolls the whole expression several times. The 6# here gives you six stat lines.
- N# goes with everything else: three attacks with advantage.
Names, default roll and aliases
The last five need your server's default roll or your own aliases, which the demo above doesn't have.
- Add a name after the roll and it shows up on the result.
- On its own it falls back to the server's default roll, if one was set.
- A bare modifier is added to the default roll: with 1d20 as the default, this rolls 1d20+5.
!r +5 - A name alone rolls the default roll under that name.
!r Goblin - adv alone rolls the default roll with advantage, when it is a single die.
!r adv - Rolls one of your aliases, saved with /alias.
!r perception - An alias is part of the roll: a bonus, 2# in front or adv after it all work.
!r perception+2
Chances
- Your chances of reaching 15 or more, without rolling anything. <=, >, <, =, ≥ and ≤ work too, and so does adv.
!prob 1d20+5 >= 15
Coming from another bot
Typed the way another bot or table writes it? The bot answers with the spelling that works here. Click one to see its answer in the demo.
- →k without h, as in Roll20, Foundry and Dice Maiden.
4d6kh3 - →d and a number to drop the lowest dice.
4d6dl1 - →Percentile dice.
1d100 - →Roll20's compounding !!: a single ! here already adds the new roll to the die.
d6! - →x2 to roll the same thing twice.
2#3d6 - →A suffix typed after a space.
4d6kh3 - →A number to reach: that's a question for !prob.
!prob 1d20>=15 - Multiplying or dividing: only + and - work in a roll, so nothing is rolled.
Limits
A couple of limits keep things sane: 20 rolls at most, 100 characters per command. Keep and drop also have to leave you at least one die. A term holds at most 100 dice, a die at most 99,999 faces, a modifier goes up to 1,000,000, and a die explodes at most 10 times in a row.