Roll Formulas
A flexible dice notation that supports a wide range of dice rolling notations and modifiers.
How Roll Formulas Are Evaluated
Every roll formula, no matter how complex, is ultimately evaluated to a single numeric value. All the features and modifiers described in this documentation change how the values of the dice rolls are interpreted and combined to produce that final result.
For example:
A simple roll like `3d6` will sum the results of three six-sided dice.
A success modifier like `5d10>7` will roll five ten-sided dice, and for each die, if it shows 7 or higher, it counts as a "success" (1), otherwise as a "failure" (0). The final value is the total number of successes (i.e., the sum of 1s and 0s).
Other modifiers (keep, drop, reroll, explode, etc.) change which dice are counted, how many times dice are rolled, or how the results are combined, but the end result is always a single number.
This means you can use roll formulas anywhere a number is expected, including inside math expressions, comparisons, or as arguments to functions.