A simple command line tool to roll dice.

1. Clone the respository.

2. Run ./gradlew installDist. This will install a distribution to the folder build/install/roll in the repository.

3. Call the script build/install/roll/bin/roll and pass the dice you want to roll (see Usage below).

4. As the full path to the script is rather cumbersome to write all the time, I suggest you create a symbolic link to the script somewhere on your PATH.

To roll one or multiple dice you simple call the command line tool and pass the number and dice type as arguments in the following notation:

Roll is not limited to regular dice like d4, d6, d8, d10, d12, d20, d100. Roll will also accept other dice like d2, d3, d5, d17, d7631, and so on.

Roll also accepts multiple arguments. For example, to roll multiple dice of different types: roll 3d6 1d10.