Author: Colin
Previous Authors: Robbo & Arantor

---

This mod allows users to roll dice. They can use the preview function to preview dice rolls to make sure they have it right for what they want, but once they press Post, the dice rolls are embedded in the post, meaning that the only way they can change is if the post is edited, but a warning is issued if that is attempted.

It starts from a [roll] tag, and outputs a [blockquote] tag (implemented just for the mod) - trying to use the blockquote tag outside of [roll] circumstances (such as quoting the post, or better, editing the post) generates a visible warning.

There are a variety of options you can have inside the roll tag:

[roll]1d6[/roll] - rolls 1 6-sided dice.
Might result in:

QuoteRolled 1d6 : 2, total 2

[roll]2d12+5[/roll] - roll 2 12-sided dice and add 5 to the result
Might result in:

QuoteRolled 2d12+5 : 6, 11 + 5, total 22

[roll]2d20^10[/roll] - roll 2 20-sided dice, re-rolling any result necessary so that the dice rolls are greater than 10.

QuoteRolled 2d20^10 : 3 8 10 3 17, 2 10 9 10 14, total 31

[roll]2d20v10[/roll] - roll 2 20-sided dice, re-rolling any result necessary so that the dice rolls are less than 10.

QuoteRolled 2d20v10 : 11 3, 3, total 6

[roll]2d20<10[/roll] - roll 2 20-sided dice, discarding any result where the roll was not less than 10.

QuoteRolled 2d20<10 : 4, 20, total 4

[roll]2d20>10[/roll] - roll 2 20-sided dice, discarding any result where the roll was not greater than 10.

QuoteRolled 2d20>10 : 9, 10

Normally it will add the word 'Rolled' in front - you can customise this. For example, a spell that does some serious damage in a game:
[roll]{Freezing} 1d10 {Fire} 1d20[/roll]

QuoteFreezing 1d10 : 1, total 1
Fire 1d20 : 2, total 2

You can also nest the requirements, with the proviso of stating the things as they are in order here.
[roll]{Uberdamage} 15d100+10^10v90<80>20[/roll] - 15 100-sided dice, adding 10 to the result, rerolling anything 10 or less, rerolling anything 90 or higher, and if after that, you have values 20 or less, or 80 or higher, they get dropped.

QuoteUberdamage 15d100+10^10v90<80>20 : 82, 7 61, 3 36, 59, 30, 86, 14, 42, 70, 22, 99 58, 100 73, 46, 93 1 91 42, 12 + 10, total 549

Lastly you can also have an iterator at the end:
[roll]2d6x3[/roll] - roll 2d6 3 times and display the results overall

QuoteRolled 2d6 : 6, 3, total 9
Rolled 2d6 : 1, 4, total 5
Rolled 2d6 : 1, 5, total 6

BBcode is not supported anywhere inside the [roll] tag.

Note I haven't provided a help file in the script, but generally this is going to be of limited use and for the forums it will be useful, they will likely want to explain it better to their users anyway.

(There is, as of 1.3, a button to click as well as RC2 support)

There are also limitations to prevent abuse; the most dice that can be used at once is 20, and the highest value of dice is 1000-sided.

diceroller.zip 5.89 KB

Manual installation info 1.1.11 1.1.18 2.0 RC2 2.0 RC3 2.0.3 2.0.4 2.0.5 2.0.6 2.0.7 2.0.8 2.0.10 2.0.12