Importing & Exporting Saved Formulas

This page collects the essentials for bringing Saved Formulas into the app and exporting yours for safekeeping or sharing. If you want to learn how to build formulas or manage the list, see the related guides below.

Where to find it

• Open the Dice Roller.
• Use the on‑screen controls:
  • Desktop: “Save Formulas” and “Manage Formulas” buttons in the Dice Roller panel.
  • Mobile: “Save Formulas” and “Manage Formulas” buttons below the roller.

Import

• Tap “Manage Formulas” → Import and choose a JSON file.
• Import merges entries into your existing list (if a replace option is offered, choose carefully; merge is safer).
• File names: Import accepts any filename. If you manually place a file instead of importing, it must be named saved_formulas.json.

Supported shapes

• Canonical wrapped file (recommended):

{
  "formulas": [
    { "formula": "2d20kh+5", "name": "Advantage +5", "description": "D&D 5e attack check" }
  ],
  "schemaVersion": 1
}

• Compatibility: The app accepts a top‑level array or a single formula object on import and normalizes to the wrapped format when exporting.

Export

• Tap “Manage Formulas” → Export to download a JSON file you can back up or share.
• Manual placement: If you don’t use Import/Export and drop a file by hand, keep the exact filename saved_formulas.json so the app can find it.

Starter downloads

Ready‑to‑import formula sets for popular systems (merge‑friendly):

• D&D 5e: Download
• Pathfinder 2e: Download
• Shadowrun: Download
• Blades in the Dark: Download
• Savage Worlds: Download
• Year Zero Engine (partial): Download
• Vampire V5: Download
• PbtA: Download
• Fate Core: Download
• Call of Cthulhu 7e: Download
• Cypher: Download
• Warhammer (d6 pools): Download
• Lancer: Download
• Ironsworn: Download
• Starforged: Download
• Dungeon Crawl Classics: Download
• The One Ring (approximation): Download

Tip: Use Import to merge these into your current list. Manual placement requires the filename saved_formulas.json.

Best practices

• Keep names short and descriptive; add context in descriptions.
• Back up before large imports so you can roll back easily.
• Prefer the canonical wrapped format for sharing (includes formulas and schemaVersion).

Syntax engine and docs

The roller is powered by Adventuresmith’s dart_dice_parser. For the full grammar and additional examples, see: https://pub.dev/packages/dart_dice_parser

Related guides

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

• Save, load, import, export (UI walkthrough): “Saving and Managing Dice Formulas”
• File structure reference (JSON schema): “Formula Schema”