explode: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Text replacement - "source>" to "syntaxhighlight>")
m (Text replacement - "<source" to "<syntaxhighlight")
Line 5: Line 5:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
explode(times, sides)
explode(times, sides)
</syntaxhighlight>
</syntaxhighlight>
Line 14: Line 14:
|examples=
|examples=
Roll a twenty-sided dice.
Roll a twenty-sided dice.
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[t: explode(1, 20)]
[t: explode(1, 20)]
</syntaxhighlight>
</syntaxhighlight>
Line 20: Line 20:


Roll five ten-sided dice, using variables.
Roll five ten-sided dice, using variables.
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: DiceTimes = 5]
[h: DiceTimes = 5]
[h: DiceSides = 10]
[h: DiceSides = 10]

Revision as of 21:06, 14 March 2023

explode() Function

Generates random numbers to emulate dice rolls; returns the total of a dice roll where dice that are rolled at maximum value are rolled again with the new roll added to the old. There is no limit to the total that that can be returned by this function, but the odds of each individual number decreases as the total increases past the number of sides.

Usage

explode(times, sides)

Parameters

  • times - The number of times to roll the dice.
  • sides - The number of sides the dice possess.

Examples

Roll a twenty-sided dice.
[t: explode(1, 20)]

Returns a number that is usually between 1 and 20, with the possibility of the maximum value being higher than 20.

Roll five ten-sided dice, using variables.

[h: DiceTimes = 5]
[h: DiceSides = 10]
[t: explode(DiceTimes, DiceSides)]
Returns a number than is usually between 5 and 50, with the possibility of the maximum value being higher than 50.

See Also

For another method of rolling dice, see Dice Expressions.