RANDSUM Discord Dice Bot — D&D, Blades, PbtA & More
See the Discord Bot landing page for screenshots and quick setup.
The RANDSUM Discord Bot is a Discord application for rolling dice in chat. Built with discord.js and Bun, it provides detailed roll breakdowns and full support for all RANDSUM game packages.
Add to your server
Section titled “Add to your server”Add the bot to any Discord server with one click:
No configuration is required after adding.
Commands
Section titled “Commands”The core dice rolling command. Supports the full RANDSUM dice notation with detailed breakdowns showing individual die results, modifiers, and final totals.
/roll notation:4d6L+2/roll notation:2d20H/roll notation:3d8+5/blades
Section titled “/blades”Roll Blades in the Dark action rolls. Takes the number of dice in your pool and returns the outcome (critical, success, partial, or failure) with color-coded embeds.
/blades dice:3/blades dice:2/blades dice:0 # Desperate position (rolls 2d6, takes lowest)/fifth
Section titled “/fifth”Roll D&D 5th Edition dice (1d20 + modifier). Supports advantage and disadvantage. Natural 20 results display in gold, natural 1 in crimson — visible at a glance.
/fifth modifier:5/fifth modifier:3 rolling_with:Advantage/fifth rolling_with:Disadvantage/fifth # Straight 1d20Roll Daggerheart mechanics with hope and fear dice. Supports modifiers, advantage/disadvantage, and amplification of hope or fear dice.
/dh modifier:5 rolling_with:Advantage/dh modifier:3 rolling_with:Disadvantage/dh amplify_hope:true amplify_fear:false/dh modifier:2Roll Root RPG mechanics. Rolls 2d6 with an optional modifier and returns the outcome (Strong Hit, Weak Hit, or Miss).
/root modifier:2/root modifier:-1/root # No modifierRoll on Salvage Union tables. Supports all Salvage Union tables including Core Mechanic, Morale, and others.
/su table:Core Mechanic/su table:Morale/su # Uses default tableRoll Powered by the Apocalypse moves (2d6 + stat). Supports forward, ongoing bonuses, and advantage/disadvantage.
/pbta stat:2/pbta stat:1 forward:1/pbta stat:3 rolling_with:Advantage/pbta stat:0 ongoing:1/notation
Section titled “/notation”Display a reference guide for RANDSUM dice notation. Shows all available modifiers, syntax, and examples.
/notationLists all available RANDSUM slash commands with descriptions.
Game Support
Section titled “Game Support”The following game packages have dedicated slash commands:
- @randsum/games/fifth —
/fifthfor D&D 5th Edition rolls - @randsum/games/blades —
/bladesfor Blades in the Dark action rolls - @randsum/games/daggerheart —
/dhfor Daggerheart hope and fear dice - @randsum/games/pbta —
/pbtafor Powered by the Apocalypse moves - @randsum/games/root-rpg —
/rootfor Root RPG mechanics - @randsum/games/salvageunion —
/sufor Salvage Union table rolls
Features
Section titled “Features”- Detailed breakdowns — Shows individual die results, modifiers, and step-by-step calculations
- Full notation support — All RANDSUM dice notation features (drop, reroll, explode, etc.)
- Game-specific commands — Dedicated commands for each supported RPG system
- Color-coded embeds — Results are visually distinct by outcome type
Example Results
Section titled “Example Results”See what RANDSUM bot results look like in practice.
Self-Hosted Setup
Section titled “Self-Hosted Setup”If you prefer to run the bot yourself:
# From the monorepo rootcd apps/discord-bot
# Install dependenciesbun install
# Set up environment variablescp .env.example .env
# Deploy commandsbun run deploy-commands
# Run the botbun run devFor detailed setup instructions, see the Discord Bot source on GitHub.