An RPG dice rolling program written for the CLI
Added build badge
tweak build
add automated alpine build


browse  log 



You can also use your local clone with git send-email.

License builds.sr.ht status


I just wanna roll some sweet nat 20's!


  • Roll d20, d12, d8, d6, d4, d2, and percentile dice!
  • Specify any number of dice!
  • No external dependencies!
  • Portable! Written in pure modern C++14
  • Fully unit test code coverage [coming]


  • Compiler capable of C++14 (i.e. GCC5 or Clang3.4)
  • POSIX make (GNU make, Bmake, etc.)


git clone https://git.sr.ht/~voidraven/dnd-dice
cd dnd-dice
make && make install # may require root privileges

# to build a debug version
make debug

# to build a optimized version
make opt

Check out the Releases page..


dnd-dice                       # interactively input dice to roll
dnd-dice -d 20                 # roll a d20
dnd-dice -d 10 -n 4            # roll four d10s
dnd-dice -v                    # show version info
dnd-dice -h                    # show this help info

#Built with:

Free and Open Source software and the help of the church of Emacs ;)


This does not include a secure random number generator. The rolls wont be truly non-deterministic. I use the C++ standard random_device and Mersenne-Twister to get the random numbers. The Mersenne-Twister is considered a really good pseudo-random generator and will produce large volumes of high quality pseudo-random values quickly. This works well enough for this application, and my needs. If you want true randomness build you own application against OpenSSL or just roll real dice.

#License / Disclaimer:

This project is licensed under the BSD 3-Clause license. See LICENSE.md for more info.

Don't blame me when your computer explodes.