- Python 82.6%
- Shell 17.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| dice | ||
| build.sh | ||
| die2weighted-items.py | ||
| LICENSE | ||
| nicedice-create.py | ||
| nicedice.py | ||
| README.md | ||
nicedice
nicedice is a program for Debian-based systems that lets you simulate dice and other simple, probabilistic mechanisms, like magic 8-balls.
Presets
nicedice comes with multiple premade dice, installed at /usr/share/nicedice/:
d6die.json: standard, six-sided died20die.json: twenty-sided die, most commonly used in RPGspercentile.json: 100-sided die with "%" suffix, used for generating percentages8ball.json: magic 8-ball, used for answering simple yes/no questions
Creating your own dice
nicedice-create is a simple, interactive wizard that generates die definition files for usage with nicedice.
In order to use it, you need to have python3-questionary installed on your system.
Weighting numerical dice
Starting with version v0.2, you can use the die2weighted-items command to convert a numerical die file into a weighted item picker to permit manual weight editing.
The first argument is the source file, and the second argument is the destination file. If the destination was not specified, it will write to the source.
Note that weighted numerical dice are much larger than unweighted ones because of the way that they're stored.
Examples
Roll a standard (six-sided) die: nicedice /usr/share/nicedice/d6die
Interactively define a die named dreidel.json: nicedice-create dreidel.json
A note about maintainable free software
This project is governed by The Maintainable Free Software Policy v1.0. The TMFSP is an all-in-one document that provides a basic set of rules for free software projects everywhere, so that they can be kept maintainable for years to come. To learn more about the rules of this project, click the link above.