Dice Roller MyCode

by klin 3 Stars 489 Downloads

Roll dice in a variety of exciting ways!

Project Details

Roll dice in a variety of exciting ways via MyCode! 

Live Preview Dependencies
  • PluginLibrary
    • Version 1.8.X
    • Download and transfer inc/plugins/pluginlibrary.php to your inc/plugins folder.
    • You do not need to install or activate PluginLibrary.
    • Dice Roller MyCode uses PluginLibrary to run a new hook in class_parser.php, in order to correctly seed quoted rolls.
Features
  • Multiple syntaxes, including low-high, NdS, and weighted lists -- including offsets!
  • Customizable templates for each component
  • Enable or disable sum of NdS rolls
  • Add aliases as shorthand for complicated rolls
  • Add unique result messages and the range of sums at which they display for each roll
  • Add unique resource lists to display an item from for each die in a roll
  • Tamper proof! Rolls cannot be edited to abuse RNG or cherry picked.
  • Quoted rolls retain their original values.
  • Rolls wrapped in code or PHP tags are not parsed.
Syntax
  • [roll=low-high]
    • Rolls a single dice with values between low and high, inclusive.
    • e.g. [roll=1-10] 
    • potential output - Rolling 1-10: 5
  • [roll=low-high+/-F]
    • Rolls a single dice with values between low and high, inclusive. Adds or subtracts the given offset F.
    • e.g. [roll=1-10+5]
    • potential output  - Rolling 1-10: 2 + 5 = 7
    • [roll=1-10-5]
    • potential output - Rolling 1-10: 2 - 5 = -3
  • [roll=dS]
    • Rolls a single dice with with values between 1 and S, inclusive.
    • e.g. [roll=d6]
    • potential output - Rolling d6: 4
  • [roll=NdS]
    • Rolls N dice with values between 1 and S, inclusive.
    • e.g. [roll=3d6]
    • potential output - Rolling 3d6: 4 + 2 + 6 = 12
  • [roll=dS+/F]
    • Rolls a single dice with values between low and high, inclusive. Adds or subtracts the given offset F.
    • e.g. [roll=d6+5]
    • potential output - Rolling d6+5: 4 + 5 = 9
  • [roll=NdS+/-F]
    • Rolls N dice with values between 1 and S, inclusive. Adds or subtracts the given offset F.
    • e.g. [roll=3d6+20]
    • potential output - Rolling 3d6+20: 4 + 1 + 6 + 20 = 31
  • [roll=weighted list]
    • Rolls a single dice with as many values as there are items in weighted list. Each item in weighted list represents how likely that index is to be selected.
    • e.g. [roll=25,25,50] gives 1 a 25% chance to be rolled, 2 a 25% chance, and 3 a 50% chance.
    • potential output - Rolling 25,25,50: 3
Known Issues
  • [roll=*] cannot be previewed. This is not a planned feature due to the possibility of abuse and due to incompatibility with the way rolls are seeded. (Previewed posts don't have a post ID!)