Installation

Core package

The core @randsum/roller package is all you need for general-purpose dice rolling. It has zero runtime dependencies.

bun

bun add @randsum/roller

npm

npm install @randsum/roller

yarn

yarn add @randsum/roller

Game packages

If you are building for a specific tabletop RPG system, install the corresponding game package. Each game package automatically installs @randsum/roller as a dependency.

bun

# D&D 5th Edition
bun add @randsum/fifth

# Blades in the Dark
bun add @randsum/blades

# Powered by the Apocalypse
bun add @randsum/pbta

# Daggerheart
bun add @randsum/daggerheart

# Root RPG
bun add @randsum/root-rpg

# Salvage Union
bun add @randsum/salvageunion

npm

# D&D 5th Edition
npm install @randsum/fifth

# Blades in the Dark
npm install @randsum/blades

# Powered by the Apocalypse
npm install @randsum/pbta

# Daggerheart
npm install @randsum/daggerheart

# Root RPG
npm install @randsum/root-rpg

# Salvage Union
npm install @randsum/salvageunion

yarn

# D&D 5th Edition
yarn add @randsum/fifth

# Blades in the Dark
yarn add @randsum/blades

# Powered by the Apocalypse
yarn add @randsum/pbta

# Daggerheart
yarn add @randsum/daggerheart

# Root RPG
yarn add @randsum/root-rpg

# Salvage Union
yarn add @randsum/salvageunion

Requirements

• Node.js 18+ or Bun 1.0+
• TypeScript 5.0+ (recommended but not required)

All packages ship as both ESM and CJS with full type declarations.

Verify installation

import { roll } from '@randsum/roller'

const result = roll('2d6')
console.log(result.total) // Sum of 2d6

If this runs without errors, you are ready to go. Head to the Quick Start guide to learn the basics.