@erpg/dicecore

Dice Core

The notation and rolling engine. Use it in a browser or server to validate expressions, apply rules, and get UI-ready data.

Start and reference

Set up the library and learn the grammar.

Guide

Get started with Dice Core

Install, roll, read structured results, and prepare visual rendering.

Reference

Dice Core notation

Complete map of the grammar, shortcuts, and pages for every roll type.

Every roll type

One detailed page per rule, each with clickable examples.

Reference

Standard, percentile and Fudge dice

Dice counts, sides, special values, and shorthand notation.

Reference

Arithmetic and functions

Operators, precedence, decimals, and every supported math function.

Reference

Roll groups

Keep, drop, and sort whole expressions in braces.

Reference

Keep and drop

Keep or discard the highest or lowest dice in a pool.

Reference

Rerolls and unique values

Repeat faces by condition or remove duplicates in a dice pool.

Reference

Exploding dice

Regular, compound, and penetrating explosions with triggers and caps.

Reference

Successes, failures, and criticals

Count matches and highlight critical faces.

Reference

Minimum, maximum, and sorting

Transform face bounds and arrange pool display.

Reference

Pool adjustments, advantage, and disadvantage

Change the physical dice count and select highest or lowest before rolling.

Reference

Dice steps

Promote or downgrade a numeric die before rolling.

Reference

Multiple rolls and comments

Repeat one formula independently and label the result.

Reference

Mixed roll batches

Combine generic formulas and system rolls in one batch.

RPG systems

Dedicated notation and examples for each system.

Reference

Fate and Fudge dice

Symbolic faces, Fate values, and system notation.

Reference

Vampire V5

Normal and Hunger dice pools, successes, and outcomes.

Reference

Assimilation

d6/d10/d12 pools, symbols, and manual result selection.

Reference

Daggerheart dice rolls

Hope and Fear Duality Dice, criticals, and difficulty.

Reference

Dice Core API

Entrypoints, functions, results, replay, limits, and errors.

Guide

How we benchmark Dice Core

Scenarios, method, results and limitations of a reproducible comparison with other RPG dice libraries.

Guide

Performance in an RPG application

Interpret benchmarks, reuse plans, choose result projections and measure your game's full path.