The Elgato StreamDeck Plugin is desgined to allow you to send rolls from your StreamDeck into your dddice room. Rolls made from your StreamDeck will show up anywhere else you are connected to that room, be it from our Foundry VTT module, D&D Beyond or Roll20 via our Browser Plugin or our Streaming Mode
You can install this plugin from directly inside your StreamDeck software by clicking on the and searching for dddice under plugins or from the Elgato Plugin Store page
You can also install it by downloading the latest build from our GitHub Repo and double-clicking on the .streamDeckPlugin file
Once the plugin is installed there will be category of buttons labeled "dddice". Right now we only support one button and that is a "roll macro" button.
Adding your API Key
Once you add a button you will be asked for your API Key. You can generate one by navigating to our Developer Tools page and clicking on "Create API Key" at the bottom. This will copy the API Key to your clipboard. Paste this into the space for it in the StreamDeck software and click the ✔ button.
Wait for your profile to load, it will take a second or two.
Setting up a macro button
A macro button has 4 fields a "Name" that shows up on the button, a roll equation (ex 1d20+2), a room to roll it in, and a dice theme, which is the color / look of the dice you want to roll.
If your profile was properly loaded the dropdowns for "Room" and "Theme" should have options for you to select from.
Roll equation format
Our roll equations are a subset of the formats you might be familiar with from Roll20 or Foundry VTT and others. We support the standard XdY format as well as modifiers (ex 6d6, 1d20+5, 1d6+1d8). We also support kh1 and kl1 for advantage and disadvantage respectively.