Using Dice Tags
How to roll dice in posts using the [dice] tag syntax.
Using Dice Tags
Dice rolls are inserted into posts using the [dice] BBCode tag. Results are rolled at post-submit time, stored permanently, and displayed below your post content — they cannot be changed by editing.
Basic Syntax
[dice]expression[/dice]The expression inside the tag follows standard dice notation.
| Example | What it rolls |
|---|---|
[dice]1d20[/dice] | One 20-sided die |
[dice]2d6[/dice] | Two 6-sided dice, summed |
[dice]3d8+5[/dice] | Three 8-sided dice plus a flat +5 modifier |
[dice]1d20-2[/dice] | One d20 minus 2 |
[dice]1d20+2d6[/dice] | A d20 and 2d6 combined |
[dice]d20[/dice] | Shorthand for 1d20 — the leading 1 is optional |
Limits: up to 100 dice per group, up to 1000 sides per die. The maximum number of [dice] tags per post is set by your administrator (default: 10).
Drop / Keep Notation
Roll extra dice and automatically discard the lowest (or keep the highest).
| Syntax | Meaning |
|---|---|
4d6k3 | Roll 4d6, keep the 3 highest |
4d6d1 | Roll 4d6, drop the 1 lowest (same result as 4d6k3) |
[dice]4d6k3[/dice]
[dice]4d6d1[/dice]Dropped dice are shown with a strikethrough in the breakdown so the full roll is always visible.
Hidden Rolls
Add hidden as an attribute to make a roll private:
[dice=hidden]1d20[/dice]Hidden rolls are visible to:
- You — the person who rolled
- Administrators and super moderators
- GM usergroups configured by your administrator
Everyone else sees nothing where the roll would normally appear.
Roll Labels
Add a label attribute to annotate what a roll is for:
[dice=label="Attack Roll"]1d20+5[/dice]
[dice=label="Damage"]2d6+3[/dice]The label appears as a small badge in the roll header next to the roll title. Labels can be up to 120 characters. Quotes are optional for single-word labels.
Dice Profiles
Profiles are administrator-defined presets referenced by a slug. Using a profile may apply custom rendering based on the result total, override your expression with a fixed one, or restrict which results are recorded.
[dice=attack_roll]1d20[/dice]Combining Options
Use a pipe | to combine a profile slug, hidden, and/or a label in any order:
[dice=attack_roll|hidden]1d20[/dice]
[dice=attack_roll|label="Stealth Check"]1d20[/dice]
[dice=attack_roll|hidden|label="Secret Save"]1d20[/dice]
[dice=hidden|label="GM Roll"]1d20[/dice]Multiple Rolls in One Post
You can include several dice tags in a single post — each produces its own independent roll block:
[dice=label="Attack"]1d20+5[/dice]
[dice=label="Damage"]2d6+3[/dice]
[dice=label="Crit Damage"]2d6+3[/dice]Editing Posts
Dice tags cannot be used when editing a post (in default configuration). Existing rolls attached to a post are unaffected by edits — they remain displayed as originally rolled. This is intentional to preserve roll integrity.
How Results Are Displayed
Each roll renders as a card beneath your post showing:
- The total (large number)
- The formula as you wrote it
- A breakdown of every die rolled, including individual values, any dropped dice, and flat modifiers
- A conditional instruction if the roll's profile has a matching rule for the total
Roll results are permanent and will still be displayed even if you edit the post body later.