____ ____ ____ ______ ___
/\ _`\ /| _ \ /\ _`\ /\__ _\ /\_ \
\ \ \/\ \ |/\ | \ \ \/\ \ \/_/\ \/ ___ ___\//\ \ ____
\ \ \ \ \ \// __`\/\\ \ \ \ \ \ \ \ / __`\ / __`\\ \ \ /',__\
\ \ \_\ \/| \L> <_\ \ \_\ \ \ \ \/\ \L\ \/\ \L\ \\_\ \_/\__, `\
\ \____/| \_____/\/ \ \____/ \ \_\ \____/\ \____//\____\/\____/
\/___/ \/____/\/ \/___/ \/_/\/___/ \/___/ \/____/\/___/
Direct all comments, suggestions, and bug reports at github.com/the-nick-of-time All tools in this package are released under the GNU General Public License version 2, as detailed within the file LICENSE. Refer to that document before doing anything except downloading for personal use. These were written in Python 3.5.2 and I do not guarantee that they will work correctly on any other platform.
| Operator | Format | Meaning |
|---|---|---|
| d | xdy | Take a y-sided die and roll x of them. y can be an integer, and works just as you would expect. It can also be a list of arbitrary numbers, in which case it works as a die with one side labeled with each number in the list. |
| da | xday | Take a y-sided die and return the average as if x of them had been rolled. This returns an unrounded number. |
| dc | xdcy | Roll a critical hit, where the number of dice rolled is doubled. |
| dm | xdmy | Roll the maximum on every die rolled. |
| h | ROLLhn | After making a roll, discard all but the highest n of the rolls. Hint: 2d20h1 is advantage. |
| l | ROLLln | After making a roll, discard all but the lowest n of the rolls. Hint: 2d20l1 is disadvantage. |
| f | ROLLfn | After making a roll, treat any value that is less than n as n. |
| c | ROLLcn | After making a roll, treat any value that is greater than n as n. |
| ro | ROLLron | After making a roll, look at all of them and reroll any that are equal to n, reroll those, and take the result. |
| Ro | ROLLRon | After making a roll, look at all of them and reroll any that are equal to n and reroll those. If that number comes up again, continue rerolling until you get something different. |
| rh | ROLLrhn | After making a roll, look at all of them and reroll any that are strictly greater than n, reroll those, and take the result. |
| Rh | ROLLRhn | After making a roll, look at all of them and reroll any that are greater than n and reroll those. If a number greater than n comes up again, continue rerolling until you get something different. |
| rl | ROLLrln | After making a roll, look at all of them and reroll any that are strictly less than n, reroll those, and take the result. |
| Rl | ROLLRln | After making a roll, look at all of them and reroll any that are less than n and reroll those. If a number less than n comes up again, continue rerolling until you get something different. |
| ^ | x^y | Raise x to the y power. |
| * | x*y | x times y. |
| / | x/y | x divided by y. This returns an unrounded number. |
| % | x%y | x modulo y. |
| + | x+y | x plus y. |
| - | x-y | x minus y. |
| > | x>y | Check if x is greater than y. Returns a 1 for yes and 0 for no. |
| >= | x>=y | Check if x is greater than or equal to y. Returns a 1 for yes and 0 for no. |
| < | x<y | Check if x is less than y. Returns a 1 for yes and 0 for no. |
| <= | x<=y | Check if x is less than or equal to y. Returns a 1 for yes and 0 for no. |
| = | x=y | Check if x is equal to y. Returns a 1 for yes and 0 for no. |
| & | x&y | Check if x and y are both nonzero. |
| | | x|y | Check if at least one of x or y is nonzero. |
Any string that can be parsed by the "rolling" code is called throughout all my related code a "rollable string". These are similar to arithmetic expressions, just with some dice-specific operators added.
This program uses the rolling code to power a minimal interface for rolling dice. All you need to do is start it up from the main program and type in the box. The button or the enter key will roll the dice that you specify in the entry.
The box in the lower left is where you enter rolls that will change your HP. For instance, if you take 1d8+3 damage from an arrow, you would enter -(1d8+3) and either hit Enter or press the "Change HP" button. If you instead gain some temporary hit points, press the "Add Temp HP" button. For instance, if you cast false life you could enter 1d4+4 then press the "Add Temp HP" button.
Here you can make ability checks, saving throws, and skill checks. The saves and skills you are proficient in are highlighted in green. Whether you have advantage or disadvantage on this roll is controlled by the checkboxes at the bottom.
There are a couple of these throughout the interface. Here, you can place any arbitrary roll to make. In addition to all of the stuff described earlier, you can use variables from your character by including them in the form $var where var can be:
var |
Meaning |
|---|---|
proficiency |
Your proficiency bonus |
ability_mod |
Where ability is any ability name or its short version; gets that modifier |
level |
Your total level |
caster_level |
Your total caster level |
class_level |
Your level in a specific class |
SUBJECT TO CHANGE
Toggle conditions using the buttons. All the effects are printed below the rank of buttons.
Their names are displayed alongside a button that leads to their full description.
All resources you have available are listed here. When you use one (with the '-' button) its value is rolled and displayed in the lower left. When you rest (using either of the buttons at the bottom of the screen) the numbers are reset. You could also manually reset them with the button associated with that resource.
Displays all your items categorized into weapons, apparel, treasure, and generic items. It keeps track of their weight and uses the variant encumbrance rules (PHB 176) to calculate any penalties you might have for carrying so much.
Shows all the spells you have prepared. You can view a detailed description of each spell with the '?' button, or cast it with the "Cast" button. There is another roller here so you can roll any dice associated with the spell.
Spell slots are shown on the right. You can manually change each number with the buttons or by typing a new number in the box.
In the beginning, there is a simple dice roller. It has the functionality described at the beginning.
When you press the "New Monster" button, you get a popup. You can either press "Load from file" or fill out the data yourself.