# Random dice throw

``

    dice  num_sides (number)

Throws a dice with the specified num_sides (defaults to `6`) and returns the score as a number between `1` and `num_sides`.

Introduced in v2.0

## Examples

# Example 1
``
    dice
| ``
    # will return a number between 1 and 6 inclusively
    # (with an even probability distribution).
# Example 2
``
    dice 3
| ``
    # will return a number between 1 and 3 inclusively