The general form for dice rolls is:

The parameters in { } curly brackets are optional. Specifying "sets" indicates that you want to roll multiple groups of dice and get the results of each group displayed separately. You must follow the number of sets with a pound sign.

[dice expression] is any combination of dice rolls and arithmetic operations. Addition, subtraction, multiplication and integer division are supported. Multiplication has higher precedence than addition. You can use parentheses to specify operator precedence (think algebra). A dice roll has the form NdS where N is the number of dice and S is the number of sides. N defaults to 1 if unspecified.

Example 1

<Player> roll d6

<dicebot> Player rolled : d6 --> [ 1d6=1 ]{1}

<Player> roll 2#3d6

<dicebot> Player rolled 2#3d6 --> [ 3d6=16 ]{16}, [ 3d6=14 ]{14}

<dicebot> Player rolled : d6 --> [ 1d6=1 ]{1}

<Player> roll 2#3d6

<dicebot> Player rolled 2#3d6 --> [ 3d6=16 ]{16}, [ 3d6=14 ]{14}

You can use the symbols +, -, *, and / to apply arithmetic operations to dice commands. The operands can be constants or more dice groups:

Example 2

<Player> roll 1d20+5-1d4*2

<dicebot> Player rolled 1d20+5-1d4*2 --> [ 1d20=4 1d4=1 ]{7}

<Player> roll 1d6+2#(1d10+(1d6/2))*3

(long list of results omitted)

<dicebot> Player rolled 1d20+5-1d4*2 --> [ 1d20=4 1d4=1 ]{7}

<Player> roll 1d6+2#(1d10+(1d6/2))*3

(long list of results omitted)

Ok that last one is pretty ridiculous, I just threw it in to demonstrate that the roller basically works like a calculator.

Finally, you may specify an optional description following the dice commands, which will be echoed in the output.

Example 3

<Player> roll d20+3 attempting to slash an orc

<dicebot> Player rolled d20+3 attempting to slash an orc --> [ 1d20=3 ]{6}

<dicebot> Player rolled d20+3 attempting to slash an orc --> [ 1d20=3 ]{6}

If you want to send the results of a roll privately to someone, the syntax is:

where the suggestively named words inside brackets are replaced with the actual information they allude to.

Example

/msg dicebot sendroll theGM 1d20+4 trying to psionically explode a monkey

Here "dicebot" is the dicebot's nick, and "theGM" is the person you want to send the roll to.