
Dice+
Support Development
If you enjoy Dice+ and my other extensions, please consider supporting development on Patreon! Your support helps me continue creating and maintaining quality extensions for the Owlbear Rodeo community. See everything Premium adds, with every premium material, at dice-plus.missinglinkdev.com/premium.
Questions, ideas or bugs? Join the Dice+ Discord.
A feature-rich 3D dice roller extension for Owlbear Rodeo with deterministic physics, customizable dice, and advanced dice rolling capabilities. Roll your dice in beautiful 3D with realistic physics simulation while maintaining complete control over your dice collection and rolling options.
⚠️ Important Note About Physics Synchronization
Everyone sees the same roll. Dice physics is deterministic: each player's screen simulates the roller's throw from the same starting state and lands the same dice on the same faces, including exploding and re-rolled dice. The physics decides every result; nothing is steered towards a number. The roller's broadcasted results remain the source of truth, and in the rare case a screen's simulation drifts, its dice settle onto the roller's final positions.
Table of Contents
- Features
- Dice+ in Your Browser
- Adding Dice
- Dice Bag
- App Settings
- Dice Notation Reference
- Extension Integration
Features
- 3D Physics-Based Dice Rolling: Realistic dice rolling with deterministic physics using Three.js and Rapier physics engine
- Customizable Dice: Create custom dice with unique colors, materials, sizes, and shapes
- Custom Dice Faces: Change what any face shows — letters, symbols, emoji, or a different number — with built-in or Google fonts, adjustable size, rotation, and engraving, or start from a balanced Vertex sum or Honest Dice numbering (see Faces & Font)
- Custom Number Generator: Design your own dice numbers, text, and symbols with custom fonts and per-face layout controls; Premium users can upload the results as reusable font packs (see Custom Number Generator)
- Quick Roll Interface: Fast dice selection with intuitive left/right click controls
- Keyboard Roll Tool: Optional keyboard rolling with customizable dice and notation shortcuts, activated with R
- Advanced Dice Notation: Supports complex dice notation including advantage/disadvantage, exploding dice, re-rolls, min/max values, and more
- Dice Bag Management: Organize and manage your dice collection with filters, active/jailed states, and custom configurations
- Material System: Choose from a range of materials (Standard, Galaxy, Wood, Lava, Holographic, Damascus, and more) with extensive customization options
- Statistics Tracking: View detailed roll history and statistics for your dice
- Developer Integration: Broadcast channels for sending roll requests and receiving results from other extensions
- Browser Roller: Roll the same dice on their own at dice-plus.missinglinkdev.com/roll, no Owlbear Rodeo room needed, alone or in a room with friends (see Dice+ in Your Browser)
Dice+ in Your Browser
Dice+ also runs on its own at dice-plus.missinglinkdev.com/roll. It uses the same physics, dice bag, dice editor, notation and settings as the extension, with the tray filling the page. You roll alone until you start or join a room (see Rolling Together).
A few things work differently from the extension:
- One roll target when alone. Rolling alone, the roll button reads Roll with no target menu. Every roll counts as Everyone, so a Discord webhook still receives them. In a room the usual targets come back.
- No sharing with players. Dice and hotbar panels can't be sent to other players, even in a room, but they can still be copied and pasted as text.
- Hotkeys are always listening. With App Settings → Keyboard → Enable hotkeys on, type dice notation or a hotkey anywhere on the page to start a keyboard roll. There is no tool to switch to. See Keyboard Roll Tool for the default hotkeys.
- Room, settings and help in the corner. Under the Premium button in the top-right corner, the people icon opens the room, the gear opens App Settings (which isn't in the dice bag on the website), the phone icon installs the app, and the ? opens this guide in a new tab.
- Movable controls. Drag the controls panel by its grip to put it anywhere. It fits your chosen layout, and the browser remembers where you left it.
- On a phone, the controls get their own space. The tray takes the top of the screen and the controls sit under it, so they never cover your dice. Turn the phone sideways and the controls move to a column on the right. Phones always use the Grid layout, with the dice sized to fit the screen, so the Layout setting is hidden there. Tap the handle on the controls' edge to hide them and give the tray the whole screen, and tap it again to bring them back. The menu button at the top left of the tray holds Premium, the room, settings, install and help.
- Results as notifications on a phone. Each result slides in at the top of the tray, then after a few seconds shrinks to a small button showing the last total and how many rolls are in history. Swipe a result up to put it away early. Tap the result or the button to open your roll history over the controls.
- Your name and color. Set them under App Settings → Player. They label your rolls and Discord posts.
- A felt tray. Dice land on felt with the Dice+ logo stitched in. Pick its color under App Settings → Player → Tray background.
- No performance mode. It only simplifies other players' dice.
- Install it as an app. Choose the phone icon in the top-right corner to put Dice+ on your home screen or desktop. It then opens full screen from its icon, without the browser around it. On iPhone and iPad the button shows the steps instead: Share, then Add to Home Screen. The icon doesn't appear once Dice+ is installed, or in browsers that can't install it. On iPhone and iPad the installed app keeps its own dice bag and settings apart from Safari's, so sign in with Patreon to bring your dice across, and type the room code and passcode into the room dialog to join.
Premium on the website: choose Premium · Sign in in the top-right corner (or Sign in with Patreon in the dice bag) and sign in with Patreon. Your premium dice, materials, font packs and uploaded models unlock, and cloud sync brings in the same dice bag, hotbars and history as your Owlbear Rodeo account. If you have linked more than one Owlbear Rodeo account, pick which one the website uses from the Patreon button's Use dice from menu. If you sign in on the website before ever using the extension, connecting Patreon in the extension later brings the dice you made on the website with it.
Free Patreon members: a free membership is enough to back up your dice bag. Sign in on the website, or choose Connect Patreon in the extension's dice bag and enter your Patreon email, and the same bag follows you between Owlbear Rodeo, the website and your other devices. Everything else stays premium, including history, stats and hotbar sync.
Without a Patreon membership, your browser keeps the website's dice bag and settings separately from the extension's, so the roller starts with the default dice the first time you open it.
Rolling Together
Rooms let friends roll together on the website. Everyone in a room watches each other's dice tumble and land, with the same physics and the same result on every screen. Another player's result pops up only once their dice have landed on your screen, so the total never gives the roll away early. This works the same in Owlbear Rodeo.
- Start a room. Choose the people icon in the top-right corner, then Create a room. The room gets a room code like
K7M2-QX9Pand a six-digit passcode, each with a copy icon. Send both to your friends. The refresh icon beside the code starts over with a new code and passcode, leaving everyone else behind. - Join a room. Open dice-plus.missinglinkdev.com/roll, choose the people icon, enter the Room code and Passcode, and choose Join. Codes don't care about capitals or the dash. You can be in one room at a time, and every tab you have open follows you into it.
- Passcode (Host). The passcode keeps out anyone who only has the room code. The Host can type a new one straight into the Passcode field, or clear it so the code alone gets people in. Changing it doesn't remove anyone already in the room. A player whose passcode no longer works is asked for the new one. After too many wrong passcodes the room stops accepting them for a few minutes.
- Join an Owlbear Rodeo game. When a GM opens their Owlbear Rodeo room to the website (see Cross-platform Table), its room code and passcode put you at their table: you see the Owlbear Rodeo players' dice, and they see yours. Their GMs are the GMs, and only they can remove guests.
- Already in the Owlbear Rodeo room? Joining one asks Are you in this OBR room? Pick yourself from its players and choose Allow on the card that appears in Owlbear Rodeo. From then on you roll from the website as that player: your Owlbear Rodeo name and color, your rolls in your Owlbear Rodeo history, and nobody sees a second you. This device remembers it. Choose I'm a new player to join as yourself instead, or Roll as… / Unlink in the room card to change your mind later.
- Host and GM. Whoever creates the room is its Host and starts as the GM. The Host can switch GM on or off for anyone in the room's list, so the GM doesn't have to be the Host. The Host or a GM can remove a player with the remove button beside their name.
- Roll targets. Everyone rolls show for the whole room. GM & Self and GM Only rolls reach only the GMs, and Self rolls never leave your browser.
- Rolling from another tab. Your rolls still go through when the tab with Dice+ is in the background, for example when you roll from a character sheet with the Dice+ browser extension while Owlbear Rodeo is in another tab. The dice tumble for everyone watching and the result arrives at the usual time. Switch back while the dice are still rolling and you see the rest of the throw. If you come back after the roll has landed, your result is already in the results panel and history. Other players' rolls behave the same way: come back mid-roll and you join the throw where it is.
- Catching up. Someone who joins later gets the room's recent public rolls in their roll history.
- Leaving. Choose Leave room to go back to rolling alone. A room nobody has had open for a few hours closes on its own, and the next visit starts alone again.
- Your dice. Other players see your dice as you made them, including premium materials, custom models and font packs, even without Premium themselves.
- Use your phone as a controller. At a table that shares one screen, open the room dialog on your phone and turn on Use this device as a controller. Your phone keeps the dice controls where they are and shows the room's results as a list where the dice would roll, newest at the bottom. When you roll, the dice tumble on everyone else's screen, not on your phone. The controls show Rolling… until the roll is done, and the result appears on your phone a moment after it lands on the table, so your phone never gives it away. Your phone remembers the choice; Leave room turns it off.
Free Rolling Tools
Quick pages for common rolls, each with a 3D tray, a card that reads the result for you, and the odds. They roll your own dice bag, and each has a link that opens the same roll in the full roller (a /roll?r= link, which throws the roll once when the page opens).
- Dice roller: any mix of d4 to d100 with a modifier
- Stat roller: six ability scores, with modifiers and the point-buy cost
Adding Dice
Add dice using quick roll buttons, the notation input, or the optional keyboard roll tool:
Quick Roll Buttons
The quick roll interface provides fast, visual dice selection with modifier controls:
Add/Subtract Dice
- Left click on a dice button to add one die of that type
- Right click on a dice button to subtract one die
Advantage/Disadvantage
- Left click the A/D button to add advantage (roll an extra die and keep the highest)
- Right click the A/D button to add disadvantage (roll an extra die and keep the lowest)
- Visual badges show the number of advantage or disadvantage dice applied
Modifiers
- Use the + and - buttons to adjust the modifier value (adds or subtracts from the final total)
- Modifiers range from -99 to +99
Exploding Dice
- Left click the flame icon to enable exploding dice (when a die rolls its maximum value, roll it again and add the result)
- Right click the flame icon to remove the exploding modifier
- Badge shows the maximum number of explosions allowed (up to 10)
Dice Notation Input
For more complex rolls, use the dice notation input field. This supports the full range of dice notation features (see Dice Notation Reference below).
Examples:
2d20kh1+5- Roll 2d20, keep highest, add 54d6dl1 # Ability Score- Roll 4d6, drop lowest, with label3d6{Fear} # Fire + 2d6{Hope} # Ice- Use specific dice models with descriptions(2d6, 1d12)kh1- Roll both, keep the higher total (see Grouped Rolls)1d12, 2d6, 2d20kh1- Roll all at once as independent results (see Multiple Rolls at Once)6#4d6dl1or6x4d6dl1- Repeat the same roll six times (see Repeating a Roll)
Roll History Panel
Below the notation input, you'll find the Roll History Panel which automatically tracks your recent rolls:
- Quick Reroll: Click any notation in the history to instantly populate the input field
- Pin Favorites: Click the pin icon next to any notation to pin it
- Pinned rolls stay at the top of the list and won't be auto-cleared
- Maximum of 10 pinned notations
- Recent Rolls: Shows your last 20 unpinned rolls
- Toggle Help: Click the help icon (?) to switch between viewing your roll history and the notation help text
- Cloud Sync: Patrons have their dice bag, roll history, notation history, hotbars, and stats synced across devices. Free Patreon members get their dice bag backed up and synced, and nothing else. Each linked Owlbear Rodeo account on your premium subscription gets its own independent cloud-backed dataset — linking a second OBR account does not merge bags, and edits made on one linked account do not affect the others.
Tips:
- Pin your commonly used rolls (damage, attacks, ability checks) for instant access
- The history persists between sessions via local storage
Dice Bag
The Dice Bag is your dice collection management system where you can store, organize, and customize your dice.
Filters
Filter your dice collection by type and state:
Type Filters:
- Filter chips show D4, D6, D8, D10/D100, D12, and D20
- Click a filter chip to show only that dice type
- Click again to remove the filter and show all dice
- Multiple type filters can be active simultaneously
State Filter:
- Filter by dice state: All, Active, Available, or Jailed
- All - Shows all dice regardless of state (default)
- Active - Shows only dice in your active rotation
- Available - Shows only dice that can be called by name
- Jailed - Shows only dice that are excluded from rolls
- Use state filters to quickly manage specific groups of dice
On a phone: the filters are two dropdowns above your dice. The die-type dropdown has a checkbox for each type in your bag, so you can tick several before closing it, and the state dropdown picks one state. A highlighted dropdown means its filter is on. Beside them you'll see how many dice match, such as 9 of 14, and Clear turns every filter off.
Dice States: Active, Available, and Jailed
Dice in your bag can be in one of three states, giving you flexible control over your dice collection:
Active Dice: These dice are in your active rotation
- Quick roll buttons automatically cycle through active dice as you roll
- Tip: For Daggerheart, create two d12s (Hope/Fear) and only have those two active. Every roll will alternate between them, making it easy to track your Fear and Hope scores.
Available Dice: These dice are stored but can be called by name
- Not included in the automatic rotation for quick roll buttons
- Can be summoned by name using dice notation:
2d6{Fireball}will use the die named "Fireball" - Perfect for situational dice (special attacks, spells, conditional abilities)
- Will be used if no active dice and die type is used in notation
- Tip: Keep character-specific dice or special effect dice as "Available" so they don't clutter your quick rolls but are ready when you need them by name
Jailed Dice: Completely excluded from all rolls
- Not available for quick rolls or dice notation
- Useful for dice that aren't rolling well or for storing alternate character sets
- Tip: Create dice sets for different characters and jail/activate them to quickly switch between character loadouts
Rolling Logic:
When you roll dice (via quick buttons or notation):
- Active dice are used first - The system cycles through your active dice in order
- If no active dice exist, the system checks for available dice and uses those
- If no active or available dice exist, the roll uses instant calculation (math.random) instead of physics simulation
Quick Roll Button Visibility:
Quick roll buttons only appear when you have at least one active die of that type. If all your d6s are "Available" or "Jailed", the d6 quick roll button will be hidden. This keeps your UI clean and only shows the dice you want in your active rotation.
The dice bag enforces a maximum capacity of 50 total dice (active + available + jailed combined). Unlimited Dice capacity for Premium users (see Patreon for upgrade)
Creating and Editing Dice
Click the "Add Dice" button to create new dice with custom properties.
The editor keeps the live preview and the basics (type, name, shape, size, material) on the left, with Material and Faces & Font tabs on the right, so you can watch the die change as you edit. On small screens the preview stays pinned at the top and the basics move into their own tab.
Dice Type Selection
Choose the dice type Set (creates all dice type with same settings), D4, D6, D8, D10, D12, D20.
Name
Give your dice a custom name to easily identify them in your collection.
Preview
Real-time 3D preview of your dice with the selected shape, material, and settings.
Shape Selection
Choose the physical shape for your die:
- Each dice type supports multiple geometric shapes (e.g., D6 can be a cube or alternative shapes)
- The shape affects the visual appearance and rolling physics
Size Selection
Adjust the dice size from 25% to 300% of the standard size
Material Selection
Choose from multiple material types with extensive customization options. Each material provides unique visual effects and properties:
Number color, font, and engraving are set in the Faces & Font tab and work with every material.
Standard Material - A physically-based material with realistic lighting and surface properties:
- Color: Base color of the dice body
- Roughness (0.0-1.0): Surface roughness (0 = mirror-like, 1 = matte)
- Metalness (0.0-1.0): Metallic appearance (0 = non-metallic, 1 = fully metallic)
- Sheen (0.0-1.0): Soft sheen/glow effect on the surface
Galaxy Material (Premium Only) - A stunning cosmic material with animated star fields:
- Primary Color: Primary color of the galaxy nebula
- Secondary Color: Secondary color blended into the galaxy
- Star Density (0.5-1.5): How many stars appear in the galaxy effect
- Brightness (0.0-2.0): Overall brightness of the galaxy effect
Kintsugi Material (Premium Only) — Marble or pottery dice with repaired fractures:
- Base: Choose marble or pottery, then design the stone or glaze with base and cloud colors, pattern scale, cloud variation, grain, and polish.
- Marble veining: Adjust vein color, intensity, width, flow, and direction.
- Repairs: Choose any repair color, metallic finish, roughness, and emissive glow. Gold is the default.
- Fractures: Adjust repair coverage, fragment density, seam width, irregularity, and clustering. At partial coverage, clustering concentrates repairs toward one side; zero coverage removes repairs.
- Pattern seed: Save a repeatable layout or use New pattern to try another.
Patterns continue across face edges and remain attached to the die as it rolls.
Dragonscale Material (Premium Only) — Dice covered in overlapping dragon scales. Available on sharp-edged shapes (sharp, gem, rhombic, hex, and the d6-style d3), not rounded or clipped dice; choosing it switches a rounded or clipped die to its sharp shape.
- Dragon type: Start from a chromatic (red, blue, green, black, white), metallic (gold, silver, bronze, copper, brass), gem (amethyst, sapphire, emerald, topaz, crystal), or elemental (shadow, ember) dragon. Each type sets the scale colors, finish, glow, and number color. Changing any of those makes it a Custom dragon.
- Scale shape: Round, pointed, or plated scales. Adjust density, direction, overlap, relief, and how much the scales vary in size, placement, and shade.
- Colors: Choose the scale, edge, and accent colors. Edge blend runs from thin rims to a full gradient across each scale. Accent scales add patches in the accent color.
- Finish: Adjust metallic, roughness, iridescence (strongest at scale edges), and wear, which polishes the raised part of each scale. Add a glow between the scales for fire, lightning, or shadow.
- Face frame: A raised metal border around each face, with adjustable width, metal color, and roughness. Each dragon type picks a matching metal. Set the width to zero to remove the frame.
- Pattern seed: Save a repeatable layout or use New pattern to try another.
Paper Material (Premium Only) — Dice folded from construction paper, with the numbers drawn in pencil. Each die gets its own crease pattern, sketched fold lines, and paper grain.
- Paper color: Pick a construction-paper pastel (cream, white, blush pink, butter yellow, mint, sky blue, lavender, peach, or sage), or choose a custom color.
- Number color: Pick a pencil (graphite, black, red, blue, green, purple, brown, or orange), or choose a custom color. Per-face ink from Faces & Font is drawn in pencil too.
Gummy Material (Premium Only) — Dice made of gummy candy, with the numbers cut into them. They jiggle when they hit the tray and wobble as they settle. The wobble is only visual: it never changes how a die rolls or what it lands on.
- Color: Pick a candy color (cherry, orange, lemon, lime, blue raspberry, grape, pink, or pineapple), or choose a custom color.
- Two colors: Blend a second color across the die, like a two-flavor gummy.
- Sour sugar coating: Off gives a clear, glossy gummy bear. On gives a milky sour gummy covered in sugar crystals.
Wood Material (Premium Only) — Dice carved from solid wood. The grain runs through the die like a real block of wood, so some faces show long stripes and others show growth rings, and every die in a set is cut from a different part of the block.
- Species: Start from maple, oak, cherry, walnut, mahogany, padauk, purpleheart, ebony, zebrawood, or lacewood. Each species sets the grain pattern, wood colors, finish, and a matching number color: burned-in dark numbers on light woods, bone-white on dark ones. Changing any of those makes it a Custom wood.
- Grain pattern: Straight, cathedral (arched flat-sawn grain), interlocked ribbon (bands that shimmer as the die turns), striped, ray fleck (lacewood's lace of flecks), or figured (curly figure that shimmers across the grain).
- Light wood and Dark grain: The two colors of each growth ring.
- Grain density and Grain contrast: How close the rings sit, and how strongly the dark grain shows.
- Finish: From raw, matte wood to a polished lacquer.
Plasma Storm Material (Premium Only) — A living plasma storm sealed inside smoked glass: swirling plasma around a glowing core, with lightning arcing out to the walls and sparks flickering through it. The storm turns with the die.
- Storm: Start from Tempest, Arcane, Inferno, Toxic, or Void. Changing a color makes it a Custom storm.
- Plasma, Core, and Lightning colors: The swirling cloud, the glow at the center, and the arcs and sparks.
- Speed, Glow, Turbulence, and Lightning: How fast the storm moves, how bright it shines, how wildly it churns, and how many arcs it throws.
Gummy and Paper set their own number style, so Faces & Font hides the controls they don't use: Ink and Engraving for Gummy, Engraving for Paper.
Faces & Font
Design what each face of a die shows. Changes appear on the preview as you make them, and other players in the room see your faces when you roll.
All faces
- Font: Pick Standard, Norse, or Aelfa, or choose More fonts… for a curated list of Google Fonts. You can also type the name of any Google Font.
- Ink: The color and opacity of the numbers. Single faces can override it.
- Engraving (0.0-1.0): How deeply the faces are cut into the die. At 0 they are printed flat.
- Text size: Scales every face together.
- Underline 6 and 9: Shown on dice that have both, so they can be told apart.
Start from replaces every face at once: Numbers (the default), Vertex sum, Honest Dice, Roman numerals, or Blank.
Vertex sum and Honest Dice are balanced numberings. They move the numbers around the die so high and low numbers are spread evenly. No real die is perfect: a bubble or a slightly flat side makes some faces land more often. When those faces are a mix of high and low numbers, the average roll barely moves. Each face shows and counts as its new number.
- Vertex sum follows The Dice Lab. Opposite faces add up to one more than the number of sides (1 is opposite 20 on a D20), and the faces around each corner add up to nearly the same total. The D20 uses The Dice Lab's "magic" numbering: every corner adds up to 52 or 53, and the three faces next to any face add up to 31 or 32. No other standard die can be numbered that evenly, so the D8, D10 and D12 get the most even layout the same rules allow. There is no Vertex sum D6, because every standard D6 already has the same corner totals.
- Honest Dice follows Honest Dice. It evens out each half of the die first, then each corner. Instead of putting 1 opposite the highest number, it puts similar numbers opposite each other (1 opposite 2, 19 opposite 20), so a die that favors one face loses a nearby number rather than the opposite extreme. A 6 never sits next to a 9. The layouts match Honest Dice's own sets: every half of the D20 adds up to 104–106 and every corner to 50–54. On a D10, the d100 tens die uses their d00 layout, which mirrors their D10. Their D4 is a crystal, so it's offered on the crystal-shaped D4.
Balanced numberings appear only on shapes they fit. Vertex sum covers every D8, D10, D12 and D20. Honest Dice covers the cube-shaped D6s, every D8 and D10, the standard D12, the D20 and the crystal-shaped D4.
Pick a face to edit it. The preview turns to show that face. A dot marks faces you have changed.
- Text or Blank: Faces can show up to 24 characters, including symbols and emoji. Color emoji are engraved as a single-color shape.
- Counts as: What this face adds to the roll: a number (decimals allowed) or text. Leave it empty to count the face's label. A label that is only a number, like
5, counts as that number. Any other label, likeSkullor 💀, counts as text. A blank face counts as its own number. For example, a D6 with faces counting 1, 1, 2, 2, 3, 3 rolls liked{1,1,2,2,3,3}. A small number or T on a face in the picker shows what it counts as when that differs from its label. - Face ink: A color and opacity for this face only, such as a red 1 or a gold 20. Use die ink goes back to the die's ink.
- Size, Rotate, and Nudge adjust that face only.
- Reset face returns it to the default.
A D10 can also switch to its d100 tens die faces, used when the die rolls as part of a d100. A D6 can preview its Fudge (dF) faces, which keep their − / blank / + symbols and use the D6's font and ink.
Rolls follow what each face counts as: totals, min/max, explosions, rerolls, and critical highlights.
Text faces don't add to the total. The results panel shows them under it, for example 9 with + Skull ×2 below. When every die lands on text, the panel shows the faces themselves as the result, for example Skull ×2 · Boon. Number rules skip text faces: they never explode, reroll, count as successes, get clamped by min/max or turn critical. Keep and drop rank only the number dice and always keep text faces, so 4d6kh3 with one Skull keeps the Skull and the three highest numbers. Math applies to the number part only (2d6*2 doubles the numbers, not the Skulls), and text faces from a roll dropped by a group roll like (1d6, 1d6)kh1 drop with it. Text faces are left out of dice stats. Faces using the Roman numerals start still count as their numbers. On 1d20!, the face that counts as 20 explodes, wherever it sits on the die. Values written in the notation, such as d{1,2,3}, take priority over a die's face values. Fudge dice keep their standard faces. d100 and table rolls read the digit printed on each face as long as every number still appears once, as it does with the balanced numberings; otherwise they use the standard faces.
Premium users with an uploaded font pack can choose it under Uploaded font pack. Packs are pre-drawn, so their faces can't be edited one by one.
Custom Number Generator
The Custom Number Generator lets you design the numbers, text, and symbols displayed on your dice. Create a matching set for regular dice, percentile tens, and Fate/Fudge faces, then use it in Dice+ as a custom font pack. The generator requires a desktop browser; uploading and using custom font packs in the app is a Premium feature.
Designing Your Numbers
- Open the Custom Number Generator in a desktop browser.
- Choose a font using the font family picker, load system fonts where supported, or import a font with Load TTF/OTF.
- Customize each face in the basic, tens, and fudge layouts. Edit its text, font size, position, rotation, and underline. Text supports up to three lines, including symbols and emoji; color emoji become white silhouettes for use on dice.
- Use the Reference overlay to align your designs with the default number size and placement.
- Export your set with Download All (ZIP) for uploading to Dice+. You can also download each layout separately as a PNG.
Use Save Preset to download an editable JSON preset and Load Preset to continue working on it later.
Using Custom Numbers on Dice (Premium)
- Create or edit a die in your Dice Bag.
- In the Faces & Font tab, open Uploaded font pack and select Upload font pack….
- Choose the ZIP exported by the generator, enter a Font Name, and click Upload. The uploaded font is selected for the die.
- Save your die. Your uploaded pack is also available in the Uploaded font pack picker for other dice.
Use Manage fonts… in the same picker to remove packs you no longer need. Custom font packs belong to the uploader: other players see your custom numbers when you roll, but sharing a die with someone who does not own its font pack gives them the standard font.
Dice Stats and Log
View detailed statistics and history for your dice:
- Roll history showing all past rolls
- Statistical analysis of roll outcomes
- Distribution charts showing roll frequencies
- Individual die performance tracking
- A fairness check for each die type and shape
Stats count every face your dice land on, including dice that advantage, disadvantage or a reroll drops, and they count the face itself, before min/max limits, custom face values or Fudge mapping. They show how the dice fall, not only the numbers that counted toward totals. Stats recorded before the fairness check was added counted only the dice that were kept, so a die with a long history of advantage rolls can lean high until new rolls even it out. Clear Stats starts fresh.
On a phone, Stats and Log are separate tabs. The Stats tab fits on one screen: pick a die and a model shape from the two dropdowns at the top, read the rolls, average (next to the average a fair die would give), and most and least rolled faces, then tap a bar in the chart for its count. The dashed line marks the fair share for each face. The trash button clears all stats. Dice+ remembers which die and shape you last looked at, and when you switch dice it keeps the shape if the new die has rolls on it.
Dice Fairness Check
The stats page puts a badge on each die's roll distribution, and the fairness test shows the same check for its own rolls. Two tests look at how often each face came up, and each says Fair, Unfair or N/A (not enough rolls yet, or too close to call). Hover the badge for the details.
How fair are Dice+ dice? We rolled every die type and shape at least 10,000 times with the fairness test's Quick test, one die at a time, and ran both tests on the results. Each chart shows how many times every result came up, with a bar for each shape and a line at the fair share (an even split of the rolls). A fair die still lands a little above or below that line by luck; the tests judge whether the differences are more than luck explains. Hover a bar for its numbers.
D4
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Sharp | 10,000 | Fair · error 1.4 of 7.8 | Fair · 15 to 1 balanced | Fair |
| Rounded | 10,000 | Fair · error 0.3 of 7.8 | Fair · 25 to 1 balanced | Fair |
| Clipped | 10,000 | Fair · error 2.6 of 7.8 | Fair · 8.8 to 1 balanced | Fair |
| Gem | 10,000 | Fair · error 1.1 of 7.8 | Fair · 17 to 1 balanced | Fair |
| Hex | 10,000 | Fair · error 6.8 of 7.8 | N/A · 1.4 to 1 balanced | Fair |
D4 face counts
| Shape | 1 | 2 | 3 | 4 |
|---|---|---|---|---|
| Sharp | 2543 | 2466 | 2510 | 2481 |
| Rounded | 2523 | 2488 | 2489 | 2500 |
| Clipped | 2464 | 2506 | 2564 | 2466 |
| Gem | 2519 | 2505 | 2521 | 2455 |
| Hex | 2402 | 2573 | 2483 | 2542 |
D6
Rounded (17,950 rolls) was rolled more, so the chart shows every shape per 10,000 rolls; hover a bar for its real count.
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Sharp | 10,000 | Fair · error 2.7 of 11.1 | Fair · 29 to 1 balanced | Fair |
| Rounded | 17,950 | Fair · error 5.0 of 11.1 | Fair · 33 to 1 balanced | Fair |
| Clipped | 10,000 | Fair · error 2.9 of 11.1 | Fair · 26 to 1 balanced | Fair |
| Gem | 10,000 | Fair · error 6.5 of 11.1 | Fair · 6.1 to 1 balanced | Fair |
| Rhombic | 10,000 | Fair · error 2.1 of 11.1 | Fair · 37 to 1 balanced | Fair |
D6 face counts
| Shape | 1 | 2 | 3 | 4 | 5 | 6 |
|---|---|---|---|---|---|---|
| Sharp | 1641 | 1664 | 1644 | 1698 | 1644 | 1709 |
| Rounded | 2946 | 3016 | 3066 | 2959 | 3034 | 2929 |
| Clipped | 1671 | 1682 | 1711 | 1670 | 1620 | 1646 |
| Gem | 1623 | 1659 | 1756 | 1647 | 1646 | 1669 |
| Rhombic | 1691 | 1666 | 1697 | 1645 | 1628 | 1673 |
D8
Sharp (20,000 rolls) was rolled more, so the chart shows every shape per 10,000 rolls; hover a bar for its real count.
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Sharp | 20,000 | Fair · error 10.1 of 14.1 | Fair · 18 to 1 balanced | Fair |
| Rounded | 10,000 | Fair · error 2.9 of 14.1 | Fair · 65 to 1 balanced | Fair |
| Clipped | 10,000 | Fair · error 12.3 of 14.1 | N/A · 1.7 to 1 balanced | Fair |
| Gem | 10,000 | Fair · error 8.0 of 14.1 | Fair · 9.0 to 1 balanced | Fair |
D8 face counts
| Shape | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 |
|---|---|---|---|---|---|---|---|---|
| Sharp | 2521 | 2469 | 2482 | 2511 | 2599 | 2405 | 2554 | 2459 |
| Rounded | 1256 | 1238 | 1245 | 1254 | 1297 | 1215 | 1250 | 1245 |
| Clipped | 1207 | 1248 | 1203 | 1243 | 1330 | 1213 | 1309 | 1247 |
| Gem | 1243 | 1268 | 1308 | 1276 | 1183 | 1248 | 1218 | 1256 |
D10
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Sharp | 10,000 | Fair · error 9.2 of 16.9 | Fair · 13 to 1 balanced | Fair |
| Rounded | 10,000 | Fair · error 4.6 of 16.9 | Fair · 74 to 1 balanced | Fair |
| Clipped | 10,000 | Fair · error 10.3 of 16.9 | Fair · 8.9 to 1 balanced | Fair |
| Gem | 10,000 | Fair · error 7.3 of 16.9 | Fair · 27 to 1 balanced | Fair |
D10 face counts
| Shape | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 |
|---|---|---|---|---|---|---|---|---|---|---|
| Sharp | 1035 | 1023 | 984 | 1021 | 1001 | 1019 | 976 | 1036 | 953 | 952 |
| Rounded | 1004 | 1027 | 976 | 1001 | 967 | 1023 | 1024 | 1009 | 969 | 1000 |
| Clipped | 992 | 976 | 1061 | 980 | 1001 | 998 | 1018 | 1040 | 940 | 994 |
| Gem | 1005 | 991 | 1004 | 993 | 1053 | 1031 | 947 | 985 | 984 | 1007 |
D12
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Rounded | 10,000 | Fair · error 13.6 of 19.7 | Fair · 6.1 to 1 balanced | Fair |
| Sharp | 10,000 | Fair · error 18.0 of 19.7 | N/A · 1.4 to 1 balanced | Fair |
| Gem | 10,000 | Fair · error 11.5 of 19.7 | Fair · 12 to 1 balanced | Fair |
| Rhombic | 10,000 | Fair · error 5.7 of 19.7 | Fair · 96 to 1 balanced | Fair |
D12 face counts
| Shape | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Rounded | 845 | 819 | 815 | 879 | 893 | 838 | 797 | 785 | 842 | 853 | 830 | 804 |
| Sharp | 807 | 841 | 805 | 832 | 830 | 918 | 792 | 868 | 853 | 784 | 819 | 851 |
| Gem | 809 | 801 | 857 | 828 | 773 | 879 | 837 | 860 | 846 | 838 | 817 | 855 |
| Rhombic | 831 | 831 | 817 | 846 | 798 | 835 | 841 | 837 | 823 | 878 | 852 | 811 |
D20
| Shape | Rolls | Standard test | Bayesian test | Result |
|---|---|---|---|---|
| Sharp | 10,000 | Fair · error 23.1 of 30.1 | Fair · 4.3 to 1 balanced | Fair |
| Rounded | 10,000 | Fair · error 25.3 of 30.1 | N/A · 2.2 to 1 balanced | Fair |
D20 face counts
| Shape | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sharp | 493 | 530 | 469 | 497 | 484 | 464 | 549 | 499 | 498 | 484 | 492 | 492 | 524 | 483 | 544 | 510 | 535 | 491 | 494 | 468 |
| Rounded | 475 | 514 | 509 | 470 | 471 | 506 | 532 | 528 | 478 | 499 | 456 | 517 | 495 | 559 | 472 | 508 | 504 | 499 | 481 | 527 |
Testing a Die for Fairness
Put a single die to the test without rolling it by hand: open its menu in the dice bag (the ⋮ on its card) and choose Test fairness. It works on any die in your bag, including jailed ones.
Rolls: how many results to collect, from 100 to 10,000 (500 by default). Each die that lands counts as one. More rolls can spot smaller biases.
Dice at a time: how many copies of the die to throw at once, from 1 to 10. More dice finish a test sooner.
Choose how to roll:
- Quick test: your computer rolls the dice behind the scenes using the same physics as a real throw. You won't see them, and it takes seconds.
- Watch it roll: the dice roll in your tray so you can watch every throw. Only you see them. To keep the test moving, the rolls play at Very Fast speed and clear after 1 second, whatever your Roll Settle Time and Dice Clear Delay are set to; your settings are back as soon as the test ends. Both kinds of test use the same physics, so they give the same answer. It needs 3D dice, so it isn't available in Math only performance mode.
Each option shows an estimated time that updates as you move the sliders.
Press Start. A small window at the bottom of the screen shows progress and a Cancel button. You can close the dice bag while the test runs.
When the test ends, the same window shows its results: a chart of how often each face came up against the count a fair die would give, and both fairness analyses with their numbers and what they mean. Run again repeats the test; Close dismisses it. If you cancel, you get the results of the rolls that finished.
While a test runs:
- All other rolls are paused: your own, and roll requests from other extensions. Cancel the test to roll again.
- Nothing is shared. Results don't go to the room, the results panel, roll history or Discord.
- Every result goes into your dice stats for that die's type and shape, so it adds to the stats page's fairness check too.
- The test uses the die's shape and size as they were when you pressed Start; editing the die meanwhile doesn't change it. A die's material doesn't affect how it rolls.
- Reloading or leaving the room ends the test. Results recorded so far stay in your stats.
Sharing Dice
Share your custom dice with other players in your game session. There are two ways to share dice:
Direct Sharing within Owlbear Rodeo
Send dice directly to other connected players:
- Open the Dice Bag (both sender and receiver must have their dice bags open)
- Click the three-dot menu on any dice card you want to share
- Select "Share" from the menu
- Choose a recipient from the list of connected players, or select "Copy to Clipboard" for manual sharing
Important Notes:
- The receiving player must have their dice bag open to receive the shared dice
- Premium materials require premium subscription - If you try to share dice with a premium material to a non-premium user, they will not be able to accept it
- Dice bag capacity limits apply - Free users can store up to 50 dice. If the receiver's dice bag is full, they cannot accept new dice
Copy to Clipboard Sharing
Share dice settings as JSON that can be pasted:
- Click the three-dot menu on any dice card
- Select "Share" → "Copy to Clipboard"
- A dialog will appear with the JSON settings - manually select and copy the text (Ctrl+C or Cmd+C)
- Share the JSON with other players (Discord, chat, etc.)
To receive dice from clipboard:
- Open your Dice Bag
- Click the Paste icon (clipboard icon) in the header next to the close button
- Paste the JSON into the dialog and click "Confirm"
- The dice will be validated and added to your bag if compatible
Validation:
- Premium materials can only be received by premium users
- Dice bag must not be at capacity (50 dice limit for free users)
- JSON must contain valid dice settings
Sharing dice is perfect for:
- Standardizing dice across your party
- Sharing custom themed dice sets
- Distributing character-specific dice (Fear/Hope, special abilities, etc.)
- Helping new players get started with pre-configured dice
Custom Font Packs (Premium)
Upload your own dice number atlases. Build a font in the Custom Number Generator, export it as a font pack .zip, then upload it from the Uploaded font pack picker in any die's Faces & Font tab. The pack becomes available on every die you create or edit, and other players in the room see your custom font on dice you roll.
Pack format
A font pack is a .zip containing three 1024×1024 PNGs:
numbers<suffix>.png— main number atlas (used by every die except d100 tens and Fate/Fudge)numbers10x<suffix>.png— d100 tens digitsnumbersFudge<suffix>.png— Fate/Fudge symbols
The optional <suffix> matches the Filename suffix field in the Number Generator (e.g. _norse); leave it blank for plain numbers.png/numbers10x.png/numbersFudge.png. The Number Generator's Download All (ZIP) button produces this layout automatically.
Limits
- Premium account required
- 1 MB per zip
- 50 packs per user
Managing packs
Packs you uploaded appear under the Custom group inside the Uploaded font pack dropdown. Use Manage fonts… in the same dropdown to delete a pack — dice that referenced it revert to Standard.
When you share a die that uses a custom font, the recipient sees the die with the Standard font instead, since custom fonts are private to the uploader.
App Settings
Open App Settings with the Settings tab at the top of the dice bag, beside Dice and Stats & Log (separate Stats and Log tabs on a phone; on the website, the gear in the top-right corner). Pick a section from the list on the left; on a phone, sections fold into a list that shows their current values, so tap one to open it. Changes apply as you make them and are saved in your browser. Text fields, such as the Discord webhook, save when you press Enter or click away.
Keyboard Roll Tool
Turn on App Settings → Keyboard → Enable hotkey tool. This setting is off by default. Once enabled, press R or click the Dice+ tool in the OBR toolbar to start a keyboard roll.
In the browser roller the setting is called Enable hotkeys, and there is no tool: once it is on, typing dice notation or a hotkey anywhere on the page starts a keyboard roll.
The action panel opens in notation mode with pins/history collapsed, preserving your normal layout preference. Focus moves into the panel, not the notation input, so assigned dice shortcuts are handled there instead of activating OBR tools. Click the notation field whenever you want to type or edit ordinary dice notation; shortcut expansion pauses while you edit.
Default hotkeys (case-insensitive):
| Label | Notation | Hotkey |
|---|---|---|
| D4 | d4 |
A |
| D6 | d6 |
S |
| D8 | d8 |
D |
| D10 | d10 |
F |
| D12 | d12 |
G |
| D20 | d20 |
H |
| D100 | d100 |
J |
| Keep highest | kh1 |
K |
| Drop highest | dh1 |
L |
| Minimum | min |
M |
| Maximum | max |
X |
| Reroll | r |
Q |
Building a roll:
- Type
3a+5oraaa+5to enter3d4+5. - A dice shortcut adds to a matching term already in the roll, even an earlier one:
sdsproduces2d6+1d8. The term you are typing keeps growing after you add modifiers to it, sohkkhproduces2d20kh2. - A different dice shortcut adds another term:
asproduces1d4+1d6. A typed count starts a new term, soh+2hproduces1d20+2d20. After-,*,/or(a dice shortcut also starts a new term. A trailing+is removed when the die merges. - Merging stays inside the current comma-separated part and the current parentheses.
- Repeated K or L presses increase the keep/drop count. The opposite key reduces it, removes it at zero, then switches direction. For example,
hhkklproduces2d20kh1. - Type numbers and operators directly, including
+,-,*,/, parentheses, and comparisons. Explode uses the literal!:a!>3produces1d4!>3. Follow min/max or reroll shortcuts with parameters as needed. - Backspace deletes one character from the expanded notation. Hold-to-repeat is ignored; tap a dice key for each additional die.
Finishing a roll: Press Enter to roll to the audience shown on the roll button. The panel waits until the roll has been sent before closing and restoring the previous tool. Invalid notation or a send failure stays available for correction or retry. Press Escape to cancel before sending; closing the panel or choosing another tool also ends an unsubmitted roll. Once sending starts, it is allowed to finish.
Customizing hotkeys: The bindings are listed below the toggle (on a phone, expand Hotkeys to see them). The compact list labels built-ins by name and custom entries as Custom1, Custom2, and so on. Choose Add custom hotkey, and enter the notation fragment to insert and its letter. Hotkeys save as soon as every binding is valid. A custom hotkey that is a single dice term, such as d6{Fear}#Fear or 2d10kh1, stacks like a built-in die: each press adds its count to a term with the same die, model, label and modifiers. Pressing d6{Fear}#Fear three times produces 3d6{Fear}#Fear, and a d6{Hope}#Hope hotkey then adds a separate 1d6{Hope}#Hope. A number typed before a custom hotkey stays a flat modifier. Any other custom fragment, such as 2d6+3, is inserted as written. Clear a default key to free its letter, remove custom rows with their × button, or use Reset to restore the defaults. Duplicate letters, R, numbers, operators, and editing controls cannot be assigned. These settings are saved in your browser.
Popover Layout
Sets how the dice popover that opens from the toolbar is laid out. Pick an option using the layout previews.
On the website on a phone, the layout is always Grid, so this setting doesn't appear there.
| Option | Description |
|---|---|
| Vertical | Tall column of dice — options expand to the side of each die (default) |
| Horizontal | Wide row of dice — options expand below each die |
| Input Only | Just the dice notation field, with no quick dice buttons |
| Hotbar | Your saved rolls, one tap each |
| Grid | Dice, modifiers and notation together in one square panel |
Horizontal is the same layout turned a quarter turn and read the other way around: the dice bag leads the row, the roll button follows it, and the dice run left to right ending with the d20. Each die's advantage/modifier/explosion controls drop down beneath it, and the roll button's label reads top to bottom.
Text input mode returns to the portrait window in every layout, with the roll button below the notation field.
Input Only stays on the notation field permanently — there are no dice buttons to switch back to. The clear button empties the field instead of leaving notation mode, and the roll button is held disabled until the field holds a valid notation.
Hotbar
The Hotbar layout replaces the quick dice buttons with your own saved rolls. If you roll the same handful of things all session — an attack, its damage, a saving throw — each one becomes a single button.
The row reads left to right: the dice bag, the roll target and the notation toggle, then a divider, then your hotkeys, with the panel carousel at the far end. Everything left of the divider is the app; everything right of it is your own rolls.
Creating a hotkey. Press the + in the row. A window opens over the map with three fields:
- Name — shown in the hotkey's tooltip alongside its notation. "Attack", "Stealth", "Fireball".
- Dice Notation — any notation the notation field accepts, validated as you type. Save stays disabled until it is valid.
- Icon — one of the dice icons, picked from a grid. This is what the button shows, so pick one you will recognise at a glance.
- Color — a swatch to tint the icon with. Color is the fastest way to tell a row of hotkeys apart at a glance: red for damage, green for healing, blue for saves. The icon grid draws in the color you pick, so it doubles as a preview.
Each panel holds up to 10 hotkeys. Right-click a hotkey (or long-press on touch) to open it for editing, where it can also be deleted. Hovering a hotkey shows its name and notation.
Reordering. Drag a hotkey along the row to move it; the others step aside to show where it will land. Works with a mouse or by touch. A tap still rolls — the drag only starts once you have actually moved the hotkey.
Panels. The carousel at the end of the row pages between panels: the arrows step through them, wrapping at either end, and the number between them shows which panel you are on. Click that number to manage panels — add, rename, delete, share, or jump straight to one. Up to 10 panels, and the last one cannot be deleted. One panel per character, or one per combat role.
Sharing a panel. A whole panel can be handed to the other people in your room, so a GM can set up a monster's attacks once and give them to whoever is running it, or a player can pass their character's rolls to someone covering for them.
In the panel manager, press the share icon on a panel and choose who gets it:
- A player — sent to that one person.
- Everyone — offered to everyone else in the room.
- Copy as text — puts the panel on your clipboard as a block of text you can send through chat, a document, or to a room you are not in. The recipient pastes it with Import.
The recipient sees a window with the sender's name and every hotkey in the panel — its icon, color, name and notation — and chooses Accept or Decline. Nothing is added until they accept, and accepting adds it as a new panel; their existing panels are never overwritten. If a panel by that name is already there, the copy gets a number.
Offers arrive whether or not the recipient has Dice+ open, and queue up if several land at once. A panel cannot be accepted once you are at 10 panels — delete one to make room. Sharing a panel shares the rolls, not the dice: the recipient's own dice bag styling is what they will see when the hotkeys roll.
Roll target. The person icon next to the dice bag sets who sees the rolls: Everyone, Self, GM & Self, or GM Only. It applies to every hotkey in the bar, and is remembered between sessions.
Ad-hoc rolls. The notation toggle next to the roll target opens the usual dice notation field, so anything not worth saving as a hotkey is still one tap away. Clearing it returns to the hotbar.
All of the hotbar's editing happens in a window that floats over the map rather than inside the toolbar popover — the hotbar is a single row tall, so a menu or dialog inside it would be cut off.
Hotkeys are saved to local storage and persist between sessions. Premium users have them backed up to the cloud and synced across devices, alongside roll history and notation history.
Grid
The Grid layout puts everything on one compact panel: the dice as a grid of tiles, an advantage strip, a modifier, the notation field, and the dice bag, clear and roll buttons along the bottom. It doesn't grow when you pick dice, so it sits in the same spot on the map the whole session.
The notation field is the roll. The tiles, the advantage strip and the modifier all edit the text in the field, and the tiles show whatever the field says. Type 2d20kh1 + 1d6 + 3 and the d20 and d6 tiles light up; click a tile and the field updates. Neither side ever overwrites the other.
- Dice tiles. Left-click a tile to add that die, right-click (or long-press on touch) to take one away or subtract it. The badge shows how many are in the roll, red when they are subtracted. Anything else the dice carry in the field is kept: clicking d6 turns
2d6r1into3d6r1. - Adv / Dis. Applies to the last die you added, which has a pink ring. Adv adds a die and keeps the highest (
1d20→2d20kh1), Dis keeps the lowest, and pressing the opposite one steps back. Right-click either to step back. Dice that already keep or drop some other way (4d6dl1, dice pools) show Custom keep instead. - Modifier. − and + step the roll's flat bonus by one, or click the number and type one in. It reads and writes the plain numbers in the roll (
1d20 + 2 + 3shows +5); numbers inside brackets or multiplied ((1d20 + 2) * 2) are never touched. - Several rolls at once. With comma-separated rolls (
1d20+5, 2d6+3) the buttons edit the last one. A repeat roll (6#4d6dl1) is edited inside the repeat.
While the field holds notation that doesn't parse yet, the tiles keep showing the last good roll and the buttons wait; the reason appears where Adv/Dis normally sits. Press ? in the field for notation help, which takes the place of the dice until you close it. Press Enter in the field or the Roll button to roll, and the arrow beside Roll to pick who sees it.
There is no explosion button in this layout — type ! in the field for exploding dice.
Keep Notation Open
Off by default. When enabled, rolling from the dice notation input clears the field but stays on it, ready for the next notation, instead of closing back to the dice buttons.
The Input Only and Grid layouts always behave this way, since the notation field is always showing.
Keep Last Modifier
Off by default. Normally a roll clears the dice buttons completely, including the modifier set on each die. When enabled, every die keeps the modifier it was last rolled with, so rolling the same bonus again is a single click.
The memory is per dice type: the d20 remembers its own modifier, the d12 its own, and rolling one never disturbs another. Dice left out of a roll keep whatever they were already holding.
A carried modifier stays hidden until you pick that die up again — a modifier on a die with no count adds nothing to a roll. Roll a die back at zero to forget its modifier, or press Clear to forget them all at once.
The Grid layout has one modifier for the whole roll, so it carries that instead: after a roll the field starts again with the same bonus (+3), ready for the next dice. It is remembered separately from the other layouts' per-die modifiers. Clear forgets it.
Sound
Toggle dice sound effects on or off.
Critical Highlight
Off by default. When enabled, the lowest and highest result each selected die can show is marked as a critical failure (red) and critical success (green), as if cf and cs were written on it: turn it on for d20s and 1d20 highlights a natural 1 and 20. Pick All or any of d4, d6, d8, d10, d12, d20 and d100. All also covers other numbered shapes; Fudge dice and table rolls never take automatic critical points.
Dice with custom face values use the lowest and highest values their faces count as, and a d100 uses its combined result (1 and 100). Points written in the notation always apply and replace the automatic point of their own kind, so with d6 selected, 4d6cs5 marks 5 as a success and still marks 1 as a failure.
The setting belongs to the player who rolls: everyone sees the same highlights on that roll, in the results panel, history and Discord.
Critical Effects
Off by default. When enabled, a die that lands on a critical result plays a burst, glow and shake in the tray. Like Critical Highlight, it covers the min and max of the dice you pick, plus any cs/cf points written in the notation, whichever die they are on.
This setting is yours alone: it decides the effects you see on every roll, including other players', and doesn't change their highlights. In a big pool, every critical die glows, but only the first three play the full burst, and the shake and vignette play once per roll.
Pick a Style for the effects:
| Style | Critical success | Critical failure |
|---|---|---|
| Classic | Gold shockwave, sparks and a rune circle | Red implosion, smoke and a camera shake |
| Divine / Cursed | A beam of light with drifting motes | The floor cracks red, ash falls and the tray drains of color |
| Arcane | Glyphs spiral up over a glowing sigil | The glyph ring shatters red and fizzles out |
| Minimal | A green ring pulse | A red ring pulse |
When the tray renders at low graphics quality, whether picked or reached by Auto, every style plays as Minimal.
Roll Timestamp
Off by default. When enabled, the roll results panel shows the time of each roll (including seconds) right-aligned on the header row.
Roll Settle Time
Controls how quickly rolled dice come to rest after being thrown. Every roll uses the same physics; this setting plays it faster or slower, like fast-forward or slow motion, so the dice land exactly as fairly at every speed. It doesn't change the Dice Clear Delay.
| Option | Description |
|---|---|
| Very Fast | Plays the roll at double speed |
| Fast | Plays the roll at 1.5× speed |
| Normal | Plays the roll at 1.25× speed — the default |
| Slow | Plays the roll at 0.85× speed |
| Very Slow | Plays the roll at 0.7× speed |
Dice Clear Delay
Controls how long your own rolls remain visible on the tray before auto-clearing. Ranges from 1 to 10 seconds. This applies only to your own rolls — other players' rolls clear on their own schedule.
Performance Mode
Controls how much of the 3D tray your rolls use. The first three options only change how other players' dice are drawn on your screen; Math Only also replaces your own.
| Option | Description |
|---|---|
| Normal | Show all dice materials from other players |
| Default Dice Only | Show simplified dice for other players (better performance) |
| Results Only | Skip dice animations for other players entirely — show results only (best performance) |
| Math Only | No 3D dice at all, including your own — every roll is calculated instantly and only the result is shown |
Math Only turns off the physics tray completely: rolls are resolved with a random number generator and the result appears immediately, with no dice, no animation and no roll sounds. Everything else works as normal — the full notation is supported (including exploding dice, rerolls, keep/drop, pools and table rolls), results still broadcast to the room, and rolls are still recorded in your history and stats.
This is a per-player setting, so it only affects your own screen. Other players still see their own dice roll normally, and they see your rolls appear as results without dice — the same way a very large roll already behaves. Because dice never spawn, the individual dice you have equipped in your dice bag have no visual effect while this mode is on.
Cross-platform Table
Let players on the Dice+ website roll with your Owlbear Rodeo room, for someone who isn't in Owlbear Rodeo or would rather roll on another screen. Everyone sees everyone's dice, with the same physics and results on every screen.
- Turn on (GM). Open App Settings → Room and, beside Open to the website, choose Turn on. Every Dice+ player in the room connects; nothing changes for anyone until you do.
- Invite players. Once it's on, every player in the room sees the room code and passcode, each with a copy icon, to send to guests. Guests open the website roller and join with them.
- Passcode (GM). A GM can type a new one straight into the Passcode field, or clear it so the code alone is enough. Guests already in stay. Rooms turned on before passcodes existed get one the next time a GM opens Owlbear Rodeo.
- Who's at the table. Players who joined from the website are listed under Guests. A GM can Remove one.
- Rolling from another screen. A player in your room can roll from the website as themselves. When they pick you on the website, a Someone Wants to Roll as You card appears at the top of your Owlbear Rodeo; choose Allow or Deny (no answer within a minute counts as Deny). Once allowed, their website rolls are your rolls: your name and color for everyone, your dice tumbling in your own tray, and your history. The device shows under Guests as your name · linked; you or a GM can Unlink it.
- Roll targets. GM & Self and GM Only rolls from guests go to the room's GMs, the same as from anyone else. Guests never see the GMs' private rolls.
- New code or turn off (GM). The refresh icon beside the code moves your table to a fresh room code and passcode: guests who joined with the old code are left behind, and the old code only leads to an empty room. The × in the card's corner closes the room to the website.
Rolls between Owlbear Rodeo players don't depend on this: if the connection drops, they carry on as usual and only the guests stop seeing them until it reconnects.
Discord Webhook
A premium GM can connect a Discord text channel in App Settings → Room → Discord webhook. Players do not need Premium to send rolls through the room’s configured webhook. Only Everyone rolls are posted. Self, GM, and GM Only rolls are excluded.
- Go to your Discord server.
- Right-click the channel where you want results to appear, then choose Edit Channel.
- Open Integrations → Webhooks.
- Choose New Webhook, give it a name, confirm the correct channel, save, and Copy Webhook URL.
- Paste the webhook URL into Dice+ settings and click Save.
Clear the URL and save to disconnect; delete the webhook in Discord to revoke it.
Dice Notation Reference
Dice+ uses a dice notation system compatible with Roll20 and RPG Dice Roller, with some extensions and variations.
Basic Rolls
d20- Roll a single d202d6- Roll two six-sided dice1d8+5- Roll a d8 and add 53d6-2- Roll three d6 and subtract 2
Modifiers
Advantage/Disadvantage (Keep/Drop High/Low)
Keep Operators - Keep specified dice, drop the rest:
2d20kh1- Roll 2d20, keep highest 1 (advantage)2d20kl1- Roll 2d20, keep lowest 1 (disadvantage)4d6kh3- Roll 4d6, keep highest 3 (common for ability score generation)
Drop Operators - Drop specified dice, keep the rest:
2d20dl1- Roll 2d20, drop lowest 1 (same as keep highest - advantage)2d20dh1- Roll 2d20, drop highest 1 (same as keep lowest - disadvantage)4d6dl1- Roll 4d6, drop lowest 1 (keep highest 3)
Tip: Keep/drop can also apply to whole rolls instead of individual dice —
(2d6, 1d12)kh1rolls both and keeps the higher total. See Grouped Rolls.
Chaining Keep/Drop
Keep/drop operators can be chained. They apply in the order written, each step operating only on the dice still kept by the previous step:
4d10dh1kh1- Drop the highest, then keep the highest of the remaining 3. Rolling [2, 4, 5, 9] drops the 9 first, then keeps the 5.4d10kh3kl1- Keep the highest 3, then keep the lowest of those. Rolling [2, 4, 5, 9] keeps [4, 5, 9], then results in 4.6d6dl2dh1kh2- Drop the 2 lowest, drop the highest, keep the highest 2 of what's left.
Each step is validated against the dice remaining at that point in the chain:
khN/klNneeds at least N dice remaining —2d10kh3is invalid.dhN/dlNmust leave at least one die —4d10dh4is invalid, and so is4d10dh3kh2(only 1 die remains afterdh3).
With exploding dice, position in the chain matters:
2d6!kh1- Explosions join the pool as separate dice before the keep. Rolling [1, 6] where the 6 explodes into a 2 gives a pool of [1, 6, 2] →kh1keeps 6.2d6!!kh1- Compounding merges explosions into the original die first: [1, 6+2] →kh1keeps 8.2d6kh1!- The keep resolves over the original dice only; explosion dice then follow their parent die (kept parent → explosion counts, dropped parent → explosion is dropped).- Implosion dice (
i,ii) follow the same rules, as negative values.
Note: Re-rolls (
r,ro,rh,rl),min/max, and unique (u) always resolve while the dice are rolling, before any keep/drop is applied — their position in the chain doesn't change that. Matching explode (!m) supports a single keep/drop operator and cannot be combined with a chain.
Min/Max
1d20min10- Result cannot be less than 101d20max15- Result cannot be more than 15
Exploding & Imploding
Exploding dice roll again when they hit their trigger and add the new roll. Imploding dice are the mirror image: they roll again on their trigger and subtract the new roll. That makes open-ended rolls possible, the kind Rolemaster and Rune use. ! triggers on the die's highest face by default and i on its lowest, and both take the same options:
| Explode | Implode | Meaning |
|---|---|---|
1d6! or 1d6e |
1d6i |
Trigger on the highest face (6) / the lowest face (1) |
1d6!5 |
1d6i2 |
Trigger on one value |
1d6!5,6 |
1d6i1,2 |
Trigger on any listed value |
1d6!>4 |
1d6i<3 |
Trigger on a comparison (>, >=, <, <=, =, <>) |
1d6!:3 |
1d6i:1 |
Trigger at most 3 times / once |
4d6!! |
4d6ii |
Compound: fold the extra dice into the die that started the chain |
The die that triggers still counts. Rolling 1d6i as a 1 and then a 4 gives 1 − 4 = −3. Results can go below zero.
Exploding and imploding together: write both operators, for example 1d6!i or 1d10!>=9i<=2. The first die decides the direction, and after that a chain only continues on its own trigger:
1d6!irolling 1 → 1 → 4: the 1 implodes again, giving 1 − 1 − 4 = −41d6!irolling 1 → 6: the 6 doesn't explode an implosion, giving 1 − 6 = −51d6!irolling 6 → 1: the 1 doesn't implode an explosion, giving 6 + 1 = 71d6!irolling 6 → 6 → 2: giving 6 + 6 + 2 = 14
Each operator has its own limit, so 1d6!:3i:1 explodes up to 3 times but implodes only once. Each also has its own mode: 1d6!!i compounds explosions but keeps implosion dice separate, and !ii and !!ii work too. The order doesn't matter (1d6i! is the same as 1d6!i).
How results show:
- Separate dice: the die that triggered gets a marker (
6!,1i) and implosion dice show as negative values:[1i, -4] -3 - Compounded dice show one value with
!!orii:[14!!],[-3ii]. Hover over it to see the chain (6 + 6 + 2,1 - 4).
Rules and limits:
- Explode and implode triggers can't overlap:
1d6!>=3i<=3is an error, because a 3 matches both. - Implode can't be used on success pools (
5d10>=8i), with matching explode (!m), or on Fudge dice. - With keep/drop, implosion dice work exactly like explosion dice (see keep/drop chains above), entering the pool as negative values:
2d6ikh1keeps the highest of the original dice and any implosion dice, while2d6kh1idrops a dropped die's implosions with it. - Penetrating explode (
!p) is not supported.
Note: An extra die is thrown half a second after its trigger die lands. It appears at the same moment and follows the same path on every player's screen.
Matching Explode
Matching explode triggers when multiple dice in a group show the same value. Instead of checking each die individually, it checks if N dice match — then rolls one additional die per matching group. If the new die also matches the original value, it chains.
Basic Matching Explode:
2d10!m- If both d10s show the same value, roll 1 extra d103d10!m3- All 3 must match to trigger (match count = 3)2d10!m:2- Match explode, max 2 chain explosions
With Selectors (filter which values can match):
2d10!m>5- Only values greater than 5 can form a match3d10!m3>=4:2- 3 dice must match on a value ≥4, max 2 explosions
Multiple Match Groups:
If multiple distinct matching groups exist, each group triggers its own explosion. For example, 4d6!m rolling [3, 3, 5, 5] would spawn 2 explosion dice — one for the 3s and one for the 5s.
Chaining: When a matching explosion die lands on the same value that originally matched, it chains and spawns another explosion die (up to the max explosion limit).
With Advantage/Disadvantage:
When combined with keep/drop operators (e.g., 3d10kh2!m), explosion dice only count toward the matching group's total. The system evaluates all possible kept-dice combinations and picks the best (advantage) or worst (disadvantage) total. For example, 3d10kh2!m rolling [2, 2, 7] with explosion [8] would compare: keeping {2, 2} + explosion 8 = 12 vs keeping {7, 2} = 9, and choose 12.
Validation:
The dice count must be at least the match count. 2d10!m3 is invalid because you can't match 3 dice with only 2.
Note: Matching explode dice are thrown like regular exploding dice, identically on every player's screen.
Re-Roll
Re-roll dice that meet certain conditions:
Basic Re-Roll:
1d20r- Re-roll on 1 (implicit minimum, infinite)1d20ro- Re-roll once on 11d20r1- Re-roll on 1 (explicit single value)1d20r<5- Re-roll on any value less than 51d6r6:3- Re-roll on 6, maximum 3 re-rolls
Multiple Values (Comma-Separated):
1d20r1,2- Re-roll on 1 or 21d8r1,2,7,8- Re-roll on extreme values
Note: A re-rolled die is replaced half a second after it lands, at the same moment and with the same throw on every player's screen.
Critical Success and Failure
Use cs and cf to set critical success and critical failure (fumble) points:
| Notation | Critical result |
|---|---|
1d20cs>10 |
Success on 10 or higher |
1d20cf<3 |
Failure on 3 or lower |
1d20cs20cs10 |
Success on exactly 20 or 10 |
1d20cs>18cf<3 |
Success on 18–20; failure on 1–3 |
1d20!>=18cs>18 |
Explode on 18 or higher and mark those results as critical successes |
For critical points, > and < are inclusive (as are >= and <=). Repeated conditions of the same kind match any listed condition. Dice have no critical points unless they are written in the notation or the roller's Critical Highlight setting covers the die; written points replace the setting's automatic point of the same kind.
Critical points only affect presentation, never totals, success-counting pools, rerolls, or explosion thresholds. Explosion comparisons retain their usual strict/inclusive meanings, so use !>=18 to explode on 18 or higher. Kept critical results use a green highlight for success and a red highlight for failure in the results panel and history; hover over a highlighted number for its critical status. The Critical Effects setting controls their tray effects; turning it off leaves the number highlights visible.
Target Success / Dice Pool
Some systems use dice pools where you count successes (dice meeting a condition) rather than summing values.
How It Works:
- Place the compare point immediately after the dice (before operators):
5d10>=8 - Each die that meets the condition counts as 1 success
- Total = number of successes (not sum of values)
Basic Dice Pools:
5d10>=8- Count dice that rolled 8 or higher2d6=6- Count only exact rolls of 64d3>1- Count dice greater than 14d3<2- Count dice less than 26d10<=4- Count dice 4 or lower2d6<>4- Count dice not equal to 4 (use<>, not!=)
With Failures:
Add an f modifier to count failures that subtract from successes:
4d6>4f<3- Success: >4, Failure: <3- Total = (successes) - (failures)
Display Format:
5d10>=8: [2, 4, 6*, 3, 8*] = 2-*marks successes4d6>4f<3: [2_, 5*, 4, 5*] = 1-_marks failures
Combining with Other Operators:
Dice pools work with other operators:
5d10>=8!- Dice pool with exploding dice (explode on max)5d10>=8r1- Dice pool with reroll 1s
Operator Order Matters:
5d10>=8- Dice pool (count ≥8 as successes)5d10!>=8- Exploding dice (explode on ≥8, sum values)5d10>=8!- Dice pool + explosions (count ≥8, explode on 10)
Important Notes:
- Compare point MUST be immediately after
XdYfor dice pools - If compare point follows
!orr, it's the selector for that operator - Failure modifier
fmust follow a success condition - Use
<>for "not equal", not!=
Examples:
2d6=6: [4, 6*] = 1 // only 6 is a success
4d3>1: [1, 3*, 2*, 1] = 2 // >1 is a success
4d3<2: [1*, 3, 2, 1*] = 2 // <2 is a success
5d8>=5: [2, 4, 6*, 3, 8*] = 2 // ≥5 is a success
6d10<=4: [7, 2*, 10, 3*, 3*, 4*] = 4 // ≤4 is a success
4d6>4f<3: [2_, 5*, 4, 5*] = 1 // 2 successes - 1 failure = 1
5d10>=8!: [2, 4, 6*, 3, 8*, 10*, 7*] = 4 // Pool with explosion
Reroll Highest / Lowest
Reroll the N highest or lowest dice after all dice have settled. Unlike r/ro (which reroll individual dice as they land), rh/rl rank all dice together and reroll the selected ones.
Notation: rh[count][condition][:maxIterations] / rl[count][condition][:maxIterations]
count- Number of dice to target (default: 1 if omitted)condition- Optional: only reroll if the targeted die meets this condition:N- Optional: maximum number of rerolls per targeted die
Examples:
3d6rh- Roll 3d6, reroll the highest die once3d6rh2- Roll 3d6, reroll the two highest dice once each3d6rl- Roll 3d6, reroll the lowest die once3d6rl1<3- Roll 3d6, reroll the lowest die only if it rolled less than 33d6rl1<3:2- Roll 3d6, reroll the lowest die if < 3, up to 2 times
Behavior:
- Without a condition: the targeted die(s) are always rerolled exactly once
- With a condition: the targeted die is rerolled while its value still matches the condition (up to maxIterations)
Note: Rank rerolls wait for all dice in the group to settle, then physically despawn and re-throw the targeted dice — just like
r/rorerolls. The results are calculated deterministically so all players see the same final values.
Unique (Coming Soon)
4d6u- Roll 4d6, all results must be unique4d6uo- Roll 4d6 unique, unlimited re-rolls to ensure uniqueness
Advanced Operators
Dice Model Selection
Assign specific dice from your dice bag by name:
2d6{Red}- Use dice named "Red" from your d6 dice bag1d12{Fear}+1d12{Hope}- Use "Fear" and "Hope" dice- If the named die doesn't exist, falls back to normal cycling through active dice
Roll Descriptions/Labels
Add descriptive labels to your rolls using the # symbol. The # can appear immediately after a dice roll or at the end of the full expression:
3d6 #Fire damage- Label attached directly to a dice roll3d6-1 #Fire damage- Label at the end of a full expression (after math)(3d6-1)+(3d6-2) #Attack roll- Label after a parenthesized expression3d6 #Fire + 2d6 #Ice- Multiple rolls with per-roll descriptions1d20+5#ToHit, 1d8+3#Damage- One label per roll in a comma-separated list(1d6+1#Sword, 1d8+2#Axe)kh1- One label per entry in a grouped roll
When # appears directly after XdY (before any operators or math), it labels that specific dice group. When # appears after the full expression it labels the entire roll — and in a comma-separated list or a grouped roll, it labels the entry it follows.
A label runs to the end of the notation, stopping at a math operator (+, -, *, /), a comma, or the ) that closes a group it sits inside. So a label cannot itself contain those characters: write #Fire damage, not #Fire, cold damage.
A # always follows what it labels, so it never clashes with the repeat shorthand, where the # comes before the expression it repeats: 6#4d6dl1 #Ability scores repeats 4d6dl1 six times and labels them. The x spelling of a repeat (6x4d6dl1 #Ability scores) keeps the two apart visually.
Combined Features
All features can be combined for powerful roll expressions:
3d6{Red} # Fire damage + 2d6{White} # Frost damage- Models and descriptions2d20dl1{Red} # Attack with advantage- Drop lowest with model and description4d6dh1 # Ability Score- Drop highest with description
Mathematical Operations
Dice+ supports standard mathematical operations with proper operator precedence:
Multiplication and Division:
2*2d6- Roll 2d6 and multiply the result by 22d6*2- Roll 2d6 and multiply the result by 22d6/2- Roll 2d6 and divide the result by 2 (rounded down)2d6+5*10- Roll 2d6 and add 50 (5×10 is evaluated first)
Parentheses for Order of Operations:
2*(2d6+2d8)- Roll 2d6 and 2d8, sum them, then multiply by 2(4d6kh3)*2- Roll 4d6 keep highest 3, then multiply the result by 2(2d6+5)*3- Roll 2d6, add 5, then multiply the total by 3(3d6-1)+(3d6-2)- Two separate d6 groups each with their own modifier
Operator Precedence (standard math rules):
- Parentheses
()- Evaluated first - Multiplication
*and Division/- Evaluated left to right - Addition
+and Subtraction-- Evaluated left to right
Display Format:
2*2d6with rolls [4, 4] → Display:2*[4, 4] 8 = 162d6+5*10with rolls [3, 4] → Display:[3, 4] 7+50 = 572*(2d6+2d8)with rolls [4,4]+[3,7] → Display:2*([4, 4] 8+[3, 7] 10) = 36
Complex Expressions
Dice notation supports complex mathematical expressions:
2d20 + 1d6 + 5- Multiple dice types in one roll2d20kh1 + 1d4- Combine advantage with additional dice-1d4- Negative dice (subtract the result)3d6!1,6 # Wild Magic- Explode on 1 or 6 with description2d20kh1 + 1d6!5,6 + 3- Advantage with exploding damage dice2d8*2 # Doubled damage- Multiply dice results with description(1d6+1d8)*2 + 5- Complex expression with parentheses
Arbitrary Dice
Use d{values} to assign custom integer results to each face, following AnyDice's arbitrary dice notation. Entries stay in the order written; repeated values give that result more chances to occur.
| Notation | Description |
|---|---|
d{0,0,0,1,1,2} |
A d6: faces 1–3 score 0, faces 4–5 score 1, and face 6 scores 2 |
2d{1..6} + 3 |
Two dice with faces 1, 2, 3, 4, 5, 6, plus 3 |
d{-2..2,5} |
A d6 with values −2, −1, 0, 1, 2, 5 |
d{10,20,30,40,50} |
Five equally likely results, resolved by the random fallback |
Ranges include both endpoints and increase by 1. Lists must be nonempty and contain integers or ascending ranges. The expanded face count selects the physical die model when available (including the usual paired d10s for 100 faces); other counts use the existing random fallback.
Note: Physical face labels
Physical dice retain their usual face labels, while results and totals use the custom values.
Arbitrary dice support counts, arithmetic, and grouped rolls. Per-die operators (keep/drop, reroll, explode, min/max, and success comparisons) are not supported.
Fudge Dice (dF Notation)
For Fate / Fudge system games. dF (or df) rolls a six-sided die showing two +, two blank, two - faces. Each die contributes −1, 0, or +1 to the total.
| Notation | Description | Result Range |
|---|---|---|
dF / 1dF |
One Fudge die | −1 to +1 |
4dF |
Four Fudge dice (standard Fate ladder) | −4 to +4 |
4dF + 2 |
Four Fudge dice with a +2 skill modifier | −2 to +6 |
1d20 + 1dF |
Mixed roll | varies |
Mapping: Each Fudge die is physically a d6. Faces 1 and 4 → −1; faces 2 and 5 → 0; faces 3 and 6 → +1. The visible glyph on the die is + / blank / -.
Restrictions: Fudge dice support only count and arithmetic (+, -, *, /). Operators like ! (explode), kh/kl (keep), r (reroll), and dice pool comparisons are not allowed on dF.
Dicebag preview: When editing a d6 in the dice bag, a "Show as Fudge die (preview)" toggle previews the Fudge texture without changing the saved die. Rolling Fudge always uses dF notation.
Table Roll Notation (T Notation)
Use T followed by digits to roll multiple dice as place values — perfect for rolling on lookup tables in TTRPGs like Warhammer, OSR games, and others that use "roll on a D66 table" style mechanics.
Each digit after T specifies the die type for that place (hundreds, tens, ones, etc.):
| Notation | Dice Rolled | Result Range |
|---|---|---|
T66 |
d6 (tens) + d6 (ones) | 11 – 66 |
T88 |
d8 + d8 | 11 – 88 |
T468 |
d4 + d6 + d8 | 111 – 468 |
T1000 |
d10 + d10 + d10 | 1 – 1000 |
T108 |
d10 (tens) + d8 (ones) | 1 – 98 |
T6666 |
four d6s | 1111 – 6666 |
Special digit rules:
10as a consecutive pair → d10 (e.g.,T108= d10 for tens, d8 for ones)0alone (not at start) → d10 (e.g.,T1000= three d10s)- Single digits
1–9→ die with that many sides (e.g.,T66= two d6s)
d10 convention: When a d10 shows 10, it counts as 0 for the place value — the same convention as percentile dice. For all-d10 table rolls, a result of all-zeros equals the maximum (e.g., T1000 with three 10s → 1000, T100 with two 10s → 100).
Examples:
T66— Roll on a Warhammer-style 36-entry table (results: 11, 12, ..., 66)T1000— Roll on a 1000-entry table (same as three d10s / d1000)T468— Roll on a custom 64-entry table with varied dice
Table rolls can be combined with math modifiers:
T66+10— Table roll result plus 10T66 Magic Item— Named table roll
Grouped Rolls
Roll several complete rolls at once and keep or drop whole results by their totals. Wrap comma-separated rolls in parentheses and add a group operator after the closing parenthesis:
| Notation | Meaning |
|---|---|
(2d6, 1d12)kh1 |
Roll both; keep the higher total |
(2d6, 1d12, 1d8)kh2 |
Keep the two highest totals and add them |
(2d6, 1d12)kl1 |
Keep the lower total |
(2d6, 1d12, 1d8)dh1 |
Drop the highest total, add the rest |
(2d6, 1d12, 1d8)dl1 |
Drop the lowest total, add the rest |
(2d6, 1d12)+5 |
No operator inside math: totals are simply added |
- Every die rolls physically — dice from dropped rolls stay visible but grayed out.
- Each entry is a full roll: operators and math work inside, e.g.
(1d4r<1, 1d6r<1, 2d8r<1)kh1or(2d6+3, 1d12)kh1+5. - Entries can be labelled with
#, e.g.(1d6+1#Sword, 1d8+2#Axe)kh1. - The number after the operator is optional and defaults to 1 (
kh=kh1). - If totals tie, the roll written first wins.
- Groups cannot be nested inside other groups.
- A bare parenthesized list with no group operator that is the whole notation, e.g.
(2d6, 1d12), is treated as a multi-roll — each entry becomes its own independent result. - One quirk: a plain number directly after an operator value list is read as part of the list — in
(1d6r1,2, 3)kh1the3joinsr1,2. Reorder the entries ((3, 1d6r1,2)kh1) or write3+0.
Multiple Rolls at Once
Separate complete rolls with commas (no group operator) to roll them all together while keeping each result independent. All dice hit the tray at the same time, and the results panel shows one row per roll — each with its dice values, notation, and its own total.
| Notation | Meaning |
|---|---|
1d12, 2d6, 2d20kh1 |
Three independent rolls, one row each |
2d20kh1+5, 2d20kh1+3, 2d20kh1+4 |
Three attack rolls with different bonuses |
(2d20kh1+5, 2d20kh1+3) |
Same — outer parentheses are optional |
1d20+7, (2d6, 1d12)kh1 |
An attack plus a grouped damage roll as separate results |
- Each entry supports the full notation syntax: operators, math, tags, table rolls, and grouped rolls.
- There is no combined grand total — every row stands on its own.
- Roll history stores the whole multi-roll as one entry; rerolling repeats all of it.
- To label a row, end it with
#Label(e.g.1d20+5#ToHit, 1d8+3#Damage); the label appears next to that row's notation. A#placed directly after the dice (1d20#Attack+7, 2d6#Damage) still labels just that dice group and shows next to its values. - For extensions using the broadcast API:
totalin the roll-result message is the sum of all rows; per-row values can be recomputed fromgroupsand the notation, androllSummarylists each row as... = totalsegments separated by|, each prefixed withLabel:when the row is labelled.
Repeating a Roll
Write X# or Xx in front of an expression to roll it X times. It is pure shorthand: 6#4d6dl1 is identical to typing 4d6dl1, 4d6dl1, 4d6dl1, 4d6dl1, 4d6dl1, 4d6dl1, right down to the six independent result rows.
| Notation | Meaning |
|---|---|
6#4d6dl1 |
Classic stat generation: six ability scores |
6x4d6dl1 |
Exactly the same — x is an alternate spelling of # |
3#1d20+5 |
Three separate attack rolls |
2#1d20, 1d8 |
Two d20 rows plus a d8 row — repeats mix freely with commas |
4#T66 |
Roll four times on the same table |
(3#1d6)kh1 |
Three d6 as a grouped roll: keep the highest |
- The repeated expression can be anything a comma entry can be: operators, math, tags, descriptions, table rolls, and grouped rolls.
- The count must sit directly against the
#orx(6#4d6dl1/6x4d6dl1, not6 # 4d6dl1), which is what keeps it distinct from a#label. - Because
xis a letter, it only counts as a repeat when a roll follows it — a digit,d,Tor(. So1d6x2is still a roll named "x2", not a repeat. - A description on the repeated roll is repeated too:
6#4d6dl1 #Ability scorelabels every row. - Repeat counts run from 1 to 100. Remember the dice all spawn at once —
20#8d6is 160 dice in the tray.
Extension Integration
Dice+ provides broadcast channels for integration with other Owlbear Rodeo extensions using the OBR Broadcast API.
Building a website, character sheet or another VTT instead? The Dice+ SDK embeds the dice tray and dice bag on any site.
Ready Check Channel
Before sending roll requests, external extensions can check if Dice+ is loaded and ready to accept requests.
Channel: dice-plus/isReady
How It Works:
- Your extension sends a ready check request on the
dice-plus/isReadychannel - Dice+ automatically responds on the same channel when it's ready
- Your extension listens for the response to confirm Dice+ is available
Request Message Structure:
{
requestId: string; // Unique request identifier (to match responses)
timestamp: number; // Request timestamp
}
Response Message Structure:
{
requestId: string; // Matches the request requestId
ready: true; // Always true when Dice+ responds
timestamp: number; // Response timestamp
}
Example:
import OBR from "@owlbear-rodeo/sdk";
async function checkDicePlusReady(): Promise<boolean> {
const requestId = crypto.randomUUID();
return new Promise((resolve) => {
const unsubscribe = OBR.broadcast.onMessage("dice-plus/isReady", (event) => {
const data = event.data;
// Check if this is a response (not a request)
if ('ready' in data && data.requestId === requestId) {
unsubscribe();
resolve(true);
}
});
// Send ready check request
OBR.broadcast.sendMessage("dice-plus/isReady", {
requestId,
timestamp: Date.now()
}, { destination: 'ALL' });
// Timeout after 1 second if no response
setTimeout(() => {
unsubscribe();
resolve(false);
}, 1000);
});
}
// Use it before sending roll requests
const isDicePlusReady = await checkDicePlusReady();
if (!isDicePlusReady) {
console.error("Dice Plus extension not found!");
return;
}
Notation Validation Channel
Check whether a dice notation string is valid before sending a roll request. No dice are rolled and nothing is logged to stats or history — this is a pure parse check.
Channel: dice-plus/validate-notation
How It Works:
- Your extension sends a validation request on the
dice-plus/validate-notationchannel - Dice+ validates the notation with its parser and responds on the same channel
- Requests and responses share the channel — responses are the messages that carry a
validfield - In a multi-client room every Dice+ client responds; results are identical, so match on
requestIdand use the first response
Request Message Structure:
{
requestId: string; // Unique request identifier (to match responses)
notation: string; // The dice notation to validate (e.g. "4d6kh3+2")
timestamp: number; // Request timestamp
}
Response Message Structure:
{
requestId: string; // Matches the request requestId
notation: string; // The notation from the request, echoed back
valid: boolean; // Whether the notation parsed successfully
error?: { // Present only when valid is false
message: string; // Human-readable parse error
position: number; // 0-based character index where parsing failed
};
timestamp: number; // Response timestamp
}
Example:
import OBR from "@owlbear-rodeo/sdk";
async function validateNotation(notation: string): Promise<{ valid: boolean; error?: string }> {
const requestId = crypto.randomUUID();
return new Promise((resolve) => {
const unsubscribe = OBR.broadcast.onMessage("dice-plus/validate-notation", (event) => {
const data = event.data;
// Check if this is a response (not a request)
if ('valid' in data && data.requestId === requestId) {
unsubscribe();
resolve({ valid: data.valid, error: data.error?.message });
}
});
// Send validation request
OBR.broadcast.sendMessage("dice-plus/validate-notation", {
requestId,
notation,
timestamp: Date.now()
}, { destination: 'ALL' });
// Timeout after 1 second if no response
setTimeout(() => {
unsubscribe();
resolve({ valid: false, error: "Dice+ did not respond" });
}, 1000);
});
}
const check = await validateNotation("4d6kh3+2");
if (!check.valid) {
console.error("Invalid notation:", check.error);
}
Roll Request Channel
Other extensions can send dice roll requests to Dice+ using the broadcast channel.
Channel: dice-plus/roll-request
Message Structure:
{
rollId: string; // Unique roll identifier (save this to match results)
playerId: string; // OBR player ID
playerName: string; // Player display name
rollTarget: 'everyone' | 'self' | 'dm' | 'gm_only'; // Who sees the roll
diceNotation: string; // Standard dice notation (e.g., "2d20kh1+5")
showResults: boolean; // Show default popup (false = handle in your UI)
timestamp: number; // Request timestamp
source: string; // Your extension identifier (e.g., "my-extension-id")
dice?: { // Optional: how dice look when the player's bag has none of that type
default?: StandardDiceStyle;
byType?: { [dieType: string]: StandardDiceStyle }; // e.g. { d20: { color: '#c0392b' } }
};
}
// The free fields of the standard material; anything left out keeps the default
interface StandardDiceStyle {
color?: string; // '#rrggbb'
numberColor?: string; // '#rrggbb'
font?: 'standard' | 'norse' | 'aelfa';
shape?: string; // A free shape for the die type, e.g. 'sharp'
roughness?: number; // 0–1
metalness?: number; // 0–1
opacity?: number; // 0–1
sheen?: number; // 0–1
numberDepth?: number; // 0–1
}
Important Notes:
- source field: Must be your extension's unique identifier. This is used to create dedicated result and error channels for your extension.
- Result channels: Results are sent to your dedicate channel:
{source}/roll-result- Your extension's dedicated channel
- Error channel: Errors will be sent to
{source}/roll-error - Stats & History: ALL rolls (internal and external) are automatically logged to Dice+ stats and history to be viewed in dice bag stats panel no matter the source of the roll and to track dice statistics
- Dice look (
dice): The player's own dice bag always wins.diceonly styles die types the player has no dice for (every type, if they have never saved a bag). Per-type styles beatdefault. Only the free standard-material fields above are used; anything else (premium materials, custom fonts, premium shapes) is ignored, the roll goes ahead, and Dice+ sends aroll-errorwithwarning: truenaming what it ignored. - Popup behavior:
- Internal rolls always show the Dice+ popup
- External rolls show popup only if
showResults: true
Roll Targets:
'everyone'- All players see the dice roll and results'self'- Only the roller sees the dice and results'dm'(GM/Self) - Both the GM and the roller see the dice and results'gm_only'(GM Only) - Only the GM sees the dice and results. The roll always executes on the GM's screen regardless of who initiated it. The original player's identity is preserved in the result.
Example:
import OBR from "@owlbear-rodeo/sdk";
const MY_EXTENSION_ID = "my-extension-id"; // Use your extension's unique identifier
const rollId = `roll_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
// Send roll request
await OBR.broadcast.sendMessage("dice-plus/roll-request", {
rollId,
playerId: await OBR.player.getId(),
playerName: await OBR.player.getName(),
rollTarget: 'everyone',
diceNotation: '2d20kh1+5',
showResults: false, // Handle results in your own UI
timestamp: Date.now(),
source: MY_EXTENSION_ID // Use your extension ID
}, { destination: 'ALL' });
// Listen for results on YOUR extension's channel
OBR.broadcast.onMessage(`${MY_EXTENSION_ID}/roll-result`, (event) => {
const result = event.data;
// Handle your roll result
if (result.rollId === rollId) {
console.log("Roll complete:", result.result.totalValue);
}
});
// Listen for errors on YOUR extension's channel
OBR.broadcast.onMessage(`${MY_EXTENSION_ID}/roll-error`, (event) => {
const error = event.data;
if (error.rollId === rollId) {
console.error("Roll failed:", error.error);
}
});
Roll Result Channel
Dice+ sends roll results to source-specific broadcast channels.
Channel: {source}/roll-result (where {source} is the value you provided in the roll request)
Message Structure:
{
rollId: string; // Matches the request rollId
playerId: string; // Who rolled
playerName: string; // Display name
rollTarget: 'everyone' | 'self' | 'dm' | 'gm_only'; // Roll target
timestamp: number; // Original timestamp
result: {
rollId: string; // Roll identifier
diceNotation: string; // Original notation
totalValue: number; // Final sum (correctly handles *, /, ()); text faces add nothing
rollSummary: string; // E.g., "2d6+3 = 11" or "2*[4,4] 8 = 16"
groups: DiceGroup[]; // Grouped results by notation order
tally?: Record<string, number>; // Text faces rolled, e.g. { "Skull": 2 }; absent when none
};
}
// DiceGroup structure
interface DiceGroup {
description?: string; // E.g., "Fire" from "# Fire"
diceModel?: string; // E.g., "Red" from "{Red}"
diceType: string; // E.g., "d6", "d20"
dice: DiceResult[]; // Individual dice in this group
total: number; // Total of kept dice in this group
tally?: Record<string, number>; // Text faces among this group's kept dice; absent when none
isNegative?: boolean; // Whether this group is subtracted
isCondensed?: boolean; // True when the group was condensed (see below)
condensedCount?: number; // Original dice count before condensation
}
Text faces: A die face can count as text instead of a number (see Faces & Font). Such a die has a
labelwith that text, and itsvalueis the plain face number it landed on. It adds nothing tototalortotalValue; it is counted intallyinstead. If you add upvalueyourself, skip dice that have alabel.
Imploding dice: An implosion die (see Exploding & Imploding) has
imploded: true, and itsvalueis already negative, so summingvaluestill gives the right total. The die that triggered it haswasImploded: true. A compounded implosion (ii) is a single die withcompoundedImplode: trueand its net value, which can be negative. Compounded dice (!!andii) also carrycompoundParts, the chain in order with each part signed as it counts, e.g.[1, -4].
Message size limit: OBR caps broadcast messages at 64KB. If a roll result would exceed that (very large rolls or many multi-roll rows), Dice+ condenses each group to a single aggregate entry —
dicecontains one item whosevalueis the group total, withisCondensed: trueandcondensedCountset. Group totals andtotalValueare always preserved.
Complete Example with Data:
Example 1: Advantage with Subtraction - 2d20kh1-1d4 (advantage on d20, subtract 1d4):
const MY_EXTENSION_ID = "my-extension-id";
// Request sent
const rollId = 'roll_1760043220783_abc123';
await OBR.broadcast.sendMessage("dice-plus/roll-request", {
rollId,
playerId: '81e7413f-920c-4639-bd9d-1895ac156cf1',
playerName: 'Gandalf',
rollTarget: 'everyone',
diceNotation: '2d20kh1-1d4',
showResults: false,
timestamp: 1760043220783,
source: MY_EXTENSION_ID // Your extension ID
}, { destination: 'ALL' });
// Result received on channel: my-extension-id/roll-result
{
rollId: 'roll_1760043220783_abc123',
playerId: '81e7413f-920c-4639-bd9d-1895ac156cf1',
playerName: 'Gandalf',
rollTarget: 'everyone',
timestamp: 1760043220783,
result: {
rollId: 'roll_1760043220783_abc123',
diceNotation: '2d20kh1-1d4',
totalValue: 15, // Final result: 18 - 3 = 15
rollSummary: '[18] 18 - 3 = 15', // Human-readable summary
groups: [
{
diceType: "d20",
dice: [
{ diceId: 'dice_001', rollId: 'roll_abc123', diceType: 'd20', value: 18, kept: true },
{ diceId: 'dice_002', rollId: 'roll_abc123', diceType: 'd20', value: 7, kept: false }
],
total: 18, // Total of kept dice only (18)
isNegative: false
},
{
diceType: "d4",
dice: [
{ diceId: 'dice_003', rollId: 'roll_abc123', diceType: 'd4', value: 3, kept: true }
],
total: 3,
isNegative: true // This group is subtracted
}
]
}
}
Understanding the Results:
groupsorganizes all dice into their notation groups - even single dice get their own group- Each group includes ALL dice rolled for that group (both kept and dropped dice)
- Each group's
dicearray contains all dice with akeptflag indicating if they count toward the total - Each group's
totalfield is the sum of only the kept dice in that group totalValueis the final calculated result after all modifiers- For
2d20kh1-1d4: rolled 18 and 7 on the d20s (kept 18), rolled 3 on the d4, final: 18 - 3 = 15
Example 2: Multiplication - 2*2d6 (roll 2d6 and multiply by 2):
// Result received on channel: my-extension-id/roll-result
{
rollId: 'roll_1760043220783_xyz789',
playerId: '81e7413f-920c-4639-bd9d-1895ac156cf1',
playerName: 'Gandalf',
rollTarget: 'everyone',
timestamp: 1760043220783,
result: {
rollId: 'roll_1760043220783_xyz789',
diceNotation: '2*2d6',
totalValue: 16, // Final result: 2 * 8 = 16
rollSummary: '2*[4, 4] 8 = 16', // Shows the multiplication
groups: [
{
diceType: "d6",
dice: [
{ diceId: 'dice_001', rollId: 'roll_xyz789', diceType: 'd6', value: 4, kept: true },
{ diceId: 'dice_002', rollId: 'roll_xyz789', diceType: 'd6', value: 4, kept: true }
],
total: 8, // Total of dice (4 + 4 = 8)
isNegative: false
}
]
}
}
Example 3: Descriptions and Dice Models - 3d6{Red} # Fire + 2d6{White} # Ice:
// Result received on channel: my-extension-id/roll-result
{
rollId: 'roll_1760043220783_xyz789',
playerId: '81e7413f-920c-4639-bd9d-1895ac156cf1',
playerName: 'Gandalf',
rollTarget: 'everyone',
timestamp: 1760043220783,
result: {
rollId: 'roll_1760043220783_xyz789',
diceNotation: '3d6{Red} # Fire + 2d6{White} # Ice',
totalValue: 19,
rollSummary: '[1, 3, 6] 10 Fire + [2, 3, 4] 9 Ice = 19',
groups: [
{
description: "Fire",
diceModel: "Red",
diceType: "d6",
dice: [
{ diceId: 'dice_001', rollId: 'roll_xyz789', diceType: 'd6', value: 1, kept: true },
{ diceId: 'dice_002', rollId: 'roll_xyz789', diceType: 'd6', value: 3, kept: true },
{ diceId: 'dice_003', rollId: 'roll_xyz789', diceType: 'd6', value: 6, kept: true }
],
total: 10,
isNegative: false
},
{
description: "Ice",
diceModel: "White",
diceType: "d6",
dice: [
{ diceId: 'dice_004', rollId: 'roll_xyz789', diceType: 'd6', value: 2, kept: true },
{ diceId: 'dice_005', rollId: 'roll_xyz789', diceType: 'd6', value: 3, kept: true },
{ diceId: 'dice_006', rollId: 'roll_xyz789', diceType: 'd6', value: 4, kept: true }
],
total: 9,
isNegative: false
}
]
}
}
The groups field makes it easy to:
- Access dice results organized by their notation order
- Get the description and dice model name for each group
- Calculate group totals without parsing individual dice
- Build custom UI displays that match the roll notation
Roll Error Channel
Dice+ sends error messages to source-specific channels when a roll fails.
Channel: {source}/roll-error (where {source} is the value you provided in the roll request)
Message Structure:
{
rollId: string; // Matches the request rollId
error: string; // Error message
notation: string; // Notation that failed
warning?: true; // Present when the roll still went ahead (part of the request was ignored)
}
While the player runs a fairness test, Dice+ refuses every roll request with error: "Dice+ is running a fairness test. Try again when it finishes.". dice-plus/isReady still answers ready.
Example Listener:
const MY_EXTENSION_ID = "my-extension-id";
OBR.broadcast.onMessage(`${MY_EXTENSION_ID}/roll-error`, (event) => {
const error = event.data;
// Match by rollId if needed
if (error.rollId === rollId) {
console.error(`Roll failed: ${error.error}`);
}
});
Made with ❤️ for the Owlbear Rodeo community