llms.txt

# RANDSUM - Dice Notation and Rolling Engine

> TypeScript dice engine implementing the RANDSUM Dice Notation (RDN) specification. RDN v1.0 Level 4 (Full) Conformant. Works with D&D 5e, Blades in the Dark, PbtA, Daggerheart, Root RPG, Salvage Union, and more.

## Packages

- @randsum/roller - Core dice engine with built-in RDN notation parser
- @randsum/games - TTRPG game packages with subpath exports:
  - @randsum/games/fifth - D&D 5th Edition
  - @randsum/games/blades - Blades in the Dark
  - @randsum/games/pbta - Powered by the Apocalypse
  - @randsum/games/daggerheart - Daggerheart RPG
  - @randsum/games/root-rpg - Root RPG
  - @randsum/games/salvageunion - Salvage Union

## Quick Start

npm install @randsum/roller

roll() accepts number, notation string, options object, or multiple arguments:

roll(20)       // Number: 1d20
roll("4d6L")   // Notation: D&D ability score (4d6, drop lowest)
roll({ sides: 6, quantity: 4, modifiers: { drop: { lowest: 1 } } })
roll("2d20L+5") // Advantage attack roll
roll("2d6+3")   // PbtA / 2d6 + stat
roll("d%")      // Percentile: 1d100
roll("4dF")     // Fate Core: 4 Fate dice (-4 to +4)
roll("5d6W")   // D6 System wild die
roll("g6")     // Geometric die
roll("3DD6")   // Draw die
roll("4d6Lx6") // Repeat operator
roll("2d6+3[fire]") // Annotations

## Links

- Documentation: https://randsum.dev
- RDN Specification: https://notation.randsum.dev
- Playground: https://randsum.io
- GitHub: https://github.com/RANDSUM/randsum
- RDN Spec (full text): https://notation.randsum.dev/llms-full.txt