# explode

## 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.
`[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)]```
Returns a number than is usually between `5` and `50`, with the possibility of the maximum value being higher than `50`.