crystal-dice-oracle

A tiny Crystal CLI for deterministic dice rolls and exact distribution hints.

It parses compact dice notation such as 2d6+3, rolls with a repeatable seed, and prints the probability shape for every possible total.

Usage

crystal dice_oracle.cr -- 2d6+3 --seed 42 --rolls 8

Example output:

Crystal Dice Oracle
notation: 2d6+3
seed: 42, rolls: 8

rolls: 9, 12, 10, 12, 12, 6, 9, 12
range: 5..15, average: 10.00

distribution hints:
   5 | ####                      2.78%
   6 | ########                  5.56%
   7 | ############              8.33%
   8 | ################         11.11%
   9 | ####################     13.89%
  10 | ######################## 16.67%

Notes

• d6 is accepted as shorthand for 1d6.
• Dice count is limited to 1..100; die sides are limited to 2..1000.
• --seed makes roll sequences reproducible.
• --rolls controls how many sample totals are printed.