Blades in the Dark

@randsum/blades

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

Overview

@randsum/blades provides comprehensive support for Blades in the Dark system mechanics. This package includes action rolls, position and effect tracking, stress management, and all the core mechanics needed to run Blades in the Dark games.

Installation

Installation

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

Examples

Basic Roll

import { rollBlades } from "@randsum/blades"
import type { BladesRollResult } from "@randsum/blades"

// Basic roll with dice pool
const { outcome, result } = rollBlades(2)
console.log(outcome) // 'critical' | 'success' | 'partial' | 'failure'

Different Dice Pool Sizes

import { rollBlades } from "@randsum/blades"

rollBlades(1) // Desperate position
rollBlades(2) // Risky position
rollBlades(3) // Controlled position
rollBlades(4) // Controlled with assistance