The dnd_roller provides three main functions: roll, dice_roll, and sequence_rolls to generate a single die roll, multiple rolls of the same die, or multiple rolls of multiple dice.
The former (i.e. roll()) could generate a simple output in the terminal, whilst the latter (i.e. sequence_rolls()) generate a tabular report for the outcome of each roll in the sequence.
Please have a look at the examples below for additional details.
Rolling a single game die:
>>> from dnd_roller import roll
>>> roll(d=4)
4
>>> roll(d=20, verbose=true)
You rolled 17
17Rolling multiple times the same game die:
>>> from dnd_roller import dice_roll
>>> dice_roll(throws=3, sides=4)
[3, 2, 4]Rolling a sequence of dice rolls:
>>> from dnd_roller import sequence_rolls
>>> sequence_rolls(sequence="12d20, 4d4, 2d10, 1d100", verbose=True)
╒════════╤════════════════════════════════════════════════╤═══════╕
│ dice │ rolls │ sum │
╞════════╪════════════════════════════════════════════════╪═══════╡
│ 12d20 │ [15, 9, 13, 2, 14, 13, 18, 15, 13, 10, 17, 18] │ 157 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 4d4 │ [2, 3, 2, 1] │ 8 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 2d10 │ [8, 5] │ 13 │
├────────┼────────────────────────────────────────────────┼───────┤
│ 1d100 │ [50] │ 50 │
╘════════╧════════════════════════════════════════════════╧═══════╛
{'12d20': [15, 9, 13, 2, 14, 13, 18, 15, 13, 10, 17, 18],
'4d4': [2, 3, 2, 1],
'2d10': [8, 5],
'1d100': [50]}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent