keepLowest

From RPTools Wiki
Revision as of 02:58, 19 February 2021 by Selquest (talk | contribs) (Documenting macro function accompanying XdYklZ syntax, introduced in 1.5.2)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

keepLowest() Function

Introduced in version 1.5.2
Generates random numbers to emulate dice rolls; returns the total of a dice roll that includes only a certain number of the lowest dice rolled.

Usage

keepLowest(times, sides, keep)

Parameters

  • times - The number of times to roll the dice.
  • sides - The number of sides the dice possess.
  • keep - The number of lowest rolls that are counted when totaling the roll.

Examples

Roll ten twenty-sided dice, keeping the lowest five rolls.
[t: keepLowest(10, 20, 5)]

Returns a number that is between 5 and 100, with a low average.

Roll five ten-sided dice keeping the lowest two rolls, using variables.

[h: DiceTimes = 5]
[h: DiceSides = 10]
[h: DiceKeep = 2]
[t: keepLowest(DiceTimes, DiceSides, DiceKeep)]
Returns a number than is between 3 and 30, with a low average.

See Also

For another method of rolling dice, see Dice Expressions.

Version Changes

  • 1.5.2 - Introduced