README
¶
Golang dice
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 - 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.
Installation
The usual go get github.com/justinian/dice.
Usage
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.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var (
ErrTooManyLoops = errors.New("Too many loops, you either specified too many dices or sides")
)
var (
MaxLoop int64 = 1000
)
Functions ¶
This section is empty.
Types ¶
type EoteDie ¶
type EoteResult ¶
func (EoteResult) Description ¶
func (r EoteResult) Description() string
func (EoteResult) Int ¶
func (r EoteResult) Int() int
func (EoteResult) String ¶
func (r EoteResult) String() string
type EoteRoller ¶
type EoteRoller struct{}
func (EoteRoller) Pattern ¶
func (EoteRoller) Pattern() *regexp.Regexp
func (EoteRoller) Roll ¶
func (EoteRoller) Roll(matches []string) (RollResult, error)
type RollResult ¶
type StdResult ¶
type StdResult struct {
Rolls []int
Dropped []int
Total int
// contains filtered or unexported fields
}
func (StdResult) Description ¶
func (r StdResult) Description() string
Source Files
Directories