json.rolls

From RPTools Wiki
Jump to navigation Jump to search

json.rolls() Function

Introduced in version 1.4.0.5
Rolls the dice expression the requested number of times and returns a JSON Array with the result. This function takes 2 or 3 parameters and returns a json array or an array of arrays if the second dimension is provided.

Usage

json.rolls(roll, dim1)
json.rolls(roll, dim1, dim2)

Parameters

  • roll - A string containing a dice roll expression. The dice expression must be in quotes as shown in the examples.
  • dim1 - The dimension of the returned array.
  • dim2 - Optional: The second dimension for a two dimensional array.

Example:

{json.rolls("3d6", 6)} => [ 11, 7, 15, 8, 10, 13 ]

Example: The three parameter version returns a two dimensional array

{json.rolls("3d6", 6, 4)} => [ [ 11, 13, 11, 13 ], [ 8, 11, 17, 10 ], [ 8, 11, 14, 11 ], [ 6, 8, 13, 6 ], [ 6, 11, 8, 10 ], [ 10, 7, 17, 11 ] ]


See Also