Module to roll multiple dice.
This module aims to implement the throw of many types of dice.
pip install dice-rolling
Once installed, a throw of a simple die of 6 sides can be performed with:
$ roll 1d6 Rolled 1d6 and got 4. 
Or, for instance, to throw three 20-sided dice can be as simple as:
$ roll 3d20 Rolled 3d20 and got 36. [14, 9, 13]
To use this module you should use the class RollBuilder to implement the throws:
from dice_rolling import RollBuilder builder = RollBuilder() builder.set_amount_of_dice(3) builder.set_number_of_sides(20) builder.build() print(builder.get_result())
The request must start with
x is the number of dice and
y the number of faces of each die.
For example, to roll 4 6-sided dice:
$ roll 4d6 Rolled 4d6 and got 16. [5, 2, 3, 6]
After that, the following modifiers have been implemented (using the previous result as reference):
+a: Add the value of
ato each die. For example, to roll 4 6-sided dice and add 3 to each roll:
$ roll 4d6+3 Rolled 4d6+3 and got 28. [8, 5, 6, 9]
b. For example, to roll 4 6-sided dice and keep the highest 2:
$ roll 4d6kh2 Rolled 4d6kh2 and got 11. Kept [5, 6] and discarded [3, 2].
c. For example, to roll 4 6-sided dice and keep the lowest 2:
$ roll 4d6kl2 Rolled 4d6kl2 and got 5. Kept [2, 3] and discarded [5, 6].
Of course you can use together an addition with any of the keep actions:
$ roll 4d6+5kh2 Rolled 4d6+5kh2 and got 21. Kept [11, 10] and discarded [8, 7].
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.