https://github.com/krishnakanthb13/anp-19-dice
A comprehensive dice roller and randomizer plugin for Amplenote — roll basic/advanced/RPG dice formulas, use specialized dice (Sicherman, intransitive, poker), Fudge/Fate, Fantasy AGE stunts, Magic 8-Ball, Sai Baba, and table-based randomizers. Includes audit logging and note navigation.
https://github.com/krishnakanthb13/anp-19-dice
amplenote amplenote-plugin dice dice-roller esbuild javascript randomizer rpg tabletop
Last synced: about 14 hours ago
JSON representation
A comprehensive dice roller and randomizer plugin for Amplenote — roll basic/advanced/RPG dice formulas, use specialized dice (Sicherman, intransitive, poker), Fudge/Fate, Fantasy AGE stunts, Magic 8-Ball, Sai Baba, and table-based randomizers. Includes audit logging and note navigation.
- Host: GitHub
- URL: https://github.com/krishnakanthb13/anp-19-dice
- Owner: krishnakanthb13
- License: other
- Created: 2026-06-16T07:08:06.000Z (13 days ago)
- Default Branch: main
- Last Pushed: 2026-06-27T14:13:18.000Z (2 days ago)
- Last Synced: 2026-06-27T15:10:07.414Z (1 day ago)
- Topics: amplenote, amplenote-plugin, dice, dice-roller, esbuild, javascript, randomizer, rpg, tabletop
- Language: JavaScript
- Homepage: https://github.com/krishnakanthb13/anp-19-dice
- Size: 122 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🎲 Dice Roller and Randomizer
> **A comprehensive plugin for Amplenote to run general dice rolls, advanced mathematical formulas, RPG-specific systems, divination-style randomizers, and table-based selections.**
---
## ✨ Features
- **Basic & Advanced Rolls**: Standard dice with modifiers (keep, drop, explode, unique) and complex mathematical expressions (`3d4 + 2d6 * 5`).
- **RPG Systems built-in**: First-class support for *Fudge/Fate* dice, *Fantasy AGE* stunt rolls, and *Shadowrun/WoD* Dice Pools.
- **Table Randomizer**: Pick random row/column combinations directly from your Amplenote markdown tables.
- **Divination & Oracles**: Includes classic *Magic 8-Ball*, *Ask Sai Baba*, *Tarot Cards*, and specialized dice (Poker, Sicherman, Intransitive).
- **Generators & Tools**: Use the *Name Generator*, *Weighted Random*, and *Decision Matrix* to spark creativity or make unbiased choices.
- **Persistent History**: Automatically logs every roll into a centralized `Dice Results Audit` note so you never lose track of your campaign results.
---
## 🛠️ Installation
1. Create a new note in Amplenote and title it **`Dice Roller and Randomizer Plugin`**.
2. Add the following Settings table to the note:
| Field | Value |
| :--- | :--- |
| `name` | Dice Roller and Randomizer |
| `icon` | casino |
| `description` | Comprehensive dice rolling, game systems, and random generators for Amplenote. |
| `settings` | |
| `Previous_Roll` | |
| `Previous_Roll_Spc` | |
| `Previous_Roll_FF` | |
| `Previous_Roll_AGE` | |
| `Previous_Roll_Ran` | |
| `Previous_Weighted` | |
| `Previous_DicePool` | |
| `Dice_Audit_UUID [Do not Edit!]` | |
*(Note: Leave the setting values blank during first installation. The plugin will manage them automatically.)*
3. Below the table, insert a **JavaScript code block** and paste the compiled plugin code from `build/dice.compiled.js` into it.
4. Go to **Account Settings > Plugins** in Amplenote and select your newly created plugin note to activate it.
---
## 🚀 Usage Guide
Once activated, the plugin registers several app-level commands and one note-level command:
### 🎲 General Dice
- **`Basic`**: Rolls standard dice with configurable modifiers (faces, min/max limits, keep/drop, exploding, unique).
- **`Advanced`**: Evaluates mathematical dice expressions (e.g., `3d4 + 3` or `1d12 + 1d10 + 5`).
- **`Quick Roll Presets`**: Easily pick standard RPG rolls (e.g. D20, 2d6, D&D Ability Score) and add modifiers.
- **`Percentile (D100)`**: Roll 00-99 or 1-100, and even supports "flip to succeed" mechanics.
### ⚔️ Game Systems
- **`Fudge/Fate`**: Rolls standard Fate dice (`+`, ` `, `-`) and calculates the total.
- **`Fantasy AGE Stunt - Single Roll`**: Rolls a stunt check, detecting doubles and stunt points.
- **`Fantasy AGE Stunt - Roll All At Once`**: Run stunt checks for an entire party in one go.
- **`Dice Pool (Shadowrun/WoD)`**: Roll a pool of d6s against a Target Number, counting hits and handling exploding 6s.
### 🔮 Oracles & Divination
- **`Specialized`**: Simulates Sicherman, Intransitive, or Poker dice with optional probability outputs.
- **`8 Ball`**: Answers your yes/no questions with classic Magic 8-Ball responses.
- **`Ask Sai Baba`**: Pulls one of 720 spiritual guidance responses.
- **`Tarot Cards`**: Draw single cards, 3-card spreads, or full Celtic Cross layouts, complete with meanings.
### 🛠️ Generators & Tools
- **`Weighted Random`**: Select from a custom list of items where some items are more likely to be picked than others.
- **`Decision Matrix`**: Rank options against weighted criteria to find the optimal choice.
- **`Name Generator`**: Generate random names in Fantasy, Sci-Fi, or Norse styles, optionally with titles.
- **`Table - Randomizer`** *(Note Action)*: Run this from inside a note to pick random row/column combinations directly from tables.
### 📜 History & Management
- **`View Roll History`**: Jump instantly to your `Dice Results Audit` note.
- **`Clear Audit History`**: Erase your roll history (requires confirmation).
---
## 💻 Technical & Development
The source code is modularly structured inside the `lib/` directory and bundled for Amplenote execution using `esbuild`.
- **Entry Point:** `dice.js`
- **Build Process:** Run the repository's build pipeline to compile source files into `build/dice.compiled.js`.
- For deeper technical context, see [CODE_DOCUMENTATION.md](CODE_DOCUMENTATION.md) and [DESIGN_PHILOSOPHY.md](DESIGN_PHILOSOPHY.md).