Skip to main content

Dice Rolling Guide

Learn Mini Kraken's generic notation and the dedicated Vampire V5, Fate, and Assimilation rolls. Every example and system guide can be tested live.

Try it live

Type any notation from this guide and roll it right here — dice show up in 3D with sound.

Complete documentation

One page per roll type, with the detailed rules, edge cases and examples you can roll in 3D.

Dice Basics

Roll dice with the classic NdX notation: N is how many dice, X is how many sides. Both parts are optional and have smart defaults.

Standard dice

NdX

Roll N dice with X sides and add them up. The quantity defaults to 1, so d20 rolls a single twenty-sided die.

Default die (d20)

d → d20

Omit the sides and the engine assumes a d20. Typing d+5 is the same as 1d20+5, and 3d rolls 3d20.

Percentile dice

d%

d% rolls a hundred-sided die, equivalent to d100. Great for percentage-based systems.

Fudge / Fate dice

dF · dF.1

dF rolls a Fudge die with results -1, 0, or +1 (dF.2, the default). dF.1 uses the variant where blank faces are more common. The shortcut f alone rolls 4dF, the standard Fate check.

Computed quantity

(expr)dX

The quantity can be a simple numeric expression in parentheses; put the side value directly after d. (2+1)d6 rolls 3d6.

Computed sides

Nd(expr)

Put a constant expression in parentheses after d to calculate the number of sides. d(2+4) rolls a d6, and (2+1)d(2*3) rolls 3d6.

Math & Operators

Notation strings are full math expressions. Combine dice with numbers, operators, and parentheses; standard operator precedence applies.

Arithmetic operators

+ - * / % ^ **

Addition, subtraction, multiplication, division, modulo (%) and exponent (^ or **) are all supported, with parentheses for grouping.

Decimals & signs

1.5 · +-

Decimal numbers work anywhere in an expression. Repeated signs are simplified automatically: d20+-2 becomes d20-2.

Math Functions

One card per function — every helper the engine accepts inside a notation. All of them take full expressions (including dice) as arguments.

Round down

floor(x)

Always rounds down to the nearest whole number: floor(3.9) is 3. The classic way to halve damage.

Round up

ceil(x)

Always rounds up: ceil(3.1) is 4. Useful when a system rounds in the player's favor.

Round to nearest

round(x)

Rounds to the nearest whole number: round(2.4) is 2, round(2.5) is 3.

Absolute value

abs(x)

Removes the sign: abs(-3) is 3. Handy for margins and differences that can't be negative.

Sign

sign(x)

Returns -1, 0, or 1 depending on whether the value is negative, zero, or positive.

Square root

sqrt(x)

Returns the square root of the value: sqrt(16) is 4.

Power

pow(x, y)

Raises the first value to the second: pow(2, 3) is 8. Same as 2^3.

Smallest of two

min(x, y)

Returns the lower of two values: min(2d10, 7) caps the result at 7.

Largest of two

max(x, y)

Returns the higher of two values: max(2d10, 7) guarantees at least 7.

Exponential

exp(x)

Returns Euler's number e raised to the value: exp(1) is about 2.718.

Natural logarithm

log(x)

Returns the natural log (base e) of the value: log(10) is about 2.303.

Sine

sin(x)

Sine of the value in radians. Rarely needed at the table, but available for exotic formulas.

Cosine

cos(x)

Cosine of the value in radians. Rarely needed at the table, but available for exotic formulas.

Tangent

tan(x)

Tangent of the value in radians. Rarely needed at the table, but available for exotic formulas.

Keep & Drop

Roll a pool and keep only the best — or ditch the worst. This is how you build advantage, disadvantage, and classic stat rolls like 4d6 drop lowest.

Keep

kN · khN · klN

k or kh keeps the highest dice, kl keeps the lowest; everything else is ignored in the total. 2d20kh1 is advantage, 2d20kl1 is disadvantage.

Drop

dN · dlN · dhN

d or dl drops the lowest dice, dh drops the highest. 4d6d1 is the classic ability-score roll.

Shortcuts

k → k1 · km → kl1

Omit the number and 1 is assumed: 2d20k means 2d20k1. km is an alias for kl1 (keep the lowest die).

Exploding Dice

When a die hits its trigger (the maximum value by default), it explodes: you roll an extra die and keep both. Explosions can chain.

Explode

!

Each die that rolls its maximum value triggers an extra roll, shown as a separate die.

Compound

!!

!! adds every chained explosion into a single die total instead of listing extra dice.

Penetrate

!p · !!p

!p subtracts 1 from each exploded die (Hackmaster style). Combine with compound as !!p.

Custom trigger

!cp

Add a compare point to change when dice explode: d6!>=5 explodes on 5 or 6, d10!=3 explodes only on 3.

Explosion cap

!N · !!N · !pN · !!pN

N is a positive integer that caps the additional explosions generated by each original die. Combine the cap with compound (!!N), penetrate (!pN or !!pN), and a trigger, as in d6!2>=5.

Shortcut: ei

ei · eiN

ei is a friendly alias for explosion: 3d6ei equals 3d6!, and 3d6ei5 equals 3d6!>=5.

Rerolls

Reroll dice you don't want to keep. By default the trigger is the minimum value (a natural 1 on most dice).

Reroll

r · r(cp)

r rerolls a die until the result no longer matches the trigger. Add a compare point to customize it: d20r<3 rerolls 1s and 2s.

Reroll once

ro · ro(cp)

ro rerolls a matching die a single time and keeps the new result, even if it matches again.

Unique Rolls

Force every die in the pool to land on a different value.

Unique

u · u(cp)

u rerolls duplicated results until all dice are different. With a compare point, only duplicates that match the condition are rerolled.

Unique once

uo

uo rerolls each duplicate a single time, keeping whatever comes next.

Success Counting

Instead of summing the dice, count how many meet a target — the dice-pool style used by systems like World of Darkness or Shadowrun.

Successes

cp

Put a compare point right after the dice and the total becomes the number of dice that match: 6d10>=8 counts dice showing 8 or more.

Failures

f(cp)

Add f plus a compare point to also count failures; each failure subtracts one from the success total.

Critical Highlights

Flag dice as critical successes or failures. This is purely visual — it marks the dice in the output but never changes the total.

Critical success

cs(cp)

cs marks dice that match the compare point: d20cs=20 highlights natural 20s.

Critical failure

cf(cp)

cf marks fumbles: d20cf=1 highlights natural 1s.

Minimum & Maximum

Clamp each individual die to a floor or ceiling after rolling.

Minimum

minN

min raises any die below the value up to it: 4d6min2 turns every 1 into a 2.

Maximum

maxN

max caps dice above the value: d%max50 never shows more than 50.

Sorting

Reorder the dice in the output to read results faster.

Sort

s · sa · sd

s or sa sorts the rolled dice in ascending order, sd in descending order. Only the display order changes.

Roll Groups

Wrap expressions in braces to treat them as a single group — and apply keep/drop logic across whole sub-rolls.

Basic groups

{A, B}

List one or more expressions separated by commas inside braces. The group total is the sum of its expressions.

Group modifiers

{...}mod

Groups support keep, drop, and sort. With a single expression, keep/drop applies to its dice; with several expressions it applies to each sub-total. Use sd or sa to sort the expressions.

Multiple Rolls

Repeat an entire notation several times in one go.

Repeat with #

N#

Prefix the notation with a count and #. 6#4d6k3 rolls a full set of six ability scores at once. Up to 100 repetitions.

Comments & Labels

Attach a label to any roll — perfect for naming attacks and damage types. Comments never affect the math.

Line comments

// · #

// labels a full expression; # works directly after a die notation.

Block comments

/* */ · [ ]

Wrap text in /* */ or [ ] anywhere in the notation.

Compare Points

Several modifiers (explode, reroll, unique, successes, criticals) accept a compare point: an operator followed by a number that defines when the modifier triggers.

=Equal to
<Less than
>Greater than
<=Less than or equal
>=Greater than or equal
!=Not equal
<>Not equal (alternative)

System dice

Vampire V5, Fate, and Assimilation preserve die types and interpret their symbols after the roll. Every roll surface now understands their dedicated calls without approximating the rules with a generic formula.

The main roller, character sheets, chat, buttons, macros, the bot, and this playground accept these calls. Separate independent rolls with ; to preserve every system's dice and symbols in the same 2D and 3D batch.

Vampire V5

Pool, Hunger, and difficulty

Hunger replaces dice in the total pool. V5 mode keeps normal and Hunger dice distinct, counts successes, and recognizes criticals, messy criticals, and bestial failures.

System call

Accepted shortcuts and variations

Call names are interchangeable. Named parameters accept Hunger and difficulty in English or Portuguese; the positional order is pool, Hunger, and optional difficulty.

Call aliases
v5(...)vampiro(...)vampire(...)vampire-v5(...)
Named parameters
v5(pool=7,hunger=3,difficulty=4)vampiro(pool=7,fome=3,dificuldade=4)
Positional form
v5(7,3,4)v5(7,3)
Evaluate the outcome against difficulty
  1. 1.Build the total pool and enter Hunger. Hunger replaces dice in the pool; it is never added on top.
  2. 2.Each result from 6 to 10 is one success. Each pair of 10s adds two more successes.
  3. 3.When the roll reaches difficulty, a pair of 10s is a critical success; if one of those 10s is a Hunger die, it is messy.
  4. 4.On a failed test, a 1 on a Hunger die causes bestial failure. Without difficulty, the mode only counts successes.

Vampire V5 face reference

1Normal: blankHunger: bestial trigger
2–5Normal: blankHunger: blank
6–9Normal: successHunger: success
10Normal: success + criticalHunger: success + messy critical
Fate Dice

Fate / Fudge dice

Roll Fate dice with minus, blank, and plus faces. Four dice are the standard pool, while the total preserves every symbolic face for both the 2D result and the 3D dice.

System call

Accepted shortcuts and variations

Use fate or fatedice. The named count accepts dice, dado, or dados; omit it to roll the standard four dice.

Call aliases
fate(...)fatedice(...)
Named parameters
fate(dice=4)fate(dados=4)fate(dado=4)
Positional form
fatedice(4)fate()
−Subtracts 1 from the total
0Does not change the total
+Adds 1 to the total
Assimilation RPG

Mixed pool and result selection

Roll any combination of d6, d10, and d12. After the roll, choose up to the stated limit and total only the symbols on selected dice.

System callassim(d6=2,d10=1,d12=1,keep=2)

Accepted shortcuts and variations

Use the short, Portuguese, accented Portuguese, or English call. Named parameters accept keep or manter; the positional order is d6, d10, d12, and optional keep.

Call aliases
AS(...)assim(...)assimilacao(...)assimilação(...)assimilation(...)
Named parameters
AS(d6=2,d10=1,d12=1,keep=2)assim(d6=2,d10=1,d12=1,keep=2)assimilação(d6=2,d10=1,d12=1,manter=2)
Positional form
AS(2,1,1,2)assim(2,1,1,2)AS(2)
  1. 1.Enter how many d6, d10, and d12 form the pool. At least one die is required.
  2. 2.Choose sets how many dice you may keep after rolling; the default is one.
  3. 3.Roll every die and select the results that best match the action. There is no automatic choice.
  4. 4.Total Success, Adaptation, and Pressure only on the selected dice.

Assimilation face reference

1–2Blank
3–4Pressure
5Adaptation + Pressure
6Success
72 Successes
8Success + Adaptation
9Success + Adaptation + Pressure
102 Successes + Pressure
11Success + 2 Adaptations + Pressure
122 Pressures
Duality Dice

Daggerheart

An Action Roll uses two distinct d12s: Hope and Fear. Add both values to the modifier. Matching dice are a Critical Success; otherwise, the higher die determines whether the action was rolled with Hope or Fear.

In the 3D roll, Hope uses your skin color and Fear uses that color's RGB inverse.

System call

Accepted shortcuts and variations

Use daggerheart, dagger, or dh. The modifier is optional, and Difficulty can be omitted when it is secret.

Call aliases
daggerheart(...)dagger(...)dh(...)
Named parameters
daggerheart(modifier=2,difficulty=15)dh(mod=2,dc=15)
Positional form
dh(2,15)dagger(-1)daggerheart()
Set Difficulty
  1. 1.Roll one Hope d12 and one Fear d12.
  2. 2.Add both results and apply the modifier.
  3. 3.If the values match, the action is a Critical Success.
  4. 4.Otherwise, the higher die determines Hope or Fear; with a Difficulty, the total determines success or failure.

PF2 (ORC)

d20 · degrees of success

Roll 1d20 + modifier against the DC. Ten above the DC is a critical success; meeting the DC is a success; ten below is a critical failure; other results are failures.

A natural 20 improves the result by one degree and a natural 1 worsens it by one degree. Fortune uses the higher of two d20s; misfortune uses the lower. Without a DC, the degree is pending.

Accepted shortcuts and variations

Use pf2(mod,dc). The DC is optional; the third parameter is 1 for fortune, −1 for misfortune or 0 for a normal roll.

Call aliases
pf2(...)pf2e(...)pathfinder2e(...)
Named parameters
pf2(mod=7,dc=18)pf2(modifier=7,difficulty=18,fortune=1)
Positional form
pf2(7,18)pf2(7)pf2(7,null,-1)
Compare against a DC
pf2(7,18)
  1. Roll a d20 and add the modifier.
  2. Compare the total against the DC and the ±10 thresholds.
  3. Improve one degree on a natural 20 or worsen one degree on a natural 1.
  4. Use the degree of success for the action. With a secret DC, wait for the GM.
2D + 3D

Mixed roll in one batch

Separate rolls with semicolons to combine generic dice, Vampire V5, Fate, Assimilation, and Daggerheart. The 2D result and 3D overlay receive the same dice list in the same order.

Use ; between systems. The + sign remains part of each generic formula.