Crate dicebag 

Dice rolling!

In most cases, anything from i8/u8 up to i128/u128 and usize is supported (alongside f32/f64 for a few functions).

The Extensions

DiceExt

Covers the core intent dice rollings, e.g. 3.d6(), 2.d10().

use dicebag::DiceExt;
let a = 3.d6();
let b = 2_u8.d4();
let c = 5.d(a-3); // FYI: zero as dice size results in 0, no matter the number of dice...

HiLo

Coin flipping, using whatever datatype you implement it for… Comes with two convenience macros so that you don’t need to write those yourself:

use dicebag::{DiceExt, HiLo, lo, hi};
if lo!() {/* do something if result was "low" */}
if hi!() {/* do something if result was "high" */}

InclusiveRandomRange

To get a random value within given range.

use dicebag::InclusiveRandomRange;
let range = 6..=12;
let v = range.random_of();

RandomOf<T>

A trait to get some random entry of e.g. Vec.

Just make sure your container has at least one entry in it as otherwise things will catch fire (panic). .random_of() really can’t choose a random element out of nothing given…

use dicebag::RandomOf;
let v = vec![2,4,6,8,10];
let x: i32 = v.random_of();
 
#[derive(Clone)]
struct Abc { tag: String };
let abc = vec![Abc{tag:"a".into()}, Abc{tag:"b".into()}, Abc{tag:"c".into()}];
let x = abc.random_of();
assert!(x.tag == "a" || x.tag == "b" || x.tag == "c");

Macros

hi

Roll some arbitrary dice and see if their result is “high”.

lo

Roll some arbitrary dice and see if their result is “low”.

percentage_chance_of

$chance% of $v, otherwise 0.

Traits

DiceExt

Dice extensions.

FixedNumberVariance

Fixed value value variator(s).

HiLo

Couple “coin-flip” extensions…

InclusiveRandomRange

IsOne

“It’s just one, isn’t it?”…

PercentageVariance

Percentage amount value variator(s).

RandomOf

Type Aliases

DiceT