RPG systems
Fate and Fudge dice
Symbolic faces, Fate values, and system notation.
Notation and API
fate() rolls four dice by default in a mixed batch. fate(6) and fate(dice=6) change the count; dice must be a positive integer. For TypeScript integration, use rollFateDice({ dice: 4 }, options) or omit its first argument.
import { rollFateDice } from '@erpg/dicecore/systems/fate'
const roll = rollFateDice({ dice: 4 }, { seed: 'fate-42' })
console.log(roll.total, roll.dice.map(die => die.fateValue))Faces and scoring
The API rolls physical d6 dice to preserve the 3D face. Faces 1–2 are minus (−1), 3–4 blank (0), and 5–6 plus (+1). total sums fateValue and ranges from −N to +N. Each die has profileId: 'fate-df', a rawValue between 1 and 6, faceKey, symbols, and fateValue.
Generic dF notation also produces −1/0/+1, but its face is already converted. Use the Fate API for a faithful physical display. baseRoll is full by default; { detail: 'compact' } returns a summary without groups, events, or output while preserving semantic dice in roll.dice. Seed/replay follows the Core contract.
Try the examples
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.
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()