Balloon Hangman Game
Thanks for downloading our widget!
Here you will find instructions on how to set everything up and an in-depth description of its possibilities.
⚠️ Take note: This widget is hosted on StreamElements and works only with StreamElements donations — make sure you have a StreamElements account before setting it up!
Widget Installation
- Log in to StreamElements with your Youtube or Twitch account
- Go to the “2. Widget” folder in the package you’ve downloaded
-
Pick the file that corresponds to your streaming platform (Twitch or YouTube) and double-click to install it.
Voila! Your widget is installed!
Widget Customization
-
Pick your widget in your StreamElements dashboard and click “Edit”
-
Click on “Layers” and go to your widget.
- Go to the “Settings” tab
- Woohoo, here you can customize everything to your taste :)
⚠️ IMPORTANT
For all of your customizations to take effect, you need to press "Save" in the top right corner of the editor and refresh the page before adding the widget to your streaming software!
Customization Fields
⚙️ Behavior Settings
| Name | Rewritten Description |
|---|---|
| Difficulty | Select the difficulty level of words and phrases (Easy, Medium, Hard, or Mixed). |
| Language | Choose the language for the game pool (supports 9+ languages). |
| Game Mode | Choose between Words Only, Phrases Only, or a Mixed variety. |
| Max Lives (Wrong Guesses) | Set the number of allowed wrong guesses (3 to 10) before a game over. |
| Worried Threshold | Set the number of balloons remaining when the character transitions to a 'worried' animation. |
| Win/Lose Screen Duration | Set how many seconds the result screen stays visible before the next game starts. |
| Cooldown Between Guesses | Adjust the minimum wait time between consecutive chat guesses. |
| Max Queue Length | Limit the number of chat commands waiting to be processed (0 to 200). Set to 0 for unlimited queueing. |
| Testing Mode | Enable an automatic, infinitely looping demo mode for demonstration. |
📁 Commands & Permissions
| Name | Rewritten Description |
|---|---|
| Start/Stop Command | Customize the chat command used to begin or end a game session. |
| Guess Letter Command | Set the command prefix your chat must use to guess a letter. |
| Solve Word/Phrase Command | Set the command prefix used for full word or phrase solution attempts. |
| Who Can Start/Stop Games | Restrict game management to specific roles (Owner, Moderators, etc.). |
| Who Can Guess | Set the minimum requirement (Everyone, Subscribers, etc.) to participate. |
| Bot Blocklist | List bot usernames to ignore, ensuring they don't interfere with gameplay. |
🎨 Design Settings
| Name | Rewritten Description |
|---|---|
| Font Family | Stick with the default or pick a custom Google Font for all widget text. |
| Accent Color | Primary color for the binder clip, command banner, and revealed wrong letters. |
| Paper Background | Choose a custom background color for the notepad surface. |
| Notebook Lines (Ruled) | Adjust the color of the horizontal ruled lines on the paper. |
| Margin Line (Vertical) | Customize the color of the vertical margin line. |
| Revealed Letter Color | Choose the color for correctly guessed and revealed letters. |
| Underscore / Dash Color | Set the color for the letter slots and word separators. |
| Category Pill Border | Choose a border color for the category label at the top. |
| Category Pill Text | Select a text color for the category label. |
| Command Banner Background | Pick a background color for the instruction banner at the bottom. |
| Command Banner Text Color | Select a text color for the instruction banner at the bottom. |
| Widget Scale (%) | Adjust the overall size of the widget (50% to 150%) to fit your layout. |
🐱 Character Settings
| Name | Rewritten Description |
|---|---|
| Appearance | Select your character (Cat, Dog, Bunny, Bear) or choose "None" for text-only play. |
| Body Color | Customize the primary skin/fur color of your chosen character. |
| Shadow Color | Set the color for character shadows and secondary details. |
| Blush Color | Change the color of the character's rosy cheeks. |
| Strokes & Eyes | Set the color for the character's outlines, eyes, and facial features. |
| Balloon Color 1 | Customize the color of the first balloon attached to the character. |
| Balloon Color 2 | Customize the color of the second balloon attached to the character. |
| Balloon Color 3 | Customize the color of the third balloon attached to the character. |
| Character Position X | Fine-tune the horizontal position of the character wrapper. |
| Character Position Y | Fine-tune the vertical position of the character wrapper. |
General tips:
- Keep file sizes moderate to avoid stutter during reveals (optimize PNGs/JPGs).
- Use consistent aspect ratio across the entire set for the cleanest grid layout.
⚠️ IMPORTANT
For all of your customizations to take effect, you need to press "Save" in the top right corner of the editor and refresh the page before adding the widget to your streaming software!
How to Add it to the Streaming Software?
OBS Studio
- Copy the URL of your Widget from the StreamElements dashboard
- Open OBS Studio
- Click “Add Source” (plus icon) in the Sources section.
- Add a “Browser” source, give it a name, and press “Ok”
- Paste the URL you’ve copied
- Set the width to 1920 and the height to 1080
- Press “Ok” and we’re done!
Streamlabs Desktop
- Copy the URL of your Widget from the StreamElements dashboard
- Open Streamlabs Desktop
- Click “Add a new Source” (plus icon) in the Sources section.
- Choose “Browser Source”, give it a name, and press “Add Source”.
- Paste the URL you’ve copied previously
- Set the width to 1920 and the height to 1080
- Now press “Close” and that’s it! Your widget is ready to use!