Dice Macros
Build multi-step dice roll flows with prompts, bonus toggles, pool building, and result interpretation for any TTRPG system.
Overview
Dice macros turn a simple roll button into an interactive flow. Instead of typing notation, the player fills in choices (position, bonus dice, modifiers) and clicks Roll. The system computes the dice pool, rolls, and interprets the result — all in one popover.
Macros work on any roll block or stat block. Switch to Macro mode via the gear icon on the block.
How It Works
- Author builds the flow — Open the macro builder dialog and define steps: prompts, toggles, formulas, rolls, and interpretation bands
- Player clicks Roll — A popover appears with all the inputs
- Player makes choices — Toggle bonus dice, select position/effect, adjust extra dice
- Result appears — Total, dice breakdown, and a colored outcome badge (e.g., "Partial Success")
- Posts to chat — The full roll with all context goes to the space chat
Step Types
| Step | What it does |
|---|---|
| Prompt | Asks the player for input — a dropdown selection or a number |
| Toggle Group | A set of on/off switches that each add dice to the pool |
| Compute | Calculates a value using a formula that references prior steps |
| Roll | Rolls dice using notation with variable interpolation |
| Interpret | Maps the roll result to an outcome (e.g., 1-3 = Failure, 4-5 = Partial, 6 = Success) |
| Text | Shows instructions or flavor text to the player |
| Branch | Swaps the notation based on a condition (e.g., different rolls for zero-dice pools) |
Steps reference each other by name using \{Step Name\} syntax.
Presets
Don't want to build from scratch? The macro builder offers 5 preset templates for common TTRPG systems:
Blades in the Dark — Action Roll
Includes Position and Effect dropdowns, Push Yourself / Devil's Bargain / Assist toggles, Extra Dice input, pool computation, zero-dice handling (roll 2d6 keep lowest), and result interpretation with critical detection.
PbtA — Move (2d6 + stat)
Stat modifier input, 2d6 + modifier roll, and three-band interpretation: Miss (6-), Weak Hit (7-9), Strong Hit (10+).
Savage Worlds — Trait Roll
Trait die selector (d4-d12), wild die (d6), both exploding, compute best of two, interpret with raises.
Shadowrun — Dice Pool
Pool size input, Edge toggle, threshold roll (count 5s and 6s as hits), interpret success level.
Simple d20 + Modifier
Modifier input, 1d20 + modifier, result bands from Critical Fail to Natural 20.
Building a Custom Macro
- Insert or select a roll block
- Click the gear icon and switch to Macro
- Click Configure Macro to open the builder
- Pick a preset to start from, or click "Start from scratch"
- Add steps using the buttons at the bottom: Prompt, Toggles, Compute, Roll, Interpret, Branch, Text
- Configure each step — set labels, options, formulas, notation, and interpretation bands
- Click Save
The roll block now shows "Macro" and clicking Roll opens the interactive popover.
Conditional Notation
Some TTRPG systems have edge cases where the roll changes based on the pool size. For example, in Blades in the Dark, a zero-dice pool rolls 2d6 and keeps the lowest instead of the highest.
Roll steps support conditional notation: toggle the checkbox, set a condition (e.g., \{Pool\} > 0), and provide separate notation for the true and false cases.
Result Interpretation
The Interpret step maps roll results to labeled outcomes with colors:
| Color | Typical use |
|---|---|
| Red | Failure, Miss |
| Amber | Partial success, Weak hit |
| Green | Full success, Strong hit |
| Blue | Critical, Special success |
| Purple | Custom |
| Gray | Neutral |
Band Modes
- Threshold — first band where total ≤ max matches (good for PbtA: ≤6, ≤9, else)
- Range — min-max ranges (good for d100 systems)
- Exact — specific values (good for Fudge/FATE ladder)
Critical Detection
Enable the "Critical condition" checkbox and set a minimum count. For example, "Critical when 2+ dice show max value" detects Blades in the Dark criticals (two or more sixes).
Chat Integration
Macro rolls post to the space chat with full context:
- Dropdown choices shown as labeled values (e.g., "Risky Position, Standard Effect")
- Active toggles and extras shown as highlighted chips (e.g., "Push Yourself +1d")
- Pool size displayed
- All dice shown individually — kept dice highlighted, other dice muted
- Interpretation badge colored next to the total