engine:functions:mechanics:pool

pool()

changes the dice result from sum to dice pool. returns the list of dice results from the specified roll.

definition

pool( roll: dice ) : list

parameters

roll one or more dice definitions

You can add several dice definitions to form the dice pool. The dice does not have to be of the same size. To add more than one dice definition, use the & operator between them.

When pools are used inside of other expressions, the pool definition can be put into a bracket, but this is not needed anymore.

return
list of individual results

example

pool ( 3d6 ); rolls 3 six-sided dice and returns a list with 3 results
pool ( 4d10 & 2d8 ); rolls 4 ten-sided dice and 2 eight-sided dice and returns a list with 6 results

Remark

The result of pool() is slightly different from the result of using the times operator.

The times operator repeats a part of your formula several times and can be used to create a list of results. Other than pool(), the times operator as an operator returns the sum of its result to your expression. It only returns a list when assigned to a list;

pool() returns a list without a sum and thus cannot be used in mathematical expressions without further processing, for example using successes() or count(), which will use the list to generate a number.