Author Topic: How to use the Dice Roller Tool  (Read 432 times)

0 Members and 1 Guest are viewing this topic.

Offline Otter

  • Pirate Queen
  • Administrator
  • *****
  • Posts: 782
  • Otterly Adorable
How to use the Dice Roller Tool
« on: February 25, 2017, 12:15:57 AM »
We have installed a dice roll tool that allows users to roll dice! You can use the preview function to preview dice rolls to make sure you have the correct syntax for the role you want, but once you press Post, the dice rolls are embedded in the post.  This means that the only way you can change it 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.
Rolled 1d6 : 4, total 4


[ roll ]2d12+5[/roll] means Roll (2) 12-sided dice and add 5 to the result
Rolled 2d12+5 : 10, 3 + 5, total 18


[ roll ]2d20^10[/roll] means Roll (2) 20-sided dice, re-rolling any result necessary so that the dice rolls are greater than 10
Rolled 2d20^10 : 16, 15, total 31


[ roll ]2d20v10[/roll] means Roll (2) 20-sided dice, re-rolling any result necessary so that the dice rolls are less than 10
Rolled 2d20v10 : 11 15 4, 3, total 7


[ roll ]2d20<10[/roll] means Roll (2) 20-sided dice, discarding any result where the roll was not less than 10)
Rolled 2d20<10 : 16, 18, total 0


[ roll ]2d20>10[/roll] means Roll (2) 20-sided dice, discarding any result where the roll was not greater than 10)
Rolled 2d20>10 : 4, 13, total 13


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


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] means Roll (15) 100-sided dice, add 10 to the result; reroll anything 10 or less, reroll 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 : 14, 37, 83, 34, 16, 57, 94 64, 20, 55, 76, 77, 97 9 39, 49, 48, 81 + 10, total 546


Lastly, you can also have an iterator at the end:
[ roll ]2d6x3[/roll] means Roll (2) 6-sided dice 3 times and display the results overall
Rolled 2d6 : 2, 3, total 5
Rolled 2d6 : 2, 4, total 6
Rolled 2d6 : 6, 6, total 12


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

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.


Information pulled from the Dice Mod Page
Follow the Irate Pirate on Facebook | Twitter | Dischord Server

Offline Otter

  • Pirate Queen
  • Administrator
  • *****
  • Posts: 782
  • Otterly Adorable
Re: How to use the Dice Roller Tool
« Reply #1 on: February 25, 2017, 12:19:31 AM »
For clarification--I added a space to the roll bracket so that it wouldn't run the tool, so you will need to type in [roll] with no spaces, or just use the button on the menu!
Follow the Irate Pirate on Facebook | Twitter | Dischord Server