# help

dRoller is very straight forward. All you need to do is to tell it how many dice you want to roll, the kind of the die being rolled and what options should apply:

1d6 | rolls a six-sided die |

4d2 | throws a coin four times |

2d4+8 | rolls two four-sided dice and add eight to the total |

1d20@18 | rolls a twenty-sided die and keep rerolling for each result of eighteen or more |

2d12#8 | rolls two twelve-sided dice and counts a success for each result of eight or more |

5d10#6~1 | rolls five ten-sided dice, counts a success for each result of six or more and negates a success (botch) for each result of one |

12d10#8@10 | rolls twelve ten-sided dice, counts a success for each result of eight or more and keep rerolling for each result of ten |

The table above gives you a good idea of dRoller's versatility. Keep reading for the full reference.

## syntax:

##### [pool]**d**[die]*{[option]{comparison}[die number]}{[arithmetics][number]}*

### pool

The number of dice to be rolled.

The valid range is: [1; 99].

### d

The poll-die separator.

Low cased only! This way one may type any roll with "D" as an example, without rolling it (i.e. 1D4, 8D10#9@10).

### die

The number of faces of the die to be rolled as listed bellow:

- 2 -
*the coin* - 4 -
*the tetrahedron* - 6 -
*the cube* - 8 -
*the octahedron* - 10 -
*the pentagonal dipyramid* - 12 -
*the dodecahedron* - 20 -
*the icosahedron* - 100 -
*the zocchihedron or percentile die*

### option

There are three options:

- @ - reroll
- # - target number
- ~ - botch

The reroll (@) and target number (#) __may__ be combined or not.

The botch (~) __must__ be combined with target number (#).

A given option, if present, can appear only once on a given roll. All three options may be combined according with the rules above.

### comparison

Every option support those comparison operators:

- = : equal to
- > : greater than
- < : lesser than
- >= : greater or equal to
- <= : lesser or equal to

If missing, default operators will be used as bellow:

- @{>=}
- #{>=}
- ~{<=}

### die number

A valid number into the die range: [1; die].

Due to infinite loops, the die number is restricted to the reroll (@) option, as bellow:

Even with the above limits if any single roll would give you more than 1000 results then the entire post will be aborted.

### arithmetics

A roll may have one arithmetical operator, as bellow:

- + -
*addition* - - -
*subtraction* - * -
*multiplication* - / -
*division*

### number

The value to be evaluated with the **total** according to the arithmetical operator being used.

The valid range is [1; 99].

The arithmetical operation must be always on the final portion of the roll if combined with one or more options.

## total:

The total reflects the type of the roll.

If it is a target roll, then it will display successes *minus* botches; otherwise it will display the plain sumatory of dice.

A success occurs when a roll result satisfies the target number option.

A botch occurs when a roll result satisfies the botch option.

## version history

### v1.x

- 05/07/2013 v1.8 - renamed to dRoller
- 29/06/2013 v1.7 - spam filter
- 12/12/2012 v1.6 - system upgrade
- 17/12/2011 v1.5 - 1000 results per roll limit
- 15/12/2011 v1.4 - refreshable pagination
- 05/12/2011 v1.3 - localization available (en, pt-BR)
- 30/11/2011 v1.2 - pagination available
- 29/11/2011 v1.1 - help available
- 28/11/2011 v1.0 - complex options (@#~+-/*) added

### v0.x

- 17/02/2011 v0.3 - nice roll layout
- 10/02/2011 v0.2 - dice rolling on guestbook
- 08/02/2011 v0.1 - guestbook
- 31/01/2011 v0.0 - start up