Dice package

A GoLang package that allows complete management, autonomous or manual, of the use of dice for games of all kinds.

Installation

First, make sure you have GoLang installed on your machine.
Proceed by downloading the package with the go get -u github.com/MoraGames/dices command.

Examples

1. Roll a standard 6-sides dice: GoPlayground

package main

import (
	"fmt"
	"log"

	"github.com/MoraGames/dices"
)

func main() {
	//Create a standard n-sides dice
	sidesNumber := 6
	d1, err := dices.NewDice(sidesNumber)
	if err != nil {
		log.Panic(err)
	}
	//d1 is a 6-sided dice with faces valued [1, 2, 3, 4, 5, 6]

	//Roll the dice and print the result
	result := d1.Throw()
	fmt.Println("The result of rolling the dice d1 is:", result)
}

2. Roll a range dice: GoPlayground

package main

import (
	"fmt"
	"log"

	"github.com/MoraGames/dices"
)

func main() {
	//Create a special ranged dice
	lowestSide, highestSide := -1, 1
	d2, err := dices.NewRangeDice(lowestSide, highestSide)
	if err != nil {
		log.Panic(err)
	}
	//d2 is a 3-sided dice with faces valued [-1, 0, 1]

	//Roll the dice and print the result
	result := d2.Throw()
	fmt.Println("The result of rolling the dice d2 is:", result)
}

3. Roll a custom dice: GoPlayground

package main

import (
	"fmt"
	"log"

	"github.com/MoraGames/dices"
)

func main() {
	//Create a custom n-sides dice and their respective values
	sidesValue := []dices.Side{"Apple", "Banana", "Cherry", "Dates", "Elderberry"}
	d3, err := dices.NewCustomDice(sidesValue...)
	if err != nil {
		log.Panic(err)
	}
	//d3 is a 5-sided dice with faces valued ["Apple", "Banana", "Cherry", "Dates", "Elderberry"]

	//Roll the dice and print the result
	result := d3.Throw()
	fmt.Println("The result of rolling the dice d3 is:", result)
}

4. Roll a set of dices: GoPlayground

package main

import (
	"fmt"
	"log"

	"github.com/MoraGames/dices"
)

func main() {
	//Create a standard n-sides dice
	sidesNumber := 6
	d4a, err := dices.NewDice(sidesNumber)
	if err != nil {
		log.Panic(err)
	}
	//d4a is a 6-sided dice with faces valued [1, 2, 3, 4, 5, 6]

	//Create a special ranged dice
	lowestSide, highestSide := -1, 1
	d4b, err := dices.NewRangeDice(lowestSide, highestSide)
	if err != nil {
		log.Panic(err)
	}
	//d4b is a 3-sided dice with faces valued [-1, 0, 1]

	//Create a custom n-sides dice and their respective values
	sidesValue1 := []dices.Side{"Apple", "Banana", "Cherry", "Dates", "Elderberry"}
	d4c, err := dices.NewCustomDice(sidesValue1...)
	if err != nil {
		log.Panic(err)
	}
	//d4c is a 5-sided dice with faces valued ["Apple", "Banana", "Cherry", "Dates", "Elderberry"]

	//Create a custom set of n-dices
	s1, err := dices.NewSet(d4a, d4b, d4c)
	if err != nil {
		log.Panic(err)
	}

	//Roll all the dices in the set
	result := s1.Throw()
	fmt.Println("The result of rolling the set s1 is:", result)
}