Skip to content

Streaming Mode

Streaming Mode Example of Streaming Mode in action. Image credit to Botched Roles on Twitch.

Note

This pairs well with our Elgoato StreamDeck plugin. Read about it or download it from the Elgato Plugin Store

dddice's Streaming Mode allows streamers to display 3D dice on top of their stream using OBS Studio. Watch it in action!

When you first open Streaming Mode, you will be greeted by a plain white page - fear not! This is exactly what you should see.

In less than 5-minutes, you'll turn this bare page into a 3D overlay for your stream.

Setting Up

Note

Whatever settings you have selected in the settings menu will be embedded into the streaming mode url.

If you wish to change the settings, you need to return to your room, edit the settings, regenerate the streaming mode urls, and then update the browser sources to use those new urls. Changing the settings in the room alone will not affect your stream overlays.

  1. Ensure OBS Studio or Twitch Studio is installed on your system.
  2. Navigate to your room and click on the cog in the upper right corner to open the settings menu
  3. Scroll down to the Streaming Mode section
  4. Click to open a Room (stream dice rolls) or Chat (stream chat messages)
  5. Click "Add Source" and choose "Browser" as the source Add Browser Source
  6. Name your browser source and click "OK" Name Browser Source
  7. Paste the URL of your streaming mode windows (copy the entire URL including the "?key=AAA...", but don't share or expose these secrets!) Configure Browser Source
  8. Position your stream anywhere, ensure the Browser source is the top most layer Position Browser Source
  9. That's it! Roll using your regular dddice room and watch as 3D dice appear on stream without any background

Using Multiple Streaming Modes

It is possible to setup multiple browser sources in your streaming software. A good use-case for this is to define different "landing zones" for each player to simulate physical dice trays.

Setup One Source Per Player(s)

Follow the steps above for each browser source you wish to add. To limit which player(s) appear in each source, append the following to the source URL.

# Limit one player, e.g. &player=1
&player={id}

# Limit multiple players, e.g. &player=1,2
&player={id},{id}

To find your player IDs, you can run the following in your terminal.

export DDDICE_AUTH_KEY="{YOUR_AUTH_KEY}"
export DDDICE_ROOM_SLUG="{YOUR_ROOM_SLUG}"

curl -s -H "Authorization: Bearer $DDDICE_AUTH_KEY" \
    "https://dddice.com/api/1.0/room/$DDDICE_ROOM_SLUG"

It is recommended to use jq to make filtering the IDs a little easier.

curl -s -H "Authorization: Bearer $DDDICE_AUTH_KEY" \
    "https://dddice.com/api/1.0/room/$DDDICE_ROOM_SLUG" | \
    jq '.data.participants[] | .id'