Qdr /

Dice Pool

Qdr.Pool History

Hide minor edits - Show changes to output

Changed line 4 from:
(:format: @@pool(roll, poolSize, target)@@ :)
to:
(:format: @@pool(roll, poolSize, target[, extra[, fail[, explode[, limit]]]])@@ :)
Changed lines 6-8 from:
(:lastVersion: 1.2.0 :)

to:
(:lastVersion: 2.1.0 :)

Changed lines 17-18 from:
@@target@@: Value to reach with ''roll'' to obtain a success.
to:
@@target@@: Value to reach with ''roll'' to obtain a success.\\
@@extra@@: Optional. If specified represent the value to reach with ''roll'' to obtain an extra success.\\
@@fail@@: Optional. If specified represent the minimum value to reach with ''roll'' to avoid losing a success.\\
@@explode@@: Optional. If specified represent the value to reach with ''roll'' to obtain an extra roll.\\
@@limit@@: Optional. If specified represent the maximum number of extra roll. Set to 0 for unlimited extra rolls
.
Changed lines 29-33 from:
to:
* If ''extra'' is specified and ''roll'' is evaluated greater or equal to it, an extra success is counted.
* If ''fail'' is specified and ''roll'' is evaluated lesser or equal to it, an success is lost.
* If ''explode'' is specified and ''roll'' is evaluated greater or equal to it, an extra roll is made.
* If ''limit'' is specified it represent the maximum number of extra rolls made triggering the ''explode'' rule.

Changed lines 41-44 from:
to:
Some results generated by @@pool(1d6, 5, 4, 5, 1, 6, 1)@@.\\
[5!!,3,3,3,1*] = 1 (each "*" denotes a lost success)\\
[4!,4!,3,6!!»6!!,2] = 6 (each "»" denotes an extra roll)\\

Changed lines 46-50 from:
Supported since Quick Dice Roller {$:sinceVersion}
to:
Supported since Quick Dice Roller {$:sinceVersion}\\
Optional parameters available since Quick Dice Roller {$:lastVersion}

! See also
* [[Functions|+]]
Added lines 1-35:
(:title Dice Pool:)
(:category: Function :)
(:Summary: Roll a number of dice, count results above a certain target. :)
(:format: @@pool(roll, poolSize, target)@@ :)
(:sinceVersion: 1.2.0 :)
(:lastVersion: 1.2.0 :)


{$:Summary}

! Usage
:Format: {$:format}

:Parameters: \
@@roll@@: The formula to be tested.\\
@@poolSize@@: Number of times ''roll'' is evaluated.\\
@@target@@: Value to reach with ''roll'' to obtain a success.

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

! Description
This is a generic function to handle dice pool test roll.

The value of ''roll'' is evaluated for ''poolSize'' times. Each time the value obtained is greater or equal to ''target'', a success is achieved.

The function return the number of success totalized.

! Examples
Some results generated by @@pool(1d6, 5, 4)@@.\\
[4!,2,1,4!,1] = 2 (each "!" denotes a success)\\
[5!,3,3,3,1] = 1\\
[4!,4!,3,6!,2] = 3\\

! History
Supported since Quick Dice Roller {$:sinceVersion}
Page last modified on January 31, 2015, at 11:20 PM