Skip to content

Roll Command

Roll dice using standard dice notation.

Usage

/roll expression:<string> count:<1-10>

Description

The roll command allows you to roll any dice expression. The optional count parameter lets you roll the same expression multiple times (1-10), replacing the old !rr multi-roll command.

Options

  • expression - Any valid dice expression (e.g., 1d20, 2d6+5, 1d20+1d4)
  • count - Number of times to roll the expression (1-10, defaults to 1)

Examples

Basic Rolls

/roll expression:1d20
/roll expression:2d6
/roll expression:1d100

With Modifiers

/roll expression:1d20+5
/roll expression:2d6+3
/roll expression:1d20-2

Complex Expressions

/roll expression:1d20+1d4
/roll expression:2d6+1d8+5
/roll expression:1d20+1d6+2

Multiple Rolls

/roll expression:1d20 count:3         # Roll 1d20 three times
/roll expression:2d6+5 count:5        # Roll 2d6+5 five times
/roll expression:1d20+1d4 count:2     # Roll 1d20+1d4 twice

With Comments

/roll expression:1d20+3 # attack roll
/roll expression:2d6+5 # damage
/roll expression:1d20 # initiative

Features

  • Critical detection: Automatically detects critical hits (20) and critical misses (1)
  • Comment support: Add comments after # to label your rolls
  • Complex expressions: Support for multiple dice types and modifiers
  • Multi-roll: Use count to roll the same expression up to 10 times

Integration

The roll command is the foundation for other roll-based commands: - /attack - Uses roll for attack and damage - /cast - Uses roll for spell casting - /check - Uses roll for ability checks

Legacy Prefix Commands

The prefix command syntax still works but will be removed in a future update:

Legacy Syntax Slash Equivalent
!roll 1d20 or !r 1d20 /roll expression:1d20
!roll 2d6+5 /roll expression:2d6+5
!rr 3 1d20 /roll expression:1d20 count:3
!rr 5 2d6+5 /roll expression:2d6+5 count:5