Advanced scrolls

Different RPG systems feature mechanics such as tests with advantage, dice that explode on critical hits or luck rules that allow you to re-roll low numbers.The Dice Queen data engine supports all of these modifiers natively through letters appended to the data notation.

1. Advantage and disadvantage (Keep Highest / Keep Lowest)

Keep only the largest or smallest values from a set of rolled data:

Keep Highest (khN - Keep Highest): Roll the dice and add only the N best results, discarding the others (displayed in light gray in the chat).
Example: /r 2d20kh1 + 5 [Ataque com vantagem] (rolls 2d20 and preserves the largest).
Example: /r 4d6kh3 [Rolagem de atributos estilo D&D] (rolls 4d6 and adds the 3 highest).
Keep Lowest (klN - Keep Lowest): Roll the dice and add only the N worst results.
Example: /r 2d20kl1 [Ação sob desvantagem ou perigo extremo].

2. Explosive Data (`x` or `xN`)

When a die drops to the maximum value (or a configured threshold), it “explodes”: a new die of the same type is rolled immediately and added to the total.If the extra die also explodes, the cycle continues!

Default explosion at maximum value (x):
Example: /r 1d6x [Dano flamejante] (explodes if you roll a 6).
Explosion with custom threshold (xN):
Example: /r 1d20x19 [Crítico com margem ampliada] (explodes if you roll 19 or 20).

3. Unwanted results re-roll (`rN`)

Discards a die that has a specific value and rolls another in its place:

Example: /r 1d20r1 + 3 [Sorte dos Pequeninos] If the initial die rolls 1, it is discarded and a new die is rolled to replace it.

Combining multiple modifiers

You can freely chain modifiers in the same expression:

/r 3d10x10kh2 + 4 [Técnica especial de artes marciais]

(Throws 3d10, explodes in 10s and adds the 2 highest final results).

To learn how to create complex shortcuts that make conditional decisions on their own, check out the Creating macros with variables guide.