THRONE HOLDER

5.0(1)

Turn your stream into a battlefield. One viewer defends the throne while the rest of chat attacks with subs, cheers, and donations to claim the top spot.

Includes loyalty points and XP rewards
Supports all kind of Twitch & YouTube events
Includes roleplay elements like leveling, buffs, debuffs, crit and healing.
Extremely customizable

Quick Access

Copy what you need to get started. Follow the setup guide below for detailed instructions.

Action Import String

Import the actions into Streamer.bot.

U0JBRR+LCAAAAAAABAB1k99P2zAQx9+R+B9MXnghVdu1he1lQqCxPUybQNo0AQ8X+5pa+EfmH5QI9X+fndRpDV2kRPF9vnc+351fj48IKSQ6KD6R17gISwUSw7L4oz2xXIiW1FpbPCnOtgLwbqVNlDhYS8ABPKOxXKtIJqPxaDwAhpYa3rgBkmutTh2humkJd0T78C6JWyG5/vF9RH6vgDFoIVi4euLq9PMJmSYniwKpI6BY539GvMXO9aG4ivG+yUYb91CQyjsXNtxLW996dUm3aSgvRGKSKy69/DUcIMLINp2iYJCVCLoYNljuewtJqMOcxVOen1O6vFjQks6BlbPJgpXVbPyxpLNZVU3nbDG/WKTkOre/Hn1X+fH2KQ980pN5ooJKYNzVGY8ZeaHCM/xitPzKrdOmDaIlCPs/1U9UjKv6kCoNxl03FDfZUHSC2mjfREVmBbGG1obKH4ppQhu1HHryjlOtqDcGlTtEneF1HXoWG/G4D6yvLnc9eswjCgGNRXYTs+15wpv+J+n7jmQhgruUIefcuMbKavqE7g7N85t8dvBK8HCOHDouk35v3HYXafqht+BLHGpksUXpfk36Mr8f3v72lSCaFQTV8dHmHwkvWlbpAwAA

Checking your access…

Other payment methods?

• Terms of Service • Cancellation Policy

Browser Source URL

Add this as a browser source to OBS.

https://tawmae.xyz/overlays/example

Checking your access…

Other payment methods?

• Terms of Service • Cancellation Policy

Setup Guide

Copy the Action Import String

Copy the Action Import text from Quick Access.

Import the actions into Streamer.bot

In Streamer.bot click Import in the top menu. Paste the text into the Import String field. Click Import at the bottom.

Enable the commands

Open the Commands tab. Find the imported group. Right-click the group and click Group → Enable All.

Run the Settings UI once

Open the action [THRONE HOLDER] [#] 0 - Settings. Right-click the Test trigger and hit Test Trigger to open the Settings UI once.

If the TawmaeUI.dll is missing, you’ll be asked to auto-download. That popup window may appear behind the Streamer.bot window, so make sure to check if nothing appears.

Start WebSocket Server

Go to the tab Servers/Clients → WebSocket Server. Enable Auto Start WebSocket Server. Address 127.0.0.1. Port 8080. Optional password. Leave Enforce All Requests unchecked. Start the server.

Copy Browser Source URL

Copy the Browser Source URL from Quick Access.

Add Browser Source in OBS

In OBS, create a new Browser Source, name it whatever you want. Then paste the copied URL into URL and set the Width and Height to your OBS canvas size (e.g. 1920x1080)

If you want to have the browser source in multiple scenes, don't create a second browser source. Instead, use nested scenes or source clones.

Done!

And you are done! You can not customize everything to your liking!

If you want to give it a test, simply rightclick the 'Test' trigger of any of the events of the '[THRONE HOLDER] [#] 1 - Handler' action.

Commands

User Commands

Command	Permission	Description	Example
!throneholderPoints [Points Amount] aka: !thPoints	Everyone	Uses loyalty points to contribute to damage or heal the throne holder.	!throneholderPoints 500
!throneholderStats [Username (optional)] aka: !thStats	Everyone	Posts the individual user stats into chat.	!throneholderStats tawmae
!throneholderLeaderboard aka: !thLeaderboard	Everyone	Posts the throne holder leaderboard into chat.	!throneholderLeaderboard

Mod Commands

Command	Permission	Description	Example
!setThroneholder [Username] aka: !setTh	Mods Only	Set or change the current throne holder.	!setThroneholder tawmae
!damageThroneholder [HP] aka: !damageTh	Mods Only	Damage the current throne holder by the specified HP amount.	!damageThroneholder 50
!healThroneholder [HP] aka: !healTh	Mods Only	Heal the current throne holder by the specified HP amount.	!healThroneholder 50

Settings UI

General

General settings like rewards and other goodies.

Next Throne Holder Selection
You can decide how the next throne holder is chosen.
VIP Throneholder
Decide whether to VIP the current throne holder. Once they lose the throne, they also lose their VIP status (obviously Twitch only).
Points Distribution
Requires the TWITCH POINTS extension to work. You can decide whether points are distributed and if so, what the total amount is and how it's being distributed.
Currency
Your target currency all donations and events like Super Stickers are converted to.
First Contributor Becomes Throne Holder
There are two cases where the throne is empty: on the first install and if someone donates and didn't enter their correct Twitch/YouTube username on the donation platform. In this case, you can either set a new boss with a command or have the first contributor become throne holder.

Damage

Manage the damage values for each event type and whether the event contributes at all.

Appearance

Change all kinds of appearance features of the overlay. Fonts, colors, animations and icons.

Rotator

The rotator is the text box below the actual throne holder element. It rotates through the specified texts that can include useful hints so your viewers know what to do. You can toggle the duration per text but also disable it completely.

Overlay Texts

Change the text elements of the overlay to either customize to your style or translate them.

Advanced Settings

Called advanced for a reason. Has some very detailed settings regarding XP and HP for balancing purposes. Also includes buff and debuffs chances per attack.

Chat Responses

Edit chat responses. Use a single hyphen to skip a message. Allows to use variables that are listed below each textbox. Reset to default by clicking the icon on the right.

Custom Triggers

Throne Holder New

Fires when a new user becomes the Throne Holder.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	1500
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	0
%roundTotalHealed%	int	Total HP healed for the boss in this round.	0
%newThroneHolderUserId%	string	The ID of the new throne holder.	12345678
%newThroneHolderUserName%	string	The display name of the new throne holder.	JohnDoe
%newThroneHolderLevel%	int	The starting level of the new throne holder.	5
%newThroneHolderMaxHp%	int	The max HP of the new throne holder.	1500
%newThroneHolderPlatform%	string	The platform of the new throne holder.	twitch
%newThroneHolderProfileImageUrl%	string	The avatar URL of the new throne holder.	https://...

Throne Holder Attacked

Fires when the Throne Holder takes damage.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder before the attack.	1000
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%attackerUserId%	string	The ID of the user who attacked.	87654321
%attackerUserName%	string	The name of the user who attacked.	JaneDoe
%damageDealt%	int	The actual amount of damage dealt to the boss.	50
%newHp%	int	The HP of the boss after taking damage.	950
%isCrit%	bool	Whether the attack was a critical hit.	true
%debuffsApplied%	string	Comma-separated list of debuffs applied during this attack.	Poison, Reduced Armor

Throne Holder Dodge

Fires when the Throne Holder successfully dodges an attack.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	1000
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%attackerUserId%	string	The ID of the user whose attack was dodged.	87654321
%attackerUserName%	string	The name of the user whose attack was dodged.	JaneDoe
%dodgeReason%	string	The reason for the dodge (e.g., 'buff' or 'level').	buff

Throne Holder Heal

Fires when the Throne Holder is healed.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder before healing.	500
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%healerUserId%	string	The ID of the user who healed the boss.	87654321
%healerUserName%	string	The name of the user who healed the boss.	JaneDoe
%healerPlatform%	string	The platform of the healer.	twitch
%healedHp%	int	The actual amount of HP restored.	100
%newHp%	int	The HP of the boss after healing.	600

Throne Holder Defeat

Fires when the Throne Holder's HP reaches 0 and is defeated.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	0
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%killerUserId%	string	The ID of the user who dealt the killing blow.	87654321
%killerUserName%	string	The name of the user who dealt the killing blow.	JaneDoe
%killerPlatform%	string	The platform of the killer.	twitch
%killingBlowDamage%	int	The raw damage value of the final attack before capping at current HP.	200

Throne Holder User Level Up

Fires when any user (boss or attacker) levels up from gaining XP.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	1000
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%levelUpUserId%	string	The ID of the user who leveled up.	87654321
%levelUpUserName%	string	The name of the user who leveled up.	JaneDoe
%levelUpUserPlatform%	string	The platform of the user who leveled up.	twitch
%newLevel%	int	The new level the user achieved.	6

Throne Holder Buff Applied

Fires when a buff or debuff is applied to the Throne Holder.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	1000
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%effectKey%	string	The internal system key of the effect.	critVuln
%effectName%	string	The formatted display name of the effect.	Crit Vulnerability
%effectType%	string	Whether the effect is a 'buff' or 'debuff'.	debuff
%durationSeconds%	int	How many seconds the effect will last.	60

Throne Holder Buff Worn Off

Fires when a buff or debuff expires or is cleared from the Throne Holder.

Variable	Type	Description	Example
%throneHolderUserId%	string	The ID of the current throne holder.	12345678
%throneHolderUserName%	string	The login name of the throne holder.	johndoe
%throneHolderUser%	string	The display name of the throne holder.	JohnDoe
%throneHolderProfileImageUrl%	string	The avatar URL of the throne holder.	https://...
%platform%	string	The platform of the throne holder (e.g., twitch, youtube).	twitch
%level%	int	The current level of the throne holder.	5
%xp%	float	The current XP of the throne holder.	1250.5
%maxHp%	int	The max HP of the throne holder.	1500
%currentHp%	int	The current HP of the throne holder.	1000
%roundStartedUnix%	int	Unix timestamp of when the current round started.	1711234567
%roundTotalDamageDealt%	int	Total damage dealt to the boss in this round.	5000
%roundTotalHealed%	int	Total HP healed for the boss in this round.	1200
%effectKey%	string	The internal system key of the effect.	poison
%effectName%	string	The formatted display name of the effect.	Poison
%effectType%	string	Whether the effect is a 'buff' or 'debuff'.	debuff

FAQ

What are the rewards?

The different reward types viewers can get are:

1. VIP for the current throne holder (Twitch only).
2. Loyalty Points (requires the TWITCH POINTS extension). Points distribution can be altered, either based on the last hit, equal to all contributors, weighted by damage dealt etc.
3. XP (increases HP, armor and dodge chance)

What buffs and debuffs are there?

Buffs:
1. Increased Armor - reduces incoming damage from all sources.
2. Crit Immunity - makes the throne holder immune to critical hits.
3. Increased Dodge Chance - the throne holder is able to dodge attacks.

Debuffs:
1. Poison - prevents the throne holder from healing.
2. Crit Vulnerability - makes the throne holder prone to critical hits.
3. Reduced armor - increases damage from all sources.

How are buffs and debuffs applied?

Each attack has a base chance to trigger a debuff on the throne holder. And each heal has a base chance to trigger a buff. But there are also the actions to trigger buffs and debuffs, in case you want to integrate them into something else. A good example would be items from the USER INVENTORY extension. It would allow people to use a Poison Vile to poison the throne holder.

I changed the appearance in the Settings UI, but it doesn't apply?

For the settings to apply, you need to hit the Save button.

How does healing work?

A throne holder that contributes with events like subs etc. will heal themself. So essentially everyone else contributing = damaging; throne holder contributing = healing. They heal themselves by the same amount as others damage. The only exception is a poison debuff that prevents healing.

If donations from 3rd party platforms can contribute, how do we know the Twitch/YouTube user?

That's the fun part, we don't! Some platforms have a setting that forces the platform username, but in some cases they won't match. If a user has a username on Kofi that doesn't match with their Twitch or YouTube username, and it happens to be the final blow, so they would theoretically become the new throne holder, then the throne will be empty instead. But if the username matches, it's all gucci.

What are levels doing?

The higher the level, the higher the HP, armor and dodge chance is. Increased armor lowers all incoming damage, dodge chance allows to complete negate an attack's damage.

Can I avoid that my permanent VIPs or temporary VIPs lose their VIP status after losing the throne?

Yes, temporary VIPs from my extension are being handled automatically. If they're a temporary VIP, they won't lose their badge.

As for your permanent VIPs: In the Advanced Settings tab of the Settings UI, you can scroll all the way down until you find the Excluded Group For VIPs setting. Add your permanent VIPs to a Streamer.bot group and select that group in the dropdown. The users in that group won't lose their VIP badge after losing the throne.

Changelog

v1.0.2 latest

2026-03-30

New: Added actions to manually show & hide the overlay
New: Added a duration slider to determine when the auto-hide triggers
Fix: Fixed an issue where if no eligible throne holder was found, the overlay didn't update correctly after a new throne holder was set

v1.0.1

2026-03-29

New: Added Command Aliases
New: Added 'VIP Excluded Group' to the Advanced Settings; allows to add a user group that keeps their VIP after losing the throne
New: Added that users with a temporary VIP status will not lose their badge after losing their throne
New: Added custom triggers
New: Added tracking for all contributions per user and added them to the 'Get Stats' command
Fix: Fixed an issue with loyalty points attacks going through after the boss has been defeated already
Changed: Adjusted some default settings values (leaderboard & stats one-message-per-rank to 'false'; increased armor and dodge gain for each level a little)

v1.0.0

2026-03-28

New: Release

User Reviews

5.0 (1 reviews)

Reviews

ForeverParm 3/31/2026

Tawmae has once again stirred up the competativeness in my chat with this amazing extension. They were holding on to thousands of loyalty points that they all threw down to see who could hold the Throne! Its also so very customizable that I can adjust any value on the fly as needed. HIGHLY reccomend this extension!