Dice+ for DevelopersSDK referenceRoller

Put real 3D dice on your site.

Character sheets, VTTs and campaign tools can embed the Dice+ tray and dice bag. You build the buttons and the results; we run the physics, the rooms and Premium.

Request an Access KeyRead the SDK reference

The dice tray

Our 3D tray over your page or in any box you give it. Roll with notation, get results back as events, and draw them your own way. Headless mode rolls without drawing, for sites that show dice only on the VTT.

Rolls that reach the table

Join a Dice+ room with its code and passcode. Your players roll from your site and land on everyone's screen, Owlbear Rodeo included, with the same physics everywhere.

The dice bag, Premium included

Drop in the player's own dice bag: their dice, stats and cloud backup. Patreon sign-in and premium dice are handled for you; your site never touches either.

A first roll

Install @dice-plus/sdk from npm, or import it straight from https://dice-plus.missinglinkdev.com/sdk/v1.js. Then:

import { DicePlusTray } from '@dice-plus/sdk';

const tray = new DicePlusTray({
  apiKey: 'dp_your_key',
  container: document.body,              // the tray fills it, click-through
  identity: { name: 'Ari', color: '#e07a5f' },
  dice: { default: { color: '#c0392b', numberColor: '#ffffff' } },
});

tray.on('roll-result', ({ result, isOwn }) => {
  console.log(result.playerName, result.result.totalValue);
});

await tray.roll({ diceNotation: '2d20kh1+5' });

Rooms, the dice bag, headless mode and every event are in the SDK reference.

What we ask

Dice+ is free to embed. It's a passion project kept running by its patrons, so in return:

  • Show “Dice powered by Dice+” on pages that use the embeds, with links to dice-plus.missinglinkdev.com and the Dice+ Patreon, somewhere players can see it.
  • Keep the dice bag's own footer visible when you show the bag.
  • Don't resell or redistribute Dice+ dice, materials or models, or put Premium features behind your own paywall.
  • Keys are tied to the sites you list. We may revoke a key that breaks these terms.

Request an Access Key

Every site needs a key to run the embeds. The key is tied to the sites you list here.

One per line, scheme and host only. localhost always works for development.

Where we send your key. Never shown or shared.