Getting Started with the Dice Roller

Dice Studio is where you build and test dice formulas. On a phone, open the drawer and tap DICE STUDIO. This quick start shows the basics so you can roll confidently right away.

Syntax engine and docs

The roller uses the app’s own version of Adventuresmith’s dart_dice_parser. The pub.dev page describes the original package, so check a formula in the app before you rely on it. For the full grammar and additional examples, see: https://pub.dev/packages/dart_dice_parser

Where rolls go

• A roll made in Dice Studio is a Studio test roll. It is not written to your Journal. Dice Studio keeps the 20 newest.
• A roll made in dice mode is written to your Journal as a General dice roll. To open dice mode, tap Switch to Dice Roller.
• The roll list in Dice Studio shows both.

The layout at a glance

• Formula field + Roll button: Type a formula (e.g., 1d20+5) and tap Roll.
• Quick‑add buttons: One‑tap actions insert dice, common modifiers, and operators (+, -, *, parentheses) into the formula field. The dice buttons are d4, d6, d8, d10, d12, d20, D100, 1D66, d2, and 4dF. The modifier buttons are Advantage, Disadvantage, Keep High, Keep Lowest, Exploding, Compounding, Reroll 1s, Reroll ≤2, Count Criticals, Cap at X, and Floor at X. Type drop (-H, -L), reroll once (ro), and count (#) yourself.
  • Numeric bonuses are typed by you after inserting the + or - operator (for example: +2).
• Roll feed: each row shows the formula, the final dice values, and the success and critical counts when the formula marks them. Entries are easy to scan.

Build your first rolls

1. Tap a die button (e.g., d20) and add a modifier (e.g., +5).
2. Or type directly: 1d20+5
3. To roll, tap Roll, the button with the d20 icon.

Common examples

• D20 + bonus: 1d20+3
• Advantage/Disadvantage: 2d20kh+5 (keep highest) or 2d20kl+5 (keep lowest)
• Damage dice: 2d6+3
• Percentile: 1d% (same as 1d100)
• Fudge/Fate dice: 4dF

Helpful basics you can try later

• Keep/Drop: 3d20kh2 (keep 2 highest) or 4d6-L (drop lowest)
• Exploding/Compounding: 4d6! (explode) or 5d6!! (compound); add o for once (!o, !!o)
• Reroll: 4d6r1 (reroll 1s), 4d6ro<2 (reroll once results under 2)
• Count successes: 6d6#>=5 (how many 5+)
• D66 (uppercase): 1D66 (lowercase d66 is a 66‑sider)

Tip: Use parentheses for clarity when mixing pools, e.g., (1d8!!+1d6!!) kh (Savage Worlds trait + wild, keep highest).

Saving and managing formulas

• Save Formula: Saves the current expression and lets you name/describe it.
  • Desktop: buttons appear above the formula field.
  • Save Formula saves the current formula and lets you give it a name and a description. On a phone the Save Formula and Manage Formulas buttons are under the formula field, and on a tablet or desktop they are above it.
• Manage Formulas: Import/Export, reorder, rename, and delete.
  • Import adds every formula in the file to the end of your Saved Formulas list. It does not check for duplicates.
  • If you place a file by hand, name it saved_formulas.json and put it in the formulas folder inside the app’s storage folder. That file becomes your whole list.

Results and readability

• Show dice total — Shows the total of each roll in the Dice Studio roll list. When off, a roll lists its dice without the total. A roll with no dice to list, such as a count, still shows its answer. The Adventure Log always shows the total. Dropped dice aren’t listed, and kept dice values generated by explosions still appear as ordinary numbers, without separate explosion highlighting.
• Short names and simple modifiers keep formulas scannable; add context in the Saved entry’s description when you save.

Related guides

See the Related Guides section at the bottom of this page.