# explodingSuccess

Jump to navigation
Jump to search

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