nice-dice 0.1.0

Parsing dice expressions and evaluating their distribution.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

<!DOCTYPE html>
<html>

<head>
    <title>Nice Dice</title>
    <script src="demo.js" type="module"></script>
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <link rel="stylesheet" href="./charts.min.css">
    <style>
table.examples { border: 1px solid black; }
.charts-css .data { text-wrap: nowrap; }


</style>
</head>

<body>
        <form method="post" id="input">
            <label for="formula">Dice notation: </label><input type="text" name="formula" id="formula" value="1d20+7"/>
            <input type="submit" />

            <div id="parsed"></div>
        </form>

        <table class="examples">
            <caption>Expressions, in precedence order</caption>
            <tr>
                <td>Die</td>
                <td class="example">d20</td>
                <td>A 20-sided die.</td></tr>
            <tr>
                <td>Modifiers</td>
                <td class="example">3</td>
                <td>A constant value 2.</td></tr>
            <tr>
                <td rowspan="3">Repeats</td>
                <td class="example">3d10</td><td>Roll a 10-sided die 3 times and sum the results.</td>
            </tr>
            <tr><td class="example">3(d8 + 1)</td><td>3 times, roll an 8-sided die and add 1, and sum the results</td></tr>
            <tr><td class="example">(d4)(d8)</td><td>Roll a d4; then roll a d8 the number of times shown on the d4.</td></tr>

            <tr>
                <td rowspan="3">Repeats with selection</td>
                <td class="example">2d20kh</td>
                <td>Roll (2) 20-sided dice; keep the highest value. (Advantage!)</td>
            </tr>
            <tr>
                <td class="example">2d20kl</td>
                <td>Roll (2) 20-sided dice; keep the lowest value. (Disadvantage)</td>
            </tr>
            <tr>
                <td class="example">4d6kh3</td>
                <td>Roll (4) 6-sided dice. Keep the highest 3 values and sum them. (Stats roll)</td>
            </tr>
            <tr>
                <td rowspan="3">Multiplication and division</td>
                <td class="example">8d6 * 2 </td>
                <td>Roll (8) 6-sided dice, sum the results, and multiply the result by 2.</td>
            </tr>
            <tr>
                <td class="example">8d6 / 2</td>
                <td>Roll (8) 6-sided dice, sum the results, and divide the result by 2, rounding down.</td>
            </tr>
            <tr>
                <td class="example">8d6 * 2 / 2</td>
                <td>Roll (8) 6-sided dice, sum the results, multiply the result by 2, then divide that result by 2, rounding down.</td>
            </tr>
            <tr>
                <td rowspan="3">Addition and subtraction</td>
                <td class="example">1d10 + 7</td>
                <td>Roll a 10-sided die and add 7 to the result. (Damage roll)</td>
            </tr>
            <tr>
                <td class="example">1d20 + 1d4 - 1d4 + -1</td>
                <td>Roll a 20-sided die. Roll a 4-sided die and add it to the result. Roll a 4-sided die and subtract it from the result. Subtract 1 from the result. (Bless , bane, and a negative stats modifier)</td>
            </tr>
            <tr>
                <td class="example">1d20 - (1d4 + -3)</td>
                <td>Roll a 20-sided die. Then roll a 4-sided die, subtract 3 from the result; and subtract that result from the twenty-sided die roll.<td>
            </tr>
            <tr>
                <td rowspan="3">Comparison</td>
                <td class="example">(1d20) { &ge; 17: 1d4 }</td>
                <td>Roll a 20-sided die. If the result is greater than or equal to 17, roll 1d4 and use its value; otherwise, use the value 0.</td>
            </tr>
            <!-- TODO: This doesn't work! May be a u32 overflow? 
            <tr>
                <td class="example">[SAVE: 1d20] (SAVE &ge; 17) * ( 8d6 / 2 ) + (SAVE &lt; 17) * ( 8d6 )</td>
                <td>Roll a 20-sided die. If the result is greater than or equal to 17, roll (8) 6-sided dice, sum them, and divide the result by two (rounding down); otherwise, roll (8) 6-sided dice and sum them. (Fireball, save for half damage.)</td>
            </tr>
-->
            <tr>
                <td class="example">[AC: 16] [CHA: +5] [ATK: 1d20] (ATK = 20) * (2d10 + CHA) + (ATK &lt; 20) * (ATK &gt; 1) * (ATK + CHA &ge; AC) * (1d10 + CHA)</td>
                <td>The target AC is 16 and your Charisma modifier is 5. Roll a 20-sided die; this is your attack roll. If the attack roll is exactly than 20, roll two 10-sided dice and sum them along with your Charisma modifier. If the attack roll is 1, use the value 0. If the attack roll plus your charisma modifier is greater than the target AC, roll a 10-sided die and add your charisma modifier to the result. (A warlock attacks with Eldritch Blast, with the Agonizing Blast feature.)</td>
            </tr>
        </table>
</body>

</html>