@randsum/blades

Blades in the Dark compatible dice rolling for randsum

A utility for rolling dice in Forged in the Dark systems!

• 🎲 Standard Blades in the Dark position and effect rolls
• 🎯 Automatic handling of dice pools
• 🔒 Full TypeScript support
• 🪶 Lightweight implementation

Installation

npm install @randsum/blades
# or
yarn add @randsum/blades
# or
bun add @randsum/blades

Usage

import { rollBlades } from '@randsum/blades'
import type { BladesResult } from '@randsum/blades'

// Basic roll with dice pool
const result = rollBlades(2)
// Returns the highest die result and determines outcome

API Reference

rollBlades

Makes a Blades in the Dark roll, returning the result based on the highest die.

function rollBlades(dicePool: number): BladesResult

type BladesResult = 'critical' | 'success' | 'partial' | 'failure'

Related Packages

• @randsum/dice: Core dice rolling implementation
• @randsum/notation: Dice notation parser

Made with 👹 by RANDSUM