Pixels DnD Beyond integration

This is a userscript that integrates Pixels into DnD Beyond by making it possible to throw pixel dice and submit the result to DnD Beyond.

This is currently the only way to use Pixels with DnD Beyond, as DnD Beyond didn't add support for Pixels yet.

Video

I made a short video that shows how to use the full chrome extension:

Features

• Can connect to Pixel dice
• Can identify a roll with a Pixel die and submit it to DnD Beyond as a custom roll
• Die rolls appear in the game log for other players that are in the session
• "Pixel Mode" button. Let's you choose a check/save/damage and waits for you to roll your Pixel die. After you rolled the die, it automatically submits the roll to DnD Beyond

Which browsers are supported?

These are the browsers we have tested and confirmed to work:

• Google Chrome
• Chromium
• Microsoft Edge
• Vivaldi

Brave also works, but only after manually enabling the Bluetooth Web API flag. You can do so here: brave://flags/#brave-web-bluetooth-api!

⚠️⚠️⚠️ Safari, Firefox and Opera are not supported yet, as they either don't support the Bluetooth Web API yet or disabled it on purpose! ⚠️⚠️⚠️

Download

You can now install the integration from the Chrome Web Store by clicking here! This is the easiest way to install the integration, as you don't have to do anything special. The Chrome Web Store version will receive updates less frequently than the userscript version, but it is also more stable.

Alternatively, you can install the userscript by following the instructions below.

1. Install Tampermonkey into your browser (make sure to use this link, as some browsers block Tampermonkey if it get's added via the chrome web store. When you follow this link, you get a button to install Tampermonkey from the respective browser's web store)
2. Install the script by clicking here and clicking on Install script. It will update automatically once per day after that.

How to use

1. Optional step: Change the flag chrome://flags/#enable-web-bluetooth-new-permissions-backend to enabled. That way you don't have to manually connect your dice every time you open the character sheet
2. Open a character sheet in DnD Beyond (make sure to reload the page once it's open if you opened it by clicking on view in your campaign or character overview)
3. Click on the Connect to Pixels text at the top right (to the right of the Subscribe text) and connect to your Pixel dice
4. Repeat step 2 for every pixel die you want to connect

Once you are connected to your Pixel dice, there are 2 ways to roll with them:

1. Pixel Mode is enabled by default. Every time you click on a check/save/damage button, it will check if you have a pixel die connected that matches the roll you clicked on and then wait for you to roll your Pixel die (if you don't, it will roll a virtual die instead). Afterwards it automatically submits the roll to DnD Beyond. You can disable Pixel Mode by clicking on the Pixel Mode button at the top beside the Short Rest button.
2. Right click on a check/save/damage button and click on Roll with Pixels. Again the site will wait for you to roll your Pixel die and then automatically submit the roll to DnD Beyond.

Support for mobile

It is possible to use the integration with the mobile view of DnD Beyond. This requires the use of a browser that supports chrome extensions though:

Install the extension from the chrome web store

Follow the instructions in the mobile guide!

Install the extension via Tampermonkey (only for advanced users)

1. Install the Kiwi Browser from the Play Store and open it
2. Tap on the 3 dots and select Extensions. There, tap on + (from store)
3. A window of the chrome web store opens. Search for Tampermonkey and install it
4. Once installed, click on this link in the Kiwi browser! A window of Tampermonkey should pop up, asking you, if you want to install the script. Accept that
5. Go to DnD Beyond and open a character sheet. Make sure to reload it once.
6. Click on the hamburger menu on the top right and select Connect to Pixels. From here on everything should work like it does on PC

The Kiwi Browser is not the only browser that supports the extension. There is also the Lemur Browser. This one can even enable the flag for automatically reconnecting to your Pixel dice.

Todos / Things that need to be implemented

• Support other dice than D20s
• Test if it works with pixel dice actually, since I don't have any right now
• Make it possible to automatically add the modifiers to the roll (e.g. +5 for a strength check)
• Make it possible to roll multiple dice at once (e.g. 2d6+4)
• d100 rolls with a d10 and a d00
• Show the roll to the user as a toast/popup
• Show the roll in the game log to the user itself (currently only the other players who are in the session can see it live)

Known bugs

• Currently, the script only works if you open the character sheet in DnD Beyond directly (for example by reloading the page). If you open the character sheet by clicking on view in your campaign or character overwie, it won't work. (If you are using the chrome web store version, it will work in both cases)
• If you are connected to your pixel dice and reload the page, you have to reconnect to your pixel dice again. (It shows that the dice is already connected, but it doesn't work until you reconnect.)
• Healing spells can only be rolled with pixel by using the pixel mode. Other spells can also be rolled with pixel by using right click -> roll with pixel on the damage button.

Software used

• Pixels Web Connect (via unpkg)
• Pixels Edit Animation (via unpkg)