dice-roller

Parse dice expressions and return JSON with rolls, modifier, and total.

3|Updated Dec 14, 2025

Search Tags:#bash #JSON #random #roll #RPG #dice-roller #dice

One-click install

npx skills add https://github.com/rjroy/adventure-engine-corvran --skill dice-roller

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: dice-roller
Source: https://github.com/rjroy/adventure-engine-corvran/tree/main/corvran/skills/dice-roller
Command: npx skills add https://github.com/rjroy/adventure-engine-corvran --skill dice-roller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Gamemasters and players often need deterministic dice outcomes with structured, machine-readable results. This Skill provides a Bash script that parses a dice expression and returns a JSON payload containing the expression, individual rolls, modifier, and total.

Core Features & Use Cases

Supports common expressions such as 1d20, 2d6, 1d20+5, 3d8-2, 4dF (Fudge dice), and d100.
Outputs a JSON object with fields like expression, rolls, modifier, and total (plus extra fields for DdD in the Duality Dice variant).
Useful for skill checks, attack rolls, saving throws, and initiative resolution.
Includes a test script (roll.test.sh) to validate behavior.

Quick Start

Example: run a roll with 2d6+3 to obtain a JSON payload with the total and individual rolls.