# openTest

Jump to navigation
Jump to search

** This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.**** This article needs:*** Better explanation, perhaps examples on how to strip out the dice rolls from the string that is returned.*

## openTest() Function

Rolls a number of dice of requested side with exploding rolls and returns a formatted string containing the result of each roll and the highest value produced.

### Usage

`openTest(times, sides)`

**Parameters**

`times`

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

- The number of sides the dice possess.

### Examples

Roll five ten-sided dice.
Returns a string that is similar to

`[t: openTest(5, 10)]`

Returns a string that is similar to `Dice: 5, 4, 19, 6, 3, Maximum: 19`

Roll five ten-sided dice, using variables.

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

`Dice: 5, 4, 19, 6, 3, Maximum: 19`

### See Also

For another method of rolling dice, see Dice Expressions.

For a similar function that returns the number of successes instead of the highest roll, see explodingSuccess.

For a similar function that returns the number of successes instead of the highest roll, see explodingSuccess.