Rolling

AutoDice uses a simple command syntax to handle everything from basic rolls to complex tabletop mechanics. To trigger the bot, start your message with @AutoDice.

This documentation site offers a detailed explanation for building a command. If you ever need a refresher, then you can come back here or use @AutoDice help.

Basic Rolls

The core syntax follows the standard [quantity]d[sides] format.

  • Single Die: @AutoDice d6 (Rolls one 6-sided die)
  • Multiple Dice: @AutoDice 10d6 (Rolls ten 6-sided dice)
  • Repeated Sets: @AutoDice 5 10d6 (Rolls ten 6-sided dice, repeating five times)

Special Dice

  • Percentile: @AutoDice d% acts as shorthand for d100.
  • Fate/Fudge Dice: @AutoDice 4dF rolls four Fate dice, each returning +, ▯, or − (−1 to +1).

Arithmetic & Modifiers

You can apply maths to your total results using standard operators: +, -, * (or x), and /.

For example, @AutoDice 10d6 + 5.

Advanced Mechanics

Suffixes allow you to modify how dice behave or how results are displayed. They can be chained together: 5d20kl2r<4.

  • Sorting: Use s or sa to sort results in ascending order, or sd for descending order. For example, @AutoDice 10d6sd.

  • Keep Highest/Lowest: Use kh[n] to keep the highest n results or kl[n] to keep the lowest n results. For example, @AutoDice 2d20kh1 (Advantage).

  • Drop Highest/Lowest: Use dh[n] to drop the highest n results or dl[n] to drop the lowest n results. For example, @AutoDice 4d6dl1 (the classic D&D stat roll).

  • Exploding Dice: Use ! to roll an additional die whenever the maximum value is rolled. Explosions can chain up to 10 times. For example, @AutoDice 5d10!.

  • Rerolling: Use r<[n] or r>[n] to reroll any dice that fall below or exceed a specific value. Use r[n] to reroll an exact value. For example, @AutoDice 5d6r<3.

  • Success Counting: Use >[n] to count how many dice meet or exceed a target. Each success becomes 1, each failure 0. For example, @AutoDice 5d10>7.

  • Fail Counting: Use <[n] to count how many dice fall below a target. Each failure becomes 1, each success 0. For example, @AutoDice 5d10<3.

Advantage & Disadvantage

As a convenience, adv and dis are shorthand for the most common keep expressions:

  • @AutoDice adv expands to 2d20kh1
  • @AutoDice dis expands to 2d20kl1
  • Modifiers carry through: @AutoDice adv + 5 becomes 2d20kh1 + 5

Labeled Rolls

Add descriptive text after your roll formula to label the result. Everything after the formula is treated as the label:

@AutoDice 1d20+5 Stealth check
@AutoDice 4d6dl1 Fireball

Privacy

If you need to hide your rolls from the channel, use a privacy prefix. The bot will send the results directly to your DMs. The supported prefixes are: dm, secret, priv, or private.

For example, @AutoDice secret 10d6.