awallenfang / dicey

Dicer is a Rust crate designed specifically for Tabletop RPG dice rolls and parsing such dice notation strings.

Dicey

Dicey is a Rust crate designed specifically for Tabletop RPG dice rolls and parsing such dice notation strings.

It supports configurable dice notations and the stringing of dice in the form of 1d6 + 2d4.

Usage

use dicer::Dice;

fn main() {
    // Creates a dice notated as 1d20
    let d20: Dice = Dice::new(20).unwrap();
    println!("The result of the roll is: {}", d20.roll().result);

    // Parses the string into a dice notated as 1d10 + 1d4
    let d10_plus_d4: Dice = "d10+d4".parse::<Dice>().unwrap();
    println!("The result of the roll is: {}", d10_plus_d4.roll().result);
}

TODO

• Dropping die (dl, dh)
• Keeping die (kl, kh)
• Refactor dice slicing
• Find die strings directly instead of searching for d-s -> Possibly allows Shunting yard
• (Exploding die)

Feature Plans

• Configurable dice notation syntax
• Support for math outside of the die
• (Rework parsing using Shunting-Yard algorithm)?