Dice Expressions

The following dice expressions are supported.

This notation can be used when creating rolls for actions on character sheets. It can also be used after a /roll or /r prefix in chat messages for ad-hoc rolls.

Any notation with letters is case insensitive. eg. 3d6k is equivalent to 3D6K.

Basic notation

Roll dice X number of dice with Y number of faces. Also supports percentile (%) and fudge (F) dice.

Notation	Example	Description	Rolls	Result
dY	`d6`	Rolls 1 6-sided dice	`[4]`	4
XdY	`4d8`	Rolls 4 8-sided dice	`[2, 6, 8, 6]`	22
XdY	`5d20`	Rolls 5 20-sided dice	`[6, 17, 13, 19, 10]`	65
Xd%	`2d%`	Rolls 2 100-sided dice	`[66, 77]`	143
XdF	`7dF`	Rolls 7 fudge dice	`[-1, -1, 0, -1, -1, 1, 0]`	-3
Xdf	`7df`	Rolls 7 fudge dice	`[-1, -1, 0, -1, -1, 1, 0]`	-3

Keep dice

K - Keep the N highest rolled dice, or omit N to keep only the highest roll. Equivalent to DnD5e Advantage when used with two d20’s.
KL - Keep the N lowest rolled dice, or omit N to keep only the lowest roll. Equivalent to DnD5e Disadvantage when used with two d20’s.

Notation	Example	Description	Rolls	Result
XdYk	`2d20k`	Rolls 2 20-sided dice, keeps highest	`[6, 17]`	17
XdYkN	`7d20k4`	Rolls 7 20-sided dice, keeps 4 highest	`[6, 17, 13, 19, 10, 8, 2]`	59
XdYkl	`2d20kl`	Rolls 2 20-sided dice, keeps lowest	`[6, 17]`	6
XdYklN	`7d20kl4`	Rolls 7 20-sided dice, keeps 4 lowest	`[6, 17, 13, 19, 10, 8, 2]`	26

Count dice

Count the number of successes with # or s. Both are equivalent.

A roll is counted as a success when it is greater than or equal to N. If N is omitted, then only the max dice roll is considered a success.

Notation	Example	Description	Rolls	Result
XdY#	`6d6#`	Rolls 6 6-sided dice, counts how many roll the max value	`[4, 1, 5, 1, 4, 6]`	1
XdY#N	`4d6#4`	Rolls 4 6-sided dice, counts how many roll 4 or more	`[4, 1, 5, 1]`	2
XdYs	`10d6s`	Rolls 10 6-sided dice, counts how many roll the max value	`[4, 1, 5, 1, 4, 6, 2, 4, 3, 4]`	1
XdYs	`10dFs`	Rolls 10 fudge dice, counts how many roll the max value	`[-1, -1, 0, -1, -1, 1, 0, -1, 1, -1]`	2
XdYsN	`10d6s3`	Rolls 10 6-sided dice, counts how many roll 3 or more	`[4, 1, 5, 1, 4, 6, 2, 4, 3, 4]`	7

Combine conditions

Conditions can be combined in a single expression. Conditions are applied sequentially from left to right.

Notation	Example	Description	Rolls	Result
XdYkNsM	`6d20k4s12`	Rolls 6 20-sided dice, keeps 4 highest, counts how many roll 12 or more	`[6, 17, 13, 19, 10, 8]`	3

Combine expressions

Expressions can also be combined with basic mathematical operators.

For example:

6d20k4s12 + d20s12

Would roll 6 20-sided dice, keep the 4 highest, and count how many rolled 12 or more. Then would roll another 20-sided die and if it was 12 or more, would add 1 to the total number of successes.

[6, 17, 13, 19, 10, 8], [2]

Resulting in 3

Note: currently operations are executed in order. i.e. does not follow BODMAS/BIDMAS, and does not respect parenthesis () for order of expressions yet.

Some more examples of basic expression combination are listed below. Constant values can be used in expression arithmetic.

Example	Rolls / Components	Result
`d6 + 3`	`[4], [3]`	7
`4d8 - 5`	`[2, 6, 8, 6], [5]`	17
`5d20 + d4`	`[6, 17, 13, 19, 10], [2]`	67
`2d% / 2`	`[66, 77], [2]`	71
`d6 + dF`	`[4], [-1]`	3
`2d20k + 18`	`[6, 17], [18]`	35
`7d8k4 * 2`	`[2, 6, 8, 6, 7, 3, 8], [2]`	58
`2d6 + 4 * 2`	`[4, 1], [4], [2]`	18