easy_dice Build Status Gem Version

super simple gem for rolling polyhedral dice

todo

  • help-output for roll executable
  • rdoc

usage

ruby

include the gem in your project with require 'easy_dice'

  1. easy_dice will parse dice formatted as Strings

    irb> d = EasyDice.read("1d6 + 8")
    => #<Dice:0x00 ... >
    irb> d.roll
    => 10
    
  2. you can throw straight ruby at easy_dice too

    irb> d = 2.d(8) + 1.d(6) + 12
    => #<Dice:0x00 ... >
    irb> d.roll
    => 28
    irb> (12.d(6) + 10).roll
    => 61
    
  3. easy_dice can give you a little bit of miscellaneous information

    irb> d = 1.d(6) + 1.d(8)
    => #<Dice:0x00 ... >
    irb> d.min # what's the smallest number that can be rolled?
    => 2
    irb> d.max # what's the largest number that can be rolled?
    => 14
    irb > puts d # "i forgot what dice i was going to roll"
    1d6 + 1d8
    => nil
    

bash

$ roll 1d8 + 1d6 + 8
16

help me help you

If you've come across a bug or error in easy_dice, please submit a Github issue describing the problem, and what version of easy_dice you're using.