Dice Roller

WHAT IT DOES

Dice Roller provides a complete virtual dice rolling experience for tabletop gaming, role-playing games, and decision making. Roll any number of dice with 4, 6, 8, 10, 12, 20, or 100 sides. Add or subtract modifiers, roll with advantage (roll twice, take highest) or disadvantage (roll twice, take lowest). Use standard dice notation like "2d6+3" or shortcuts like "adv" and "disadv". The tool shows individual die results, the total sum, and includes a history of all rolls. Copy results to your clipboard with one click.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All dice rolling, calculation, and history tracking occur on your machine without any network requests. No dice data, roll history, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. Dice rolling uses the browser's built-in Math.random() function.

HOW TO USE

Click the extension toolbar icon to open the Dice Roller panel. Enter dice notation in the input field (e.g., "2d6+3", "adv", "disadv") and click "Roll". Or use the controls below: set the number of dice, select the dice type (d4, d6, d8, d10, d12, d20, d100), and add a modifier. Click "Roll" to roll the dice. Click "Advantage" to roll twice and take the higher result. Click "Disadvantage" to roll twice and take the lower result. The result appears in the output area showing individual dice and the sum. Click "Copy" to copy the result to your clipboard. The history panel shows recent rolls with timestamps; click "Copy" on any history entry to reuse it. Toggle "Show individual dice" to show or hide individual die results. Toggle "Enable history" to track your rolls. Use "Clear History" to remove all history entries.

THE DICE ROLLING ENGINE — WHY IT WORKS

Most dice rollers simply generate random numbers without providing context or flexibility. This tool implements a comprehensive dice rolling engine with support for multiple dice types and rolling mechanics. The engine uses Math.random() to generate uniform distributions for each die, then aggregates results with the specified modifier. The advantage/disadvantage mechanic rolls two dice and selects the highest or lowest, simulating the popular tabletop RPG rule. The dice notation parser handles standard formats like "2d6+3" and recognizes "adv" and "disadv" shortcuts. Each roll stores the individual results, the total, and the timestamp in the history. The individual dice display shows each die's result, making it easy to verify the roll. This approach provides a complete, flexible dice rolling experience for any gaming or decision-making scenario.

THE PANEL

The Dice Roller panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the input controls, output area, and history panel adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to roll dice in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The tool uses Math.random() which is suitable for gaming purposes but not cryptographically secure. Dice notation supports up to 100 dice per roll; rolling more may affect performance. The history is stored in memory and cleared when the page is refreshed. Advantage and disadvantage rolls are shown with both die results. All dice data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.