Dice Roller

[Colin]

Link to Mod

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:

Rolled 1d6 : 2, total 2

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

Rolled 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.

Rolled 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.

Rolled 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.

Rolled 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.

Rolled 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]

Freezing 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.

Uberdamage 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

Rolled 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.

[Joe N]

Screenshot>

[Arantor]

Though it looks virtually identical to the post above, I have added screenshots to the mod page for you, one showing the building of the [roll] tag, and one showing its output.

[Joe N]

Though it looks virtually identical to the post above, I have added screenshots to the mod page for you, one showing the building of the [roll] tag, and one showing its output.

Thank You

[aaraon]

I've tried to install this mod but it don't modify the "subs.php" file.
./Sources/Subs.php Fail

Someone else knows why?


Sorry for my english.

[Arantor]

Is this 1.1 or 2.0?

[aaraon]

Oh, sorry. My forum is the 1.10 version

Here the adress
http://www.falerpg.com.br/forum/

[Arantor]

That's two reports from 1.1.10 I've had. I need to investigate this further. Will reply shortly.

[aaraon]

Thanks, I will be waiting. :-)

[Arantor]

Should be fixed now for 1.1.10.

Not bumping the version number, it's not a code change. It just changes how it finds where to insert something - users who've installed it successfully don't have to worry, but future users will be all good.

[aaraon]

Sorry, same error mensage! :-(

[Arantor]

Please can you attach your Subs.php file?

[aaraon]

Here it is! I hope that helps 

[Arantor]

Spectacular, I managed to break it entirely with my previous fix.

Reuploaded version - http://custom.simplemachines.org/mods/index.php?action=download;mod=2032;id=110583 - should install cleanly now on 1.1.

[aaraon]

IT'S ALIVE!!! IT'S ALIVE!! err...  I mean... It's working fine! Thanks!





Sorry for the trouble! 

[Arantor]

No worries, my bad for not writing it nicely the first time

[aaraon]

You can't imagine all problems and my forum is an magnetic for problems.

If you accept sugestions, a way to not edit the roll. My players are not reliable. :-P

[Arantor]

Actually, the first release was stupid because I didn't check something in 1.1, the second I typo'd the install script, but this version works.

Re editing: The simplest solution is to remove the ability of players to edit their own posts.

I did look at doing it with a database, but I simply couldn't find a way that was still fast didn't require weeks of extra coding which I didn't (and still don't) have the time to put in. Maybe a later version though.

[aaraon]

At this time this dice roller is perfect! I'm all praise!   
The last thing I want is to belittle for all the work that you had!  I will continue accompanying your work. Now it is only the congratulations! 

[Arantor]

Good to hear Seriously though if you do come up with things you'd like to see I'll see what I can do about adding them here.