This function is used to support Burning Wheel rules.

Usage

Format

bwheel(roll, poolSize, target, rollAgain)

Parameters

roll: The formula to be tested.
poolSize: Number of times roll is evaluated.
target: Value to reach with roll to obtain a success.
rollAgain: Value to reach to obtain an extra roll.

Returns

Number of times that roll is evaluated greater than or equal to target.

Description

This function is used to support Burning Wheel rules. The value of roll is evaluated poolSize times. Each time the value obtained is greater than or equal to target, a success is achieved.

If the value obtained is greater or equal to rollAgain, a new roll is made.

The function returns the number of success totalized.

Examples

Some results generated by bwheel(1d6, 5, 4, 6).
[4!,2,1,4!,1] = 2 (each "!" denotes a success)
[5!,3,3,3,1] = 1
[4!,4!,3,6!»4!,2] = 4 (each "»" denotes an extra roll)

History

Supported since Quick Dice Roller 1.3.3