PyRoll20

An easy to use, Roll20 syntax compatible,python dice roller.

Installing

pip3 install pyroll20

Usage Example

from pyroll20.pyroll20 import roll

print(roll(user_input="2d20"))

>> [12,8]

or with a modifier

from pyroll20.pyroll20 import roll

print(roll(user_input="2d20+5"))

>> 23 

Modifiers

'h' # Highest Rolls - 5d20h3 returns the 3 highest rolls from the five d20 that were rolled.
'l' # Lowest Rolls - 5d20l3 returns the 3 lowest rolls from the five d20 that were rolled.
'+' # Adds to sum - 5d20+3 adds 3 to the sum of the five d20 that were rolled, always returns a single integer.
'-' # Subtracts from sum - 5d20-3 subtracts 3 from the sum of the five d20 that were rolled, always returns a single integer.
'.-' # Subtracts from each individual roll - 5d20.-3 subtracts 3 from each of the five d20 that were rolled.
'.+' # Adds to each individual roll - 5d20.+3 adds 3 to each of the five d20 that were rolled.
't' # Sum of all rolls - 5d20t returns the sum of the five d20 that were rolled.
'e' # "Exploding dice - 5d20e if any of the five rolls goes critical, it gets re-rolled and added to the individual roll.

Notes

If sides are provided but no roll number, the roll number defaults to 1, for example d20 is a valid input.

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE v3.

TODO

Advantage and disadvantage[Not working] Wrap it in some sort of gui for a standalone app.[Maybe]