RANDSUM

A flexible, type-safe dice rolling ecosystem written in TypeScript

RANDSUM provides a comprehensive collection of packages for rolling dice, implementing tabletop RPG mechanics, and building dice-based applications. Built with TypeScript, thoroughly tested, and published to NPM with full type definitions.

Core Package

Roller

@randsum/roller

Core dice rolling engine with advanced notation support. The foundation of the RANDSUM ecosystem.

  • Advanced dice notation (4d6L, 2d20H, etc.)
  • Reroll modifiers
  • Exploding dice
View Documentation →

Game Packages

Specialized mechanics for popular tabletop RPG systems

Blades in the Dark

@randsum/blades

Blades in the Dark system mechanics including action rolls, position, effect, and stress tracking.

View Documentation →

Daggerheart

@randsum/daggerheart

Daggerheart RPG system support with hope and fear dice mechanics.

View Documentation →

D&D 5th Edition

@randsum/fifth

Dungeons & Dragons 5th Edition mechanics including ability checks, saving throws, and combat rolls.

View Documentation →

Root RPG

@randsum/root-rpg

Root RPG system implementation with reputation, relationships, and advancement mechanics.

View Documentation →

Salvage Union

@randsum/salvageunion

Salvage Union mechanics for mech-based tabletop RPG gameplay.

View Documentation →

Tools & Integrations

MCP Server

@randsum/mcp

Model Context Protocol server for AI integration. Enables LLMs to roll dice and interact with RANDSUM packages.

View Documentation →

Discord Dice Roller

@randsum/robo

A Discord bot and activity for rolling dice in chat. Supports all RANDSUM game packages with beautiful embeds and detailed roll results.

View Documentation →

Quick Start

npm install @randsum/roller
# or
bun add @randsum/roller
import { roll } from '@randsum/roller';

// Simple roll
roll(20); // Returns 1-20

// With notation
roll('4d6L'); // Roll 4d6, drop lowest
roll('2d20H'); // Roll with advantage

Or use directly from your terminal:

npx randsum 2d20    # Roll two twenty-sided dice
npx randsum 4d6L    # Character stat roll (drop lowest)
npx randsum 2d20H   # Roll with advantage