explodingSuccess
explodingSuccess() Function
Generates random numbers to emulate dice rolls; any dice that are rolled at maximum value are rolled again with the new roll added to the old. Returns a formatted string containing the result of each roll and the number of rolls that were at least the target number.
Usage
explodingSuccess(times, sides, target)Parameters
times- The number of times to roll the dice.sides- The number of sides the dice possess.target- The number that a dice needs to be equal to or higher to be considered a success (added to the count returned).
Examples
Roll a twenty-sided dice, and return one success if rolled higher than
Returns a string similar to
30.
[t: explodingSuccess(1, 20, 30)]Returns a string similar to Dice: 35, Successes: 1 or Dice: 8, Successes: 0. The success count will either be 0 or 1, with 1 only returned if the twenty-sided die rolls 20 and then is rerolled(exploded) with a result equal to or higher than 10.
Roll five ten-sided dice, and returns the number of dice that rolled higher than twenty, using variables.
[h: DiceTimes = 5]
[h: DiceSides = 10]
[h: DiceTarget = 20]
[t: explodingSuccess(DiceTimes, DiceSides, DiceTarget)]Dice: 25, 14, 35, 2, 15, Successes: 4, where the successes will be between 0 and 5.See Also
For another method of rolling dice, see Dice Expressions.
For a similar function that returns the highest roll instead of the number of successes, see openTest.
For a similar function that returns the highest roll instead of the number of successes, see openTest.