Dice Roller Pro - Dice Notation Parser, Exploding Dice & Roll History for RPGs

⚡ KEY FEATURES

🎯 Comprehensive Dice Notation Parser - Standard `NdX`, percentile (`d%` / `d100`), Fate/Fudge (`dF`), custom faces (`d[2,4,6,8]`), and full mathematical expressions: `+ - * / %`, parentheses, unary minus, and grouping `{…}`.

🎲 Every Modifier You Need

• Keep / Drop - `kh`, `kl`, `dh`, `dl` (D&D 5e ability scores, advantage, disadvantage)
• Exploding - `!` basic, `!!` compound, `!p` penetrating
• Reroll - `r` recursive, `ro` once, `rr` reroll-and-keep (Great Weapon Fighting)
• Min / Max Clamp - `mi`, `ma` ("treat damage of less than 2 as 2")
• Critical / Fumble - `cs`, `cf` with full comparator support (`cs>=19cf=1`)
• Success Counting - `5d10>=8` for Storyteller / WoD / dice pools, with `f<comp>` botch subtraction
• Display Sort - `s` / `sa` / `sd` (cosmetic, totals unchanged)
• Math Functions - `min`, `max`, `abs`, `floor`, `ceil`, `round` for advantage rolls and capped damage

🛠️ Three Editor Windows

• Expression Builder - form-style composer with a dice-kind picker, full modifier coverage in collapsible sections, live canonical-notation preview, Test Roll, and Save as Asset. No more memorising `kh3` vs `dl1`.
• Expression Validator - instant parser feedback with severity-graded warnings.
• Probability Analyzer - Monte Carlo simulator (1k – 1M iterations, seedable) with mean / stddev / 95 % CI / ASCII histogram and a side-by-side two-expression compare mode.

🧩 ScriptableObject-First Workflow - Every dice type is a Unity asset. Drag into Inspector slots, share across prefabs, version-control as text. Custom inspectors with reorderable lists for groups and sequences, an inline Roll Preview (seed + histogram) on every dice asset, and per-type asset icons.

🎲 Pluggable RNG - Cross-platform deterministic RNG, snapshot / restore for save-games, and record / replay for bug repros and regression tests. Critical for multiplayer authoritative rolls and competitive game determinism.

⚡ Async + Bulk Rolling - Run any roll on the thread pool. Roll millions of iterations into a stats snapshot (count / min / max / mean / histogram) without stalling the main thread. Provides blazing fast running statistics.

🔍 Validation Framework - Catch invalid expressions, conflicting modifiers, and performance pitfalls *before* runtime. Severity-graded (Critical / Error / Warning / Info), category-tagged, with inline suggestions. Safe for user-generated content and modding scenarios.

🧠 Programmatic API - Static and fluent **`ModifiersBuilder`** for typed, validating, frozen-on-Build configuration. One-line API for game code; full extensibility when you need it.

⚡ Performance-First - Span-based parsing (zero-allocation hot paths), expression cache (auto-prewarmed), per-thread RNG. Designed for thousands of rolls per frame.

🎮 PERFECT FOR

• Tabletop RPG implementations - D&D 5e, Pathfinder, Call of Cthulhu, Storyteller / WoD, Fate, custom systems
• Board & strategy games - advantage rolls, dice pools, weighted outcomes
• Roguelikes & procedural generators - exploding loot tables, weighted custom dice, deterministic seeded runs
• Multiplayer & competitive games - authoritative rolls with snapshot / restore RNG
• Game prototypes & jams - go from "I need a dice roll" to working code in one line
• Tools and editors - modders and designers compose expressions visually instead of editing code

⚙️ TECHNICAL DETAILS

• Full C# source included - XML docs throughout
• Thread-safe parser, per-thread RNG, span-based parsing
• Hard parser caps (`MaxInputLength`, `MaxRecursionDepth`, `MaxRollNodes`, `MaxCompoundChain`) make user-input rolling safe
• No external dependencies, no third-party packages
• Formal EBNF grammar included

🚀 WHY DEVELOPERS CHOOSE DICE ROLLER PRO

• Skip weeks of parser work - every notation form your players know already works
• Catch errors before runtime - the validation framework reports actionable issues with severity and suggestions
• Compose visually, not in your head - the Expression Builder writes the notation for you
• Debug probability, not vibes - the Probability Analyzer tells you exactly what your roll does
• Reproducible randomness - `IDiceRng` makes save-load, replay, and unit tests trivial
• Production-grade performance - span-based parsing, pooled buffers, thread-safe by design

📦 INCLUDED CONTENT

• Full C# source with XML documentation
• Three editor windows (Expression Builder, Expression Validator, Probability Analyzer)
• Custom inspectors for every dice asset type, with inline roll preview
• Sample scene + UI script for runtime expression rolling
• Comprehensive documentation with grammar, examples, and integration recipes

🎯 Stop reinventing the dice wheel. Drop in Dice Roller Pro and ship the dice mechanics your game deserves - validated, performant, and easy to author.