# explode

Jump to navigation
Jump to search

## 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, limit)`

**Parameters**

`times`

- The number of times to roll the dice.`sides`

- The number of sides the dice possess.`limit`

- Total allowed rerolls of each die. Omit, or set to -1 for infinite rerolls.

### Examples

Roll a twenty-sided die.
Returns a number than is usually between

`[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 a twenty-sided die.

`[t: explode(1, 20, 2)]`

Returns a number that is usually between `1`

and `20`

, with the possibility of the maximum value being `40`

, as the first roll can be `20`

, triggering an additional roll, but if the second roll is `20`

, it won't be rerolled, as it has reached the two roll limit.

Roll five ten-sided dice, using variables.

```
[h: DiceTimes = 5]
[h: DiceSides = 10]
[t: explode(DiceTimes, DiceSides)]
```

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

**1.15.0**- Added limit argument