From Simple Rolls to Full RPG Combat Engines — One Toolkit to Roll Them All.
IMPORTANT: THIS IS NOT A DICE ROLLING ANIMATION FRAMEWORK.
IT IS A FULLY FLEDGED DICE ROLL ENGINE WITH DEEP CUSTOMIZATION OPTIONS.
OVERVIEW
The Ultimate Dice Roll Toolkit is a complete, production-ready dice framework
for Unity. It provides everything from simple random rolls to complex RPG
combat systems, built on a fully documented and customizable API.
With 10 core roll types, 77 conditional rule combinations, and 4 opposed-roll
resolution modes, you can design mechanics ranging from quick skill checks to
full-blown contested encounters — and a built-in dice notation parser
(`DiceAPI.Roll("4d6kh3+2")`) lets you express any of them in a single line.
The toolkit ships with eight professional editor tools — custom inspectors,
three guided wizards, and five live-exploration windows — that integrate
seamlessly with the Unity Editor. They eliminate guesswork, surface real-time
validation, and let you rapidly prototype and balance your systems.
A built-in JSON import/export system (Schema 2.0, with conflict resolution)
makes your dice configurations portable, shareable, and version-control
friendly — perfect for collaborative teams or AI-assisted workflows.
Four playable demo scenes are included so you can see every major feature
running in a real Unity scene before you write a line of your own code.
WHAT'S NEW IN v2.0
- Dice notation parser — type "8d10>=7f1" or "2d6!p" or "4dF+2"
- Four new roll types — Fate / Custom Face / Step Dice / Count Modes
- Penetrating exploding + pool botch / cancel tracking
- Super Advantage (N-die advantage / disadvantage) baked into the core API
- Roll History — runtime ring buffer with one-line production opt-out
- Animation event hooks — DiceEvents.OnRollComplete and friends
- Probability Calculator gains a Compare mode (overlaid distributions)
- Three new editor windows — Notation Roller, Roll History, Seed Explorer
- Demo Hub launcher + four bundled vertical-slice demos
- JSON Schema 2.0 — conflict resolution, light/full/markdown export
- Every known V1 bug fixed across a 29-bug sweep
CUSTOMIZABILITY
Every configuration is fully customizable through both the editor and API.
You can define:
Roll Types
Normal, Advantage, Disadvantage, Exploding, Pool, Drop, Fate, Custom Face,
Step Dice, Count Modes.
Conditional Rules
11 trigger types (OnMax / OnMin / OnValue / OnRange / OnDoubles /
OnTriples / OnSequence / OnSuccess / OnFailure / OnMargin / OnSum) and
7 actions (RollBonus / AddValue / MultiplyResult / Cascade / RerollDie /
SetFlag / ModifyNext) — 77 combinations, priority-ordered, with cascade
limits and tuple-return modifier carry-forward.
Opposed Rolls
Simple, Margin, Contested, or Blackjack resolution — multi-dice per side,
tie-break policies, and full margin-of-victory data.
Probability Analysis
Monte Carlo simulations (1K–100K iterations) with mean / median /
percentile breakdowns and side-by-side Compare mode for tuning.
Sessions
Up to 20 labeled dice per session, session-level modifiers, per-die
enable/disable, full SessionResult with per-die breakdown.
================================================================================
SUITABLE GENRES
================================================================================
The toolkit is designed for:
- RPGs & Tabletop Adaptations — combat rolls, skill challenges, spellcasting
- Strategy & Tactics — opposed rolls, margin-based success
- Roguelikes & Procedural Games — probability-driven mechanics
- Narrative & Symbol-Dice Games — Custom Face dice with cancellation rules
- Card / Board Game Companions — pattern detection via Count Modes
- Any dice-driven system that needs reliability, flexibility, and balance
validation
…and more.
In the end, the ultimate roll is yours — this toolkit gives you every side of
the dice, but what you choose to build with it is entirely up to your
imagination.
From simple chance to complex RPG systems, every possibility is in your hands
to create.
DOCUMENTATION
Offline documentation ships with the package — nine HTML pages covering
Getting Started, the User Guide, full API reference, system architecture,
editor tools, advanced features, code examples, and an About page.
Accessible in-editor under Window → Living Failure → Ultimate Dice Toolkit
→ Documentation.