This commandline based program rolls a userdefined dice sequence and displays the result. The dices to roll are defined using dN where N is the number of sides. Dices can be rolled multiple times by prepending the number of repetitions (e.g., 3d6) and used in simple mathematical expressions (e.g., 2d8+4).
If you find roll useful you can help with a small contribution:
Documentation
Usage
roll [OPTION] expression
Options
p, positive allow only positive results h, help show this help screen s, sumseries show the sum of roll series v, verbose increase verbosity version prints the program version and exits
Expressions
Expressions are in dice notation (also known as dice algebra, common dice notation or RPG dice notation).
Die rolls are expressed in the form NdX
or
NDX
where N
is the number of
dices (1 if omitted) and X
the number of
dice faces.
If the final number is omitted, it is assumed to be a six.
To this basic notation, an additive modifier can be
appended, yielding expressions of the form,
NdX+C
. The plus can be replaced by a minus
sign (
) for subtraction. C
is
a number to be added or subtracted from the final total.
Percentile dice (d%
)
Often, the variable X
in the above notation
will be %
. Although a 100sided die does
exist, it is both more common and more uniformly random
to use a combination of two tensided dice known as per
centile dice, where one die represents tens and the
other units. A roll of two zeroes means 100.
If you want to roll a single 100sided die use the
d100
notation.
d10x
d10x
is equivalent to d10 x d10
and gives a nonlinear distribution.
Fudge dice (dF
or df
)
The Fudge roleplaying game system uses customized Fudge dice which have an equal number of plus, minus and blank sides.
Multipliers
In some games, the above notation is expanded to allow
for a multiplier, as in NdXxC
or
CxNdX
, where x
or
*
denotes multiplication (can be replaced
by /
for division) and C
is a
natural number.
Results are rounded up.
Reroll filters
It is possible to specify restrictions on dice rolls
telling which values to keep and which values to discard
by putting a filter after the dice. If a value is to be
discarded the dice is rerolled until the result is
valid value. You can specify to keep only values bigger
(>
), bigger or equal (>=
),
smaller (<
), smaller or equal
(<=
) or different (!=
) from a
given number.
The comparator is specified right after the the die
specification (e.g., 1D6>2
).
Selective results
It is possible to keep only the M highest or lowest dices with the following notation:

NdXhM
: rollN
dices withX
sides and keep the highestM
results (M
must be less or equalN
) 
NdXkM
:K
for keep is equivalent toH
for highest 
NdXlM
: rollN
dices withX
sides and keep the lowestM
results (M
must be less or equalN
)
Or using the abbreviated notation NdXL
to drop the lowest and NdXH
to
drop the highest result.
Series and repetitions
It is possible to concatenate toplevel expressions with
a comma (expression, expression
) and to
repeat the execution of an expression or a set of
expressions by using a counter and curly brackets (N{
expression}
)
Examples
3d6

rolls 3 6sided dices and sums the results
(can be abbreviated with 3d )

1d8 + 3

rolls 1 8sided die and adds 3
(can be abbreviated by d8+3 )

d%

rolls 2 10sided dices: one represents the tens and the other units 
1d6x5

rolls 1 6sided dice and multiplies the result by 5 
1d6 / 2

rolls 1 6sided dice and divides the result by 2
(1d3 )

4d6h3

rolls 4 6sided dices and keeps the 3 highest results (discarding the lowest) 
4d6L

rolls 4 6sided dices and discards the lowest 
6{3d6}

rolls 3d6 6 times

1d6>2

rolls 1d6 until the result is bigger than 2

4dF

rolls 4 Fudge dices 
Dice algebra grammar
Grammar in EBNF form:expression := term { "+" term  "" term } . term := number  factor [ ("*""/") number  number ("*""/") factor  "(" expression ")" . factor := number FilteredDice [ ("h""H""l""L""k""K") number ]  number FilteredDice "" [ ("h""H""l""L")  FilteredDice . FilteredDice := dice  dice (">"">=""<""<=""!=") number . dice := "d"  "D"  "w"  "W"  "t"  "T" [ number  "%"  "F"  "f"  "x"  "X" ] .
See also
 Dice notation on Wikipedia.