Dice

Simple utility to roll dice from the command line/terminal using "1d10+0" dice notation.

Installation

Linux AMD64 Releases

• Download latest binary: link
• Rename dice_amd64 to dice & move it to /usr/bin/ if you would like to call it like: dice 1d10

Windows Releases

• Download latest binary: link

Mac Releases

• Download latest binary: link
• Rename dice_darwin to dice & move it to /usr/bin/ if you would like to call it like: dice 1d10

Compile binary

• Install Rust if not already installed
• Clone repo
• Run cargo build -r
• The binary will be "targets/releases/dice", you can move this to /usr/bin/ or use it in place

Usage

Dice Notation

This program supports basic dice notation. Multiplication, division, & parenthesis are not supported yet but likely will be in the future.

• dice 1d10 will "roll" one dice with 10 sides.
• dice d20 will "roll" one dice with 20 sides.
• dice 100d20+1 will "roll" 100 dice with 20 sides & add 1 to each.
• dice 20d37-24 will "roll" 20 dice with 37 sides & subtract 24 from each.

Unrecognized Formatting

Any unrecognized format (including no dice notation) will output a warning & the result of a 1d20, assuming that it was what the user wanted. ex: dice Hello there! will output:

1st parameter should be a valid dice format. Ex.: 1d20+1 or d10. We rolled a d20 for you in case that's what you wanted.
[13]

Commands

Commands must come after the dice notation with a space between. Otherwise, the program will treat it as unrecognized formatting like in the above section. You can use as many of the commands as you want, & the order of the commands does not matter. Commands will only be processed once, & unrecognized commands will be ignored without a warning. Commands are processed in the same order as they appear in the table below & the outputs will show up in that order. "crit" & "fumb" only affect the rolled numbers, & do not have their own output (example output is only used for them in the table below for clarity).

name	description	example	example output
crit	Rerolls any rolls that hit the max, & adds it to the original roll. A.k.a Explode critical	dice 2d20 crit	[10, 25]
fumb	Rerolls any rolls that hit the min, & subtracts it from the original roll. A.k.a Explode fumble	dice 2d20 crit	[13, -4]
adv	Selects the highest total roll out of all rolled dice, including the plus or minus.	dice 2d20 adv	Advantage: 19
dis	Selects the lowest total roll out of all rolled dice, including the plus or minus.	dice 2d20+1 dis	Disadvantage: 8
sum	Sums all rolled dice including the plus or minus.	dice 10d4 sum	Sum: 23
hide	Hides the original numbers rolled, in case you only want the output of another command.	dice 100d20 hide	``