This is a simple library for rolling RPG-style dice. The following formats are supported:
- Standard:
xdy[[k|d][h|l]z][+/-c]- rolls and sums x y-sided dice, keeping or dropping the lowest or highest z dice and optionally adding or subtracting c. Example: 4d6kh3+4 - Fudge:
xdf[+/-c]- rolls and sums x fudge dice (Dice that returns numbers between -1 and 1), and optionally adding or subtracting c. Example: 4df+4 - Versus:
xdy[e|r]vt- rolls x y-sided dice, counting the number that roll t or greater. - EotE:
xc [xc ...]- rolls x dice of color c (b, blk, g, p, r, w, y) and returns the aggregate result.
Adding an e to the Versus rolls above makes dice 'explode' - Dice are rerolled and have the
rolled value added to their total when they roll a y. Adding an r makes dice rolling a y add another die
to the pool instead.
The usual go get github.com/justinian/dice.
The main entrypoint to the library is the dice.Roll function:
func Roll(desc string) (fmt.Stringer, error)The desc argument takes any string that matches the formats above and rolls
correctly. The result is returned as a RollResult (which is a fmt.Stringer
for simple printing, but also contains different information based on the type
of roll). See the individual roll styles for their result structures.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent