Your game, your rules, your roll.
Dice Roller is a collection of open-source JavaScript and TypeScript tools for rolling dice in tabletop role-playing games.
At its heart is RPG Dice Roller, a flexible and powerful dice rolling engine that supports everything from simple dice rolls to complex expressions, modifiers, and custom game mechanics.
Whether you're building a virtual tabletop, a character sheet, a game companion, or something entirely different, Dice Roller provides the tools to bring dice rolling into your application.
- 🎲 Flexible dice notation — Roll standard, percentile, Fudge, and custom dice.
- ⚙️ Powerful modifiers — Exploding dice, rerolls, keep/drop, success counting, and more.
- 🧮 Complex expressions — Combine dice rolls with mathematical expressions and functions.
- 🧩 Extensible — Customise dice behaviour, modifiers, random number generation, and result presentation.
- 🌐 Framework integrations — Use the core library directly or integrate it with Vue, Markdown, and documentation frameworks.
Start off by checking out the installation instructions, dice notation, API references, and examples in the documentation.
Dice Roller is more than just a dice rolling library. The organisation maintains a collection of tools and integrations built around the core engine.
| Project | Description |
|---|---|
| 🎲 RPG Dice Roller | The core JavaScript dice rolling engine. |
| 🖥️ CLI | Roll dice directly from your terminal. |
| 🟢 Vue Components | Ready-to-use Vue components and composables for building dice rolling interfaces. |
| 📝 Markdown-it Plugin | Add dice rolling functionality to Markdown documents. |
| 📘 VuePress Plugin | Integrate interactive dice rolling into VuePress sites. |
| 📗 VitePress Plugin | Add dice rolling functionality to VitePress documentation. |
| 📚 Documentation | The documentation website, notation reference, and guides. |
Dice Roller is open source, and contributions are always welcome!
Whether you've found a bug, have an idea for a new feature, want to improve the documentation, or would like to contribute code, we'd love to hear from you.
Our projects are released under the MIT licence, allowing them to be used freely in personal and commercial projects.
