Hello Dice Masters!
Today, I am sharing a set of tools a long time in the making. This article is for the content creators out there, so it might be a little niche. If you are one of those, I think you can find something useful here. If you are not, thanks for reading this far… maybe this might get you into the content creation game.
Most of the content creators are familiar with OBS and have been using Trubie’s excellent Dice Masters Source to show Dice Masters cards on screen. However, as of recently (most likely due to OBS updates), the tool has not been working as it has in the past. I decided that this was as good of a time as any to try and get something similar working, but with more integration with Twitch.
Allow me to introduce the…
Think of it as a way of customizing the old Dice Masters Source almost any way you would like within the Twitch environment. More importantly, it opens the door to interaction with your audience while they watch on stream. Below, you can watch the YouTube tutorial showing off how these work. If you are more of the reading type, I will try and include instructions on how to make these tools work on your stream.
What You Will Need
Obviously, you will need OBS and a Twitch account as your starting point. I am assuming that you know how to get your stream up and running. If not, there are many great tutorials on how to do that. The next tool you will need is LioranBoard. This is an amazing stream deck that allows you to do so much with Twitch. The link to download LiroanBoard is below.
This will not be a lesson on how to use LioranBoard. Again, check out YouTube to learn the basics of it. The downloader should walk you through the process of getting it up and running.
Obviously, none of this will work without the main attraction. Here is the download link for the Dice Masters Twitch Tools:
Unzip these where is most convenient for you. I’ll tell you where these files need to go in the next section.
So, now you have all of the ingredients and know how to use them (you checked out those tutorials that I suggested… right?), it is time to put this all together.
Step 1: Setting Up OBS Scenes
For this to work, you will need two specific scenes. Start up OBS and create these scenes manually:
- Create Two Scenes. I recommend calling them “[NS] [DM] Player 1 Team” and “[NS] [DM] Player 2 Team“. The [NS] stands for Nested Scenes (which will be important later). [DM] is short for Dice Masters. I like to organize my Scenes by what game they refer to. You do not need to do this, but it is how I do things. These are going to be the basics for everything, so it is important that you have these as your base.
- Create the Sources. In each of the above Scenes, you will need to create 10 Browser Sources. While the above was recommended names, you MUST name the Sources as follows:
- The browser URL does not matter here. You can leave the default address as it is. The Dice Masters Twitch Tools will make the changes to these as needed. You will need to change the size of each Browser Source though. You want the width of the source changed to 368, and the height of the source changed to 510. This will give you the proper dimensions for the card images.
- Next, in order to make the Dice Masters Twitch Tools work, you will need to duplicate both of the Scenes that you created in the first step and name them “[NS] [DM] Player 1 Team Rotator” and “[NS] [DM] Player 2 Team Rotator“. This will set you up to have the basic card rotators appear on screen. Again, you do not need to follow my naming conventions here, but if you do not you will need to dive into the code on Lioranboard and change things to match what you do. Keep things simple and copy what I have done for now.
This will get you set up to run the Basic Tools. For the more advanced stuff, please take a look at the YouTube video.
Step 2: Setting Up LioranBoard
These tools will not work without LioranBoard. I have tried to make life easy here by including a “Basic” set of tools that will give you the card rotator you are familiar with.
In order to get the tools into LioranBoard, copy DM Twitch Tools BASIC.ini to your LioranBoard Directory. When you are in the directory, go to the folder labelled LioranBoard Receiver(PC).
Copy the Dice Masters Twitch Tools into this folder. Once you are in this folder, look at you configs.ini files. There will likely be a couple of them listed in there, each of them named in numerical order. What you will need to do is look for the highest number listed in your directory. Rename the Dice Masters Twitch Tools file to “configsX.ini” where X is one number higher than your highest number currently in the directory.
In my example, the highest number config file I have is 7. When I rename the Twitch Tools, I would name it “configs8.ini” in order to install the deck into LioranBoard. Spark up LioranBoard and if you have done everything correctly, you will see a deck named “DM Twitch Tools BASIC“.
Step 3: Using Your Scenes In OBS
You have made your Scenes in OBS and have Lioranboard working. Now we want to bounce back to OBS for a minute to set up the scenes. We will stick with those basic Scenes that were created in Step 1, although there will be some more advanced options in the YouTube video.
Consider the [NS] [DM] Player 1 Team and [NS] [DM] Player 2 Team Scenes as your main data Scenes. Try to leave these alone and duplicate them when you want to do something else with them. Since you have already done this and created [NS] [DM] Player 1 Team Rotator and [NS] [DM] Player 2 Team Rotator earlier, let’s quickly explain how you are going to get the card rotator onto your Stream.
Remember the whole “nested scene” thing that I mentioned earlier? Now is when this comes into play. A nested scene is basically a different type of Source that can be used in a new Scene in OBS. It will point back to the original scene and any changes you make in that will automatically be reflected in any other Scenes where this one is nested. I am not sure that makes sense written out, but check out the video for some clarification.
To set up the nested scene, go to your Player 1 Stream Scene and add a new Source. Here, you will select “Scene” and select [NS] [DM] Player 1 Team Rotator and place it where it works best for you. You can change the size to suit your overlay. Do the same thing for Player 2. If you share both of these in the same Scene, then put both nested scenes there. Your set-up will determine what will work for you.
How To Use The Dice Masters Twitch Tools
When you click on the deck in LioranBoard, you should see something like this:
You do not need to do much with this, unless you want to change the commands that trigger different events. However, I will cover what these do for those interested. The top button (update player cards) is the brains behind the operation. Please do not mess with the coding in this button as you can easily break the tool if you do. The TEAM ROTATOR button is what actually cycles through the cards on the Teams. Again, you do not need to change things here. It functions automatically. The START and STOP ROTATOR buttons are pretty obvious in that they control how to start and stop the cards from cycling. You really do not need to do anything with these buttons, but feel free to explore them if you want to learn how they work.
IMPORTANT!!!! YOU WILL NEED TO MAKE ONE CHANGE TO THE CODE IN THE ROTATOR. PLEASE CHECK OUT THE VIDEO FOR THE DETAILS ON HOW TO CHECK YOU HAVE THE CORRECT BUTTON PROGRAMMED. OTHERWISE, THESE TOOLS MAY NOT WORK.
For those that do not want to go code diving, let’s look at what you need to do in Twitch in order to make this all work.
Twitch Chat Commands
You need to enter the Teams for each player so the deck knows what cards to show. This could not be easier with these tools. In your Twitch chat, you (or your mods) can simply enter the following:
!player1 TEAMBUILDER LINK !player2 TEAMBUILDER LINK
If you have set up everything correctly, the images for these Teams will have been dumped into the Scenes you created in OBS. If they did not, something went wrong and take a few steps back to see if something got missed. The nice thing about these commands is you can change teams on the fly with a simple cut and paste of your Team Builder link. This is incredibly useful for those that stream live tournaments where Teams will be changing from round to round.
Now that the Team images are working, you want to start your card rotator. Again, this is super easy by using the following command in your chat:
The cards should now cycle staying on screen for 5 seconds before moving onto the next one. At the end of your stream (or whenever you want) you can stop the rotator by entering the following command in your chat:
The cards will finish one last cycle after this command is entered. Then they will disappear from your screen. If you want to start it up again, just enter the start command again.
That’s it. From here you can let your creativity flow and make changes to your OBS scenes that fit your stream style the best. In the YouTube video above, I will cover some of the things I have set up with the tools to give you some ideas.
For those who are interested in the Advanced Tools, you can check out a preview of the deck here:
I won’t go into the functions of this deck in this article, but if there is enough demand for it I will consider writing it up. It all runs off of the same principles as the Basic Tools… it just does more.
These tools are free to use for the Dice Masters Content Creators out there. If you have any questions about the tools, please get in touch with me and I will do my best to help you out. If you find any bugs (I have done my best to search them out myself) please let me know. Your feedback is always appreciated. These tools will only get better with Community involvement.
A huge thank you needs to go out to Trubie and the Team at the Dice Coalition for maintaining the Team Builder and making this tool possible. Also a huge thank you to Melonax from the Lioranboard Discord for doing the heavy lifting on the programming of the main button.
Thanks for reading through this slog of an article. I know it has not covered everything, and hopefully the accompanying YouTube video will help fill in some of the blanks. Please let me know if you find these helpful for your content.
As always… thanks for reading