TWITCH ONLY Designed specifically for Twitch. Not compatible with other platforms. DLL REQUIRED This extension requires a .dll file (TawmaeUI.dll) in your Streamer.bot directory. On your first setup, it will ask to auto-download. You can download it manually at tawmae.xyz/dll.

MOD TOOLS

5.0(5)

An all-in-one solution to moderate your Twitch streams with Streamer.bot. Prevent spam bots, deal with follow bot attacks and hate raids - and give your mods handy tools to manage your stream.

  • Bot Protection
    • Detect 'Cheap Viewers' bots and follow bot attacks
  • URL Filter
    • Block links, maintain a whitelist, permit users
  • Spam Filter
    • Blacklist words, filter ASCII, emote- and caps spam
  • Channel Management
    • Manage title, category, rewards, polls and predictions
  • Custom Commands
    • Quickly add commands or counters via chat
  • OBS Control
    • Change scenes, refresh sources or emergency-stream-end
MOD TOOLS Showcase 1MOD TOOLS Showcase 2

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.
Loading…

Setup Guide
1

Copy the Action Import String

Copy the Action Import text from Quick Access.

Copy the Action Import String
2

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.

Import the actions into Streamer.bot
3

Enable the commands

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

Enable the commands
4

Open the Settings UI once and hit Save

Open the action [MOD TOOLS] [#] 1 - Settings. Right-click the Test trigger and hit Test Trigger. Click Save.

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.
Open the Settings UI once and hit Save
5

Done!

You can now customize everything to your liking!

Settings UI

General

Configure core behavior such as reply style, shared chats, emote-only behavior and translation language.

  • Post Messages As Replies
    Toggle whether chat responses are posted as replies or regular chat messages. Also allows whispering commands to broadcaster/bot and receiving whisper responses.
  • Ignore Shared Chats
    Ignore commands and messages coming from shared chats that are not originating from your own channel.
  • Emote-Only On Stream End
    Automatically enable emote-only mode when the stream ends and disable it again once you go live.
  • Translation Language
    Choose the target language for the !translate command from a list of supported languages (English, German, French, Spanish, etc.).
General settings

URL Filter

Toggle and customize your URL filter, whitelist URLs and users, and define consequences for unpermitted links.

  • Block Links
    Prevent links from being posted to chat unless they are explicitly whitelisted or the user is allowed.
  • Whitelisted URLs
    Add base URLs that are allowed to be posted by anyone (e.g. twitch.tv, youtube.com). Also manageable via commands.
  • Permit Duration
    Configure how long (in seconds) a !permit [User] lasts, during which the user can post links.
  • Allow VIPs
    Let VIPs post links without being blocked by the URL filter.
  • Allow Subscribers
    Let subscribers post links without being blocked by the URL filter.
  • Allow Followers
    Allow followers with a minimum follow age in days to post links. 0 disables the min-follow requirement.
  • Warn User
    Post a warning message to users who post unpermitted links. Ignored if timeout is enabled as well.
  • Timeout User
    Optionally timeout users for a configurable duration when they post unpermitted links.
  • Whitelisted Users
    Add specific usernames that are always allowed to post links, regardless of other URL filter rules.
URL Filter settings

Bot Protection

Protect your channel from spam bots and follow bot attacks, and configure automatic countermeasures.

  • Ban Sale Bots
    Automatically ban bots trying to sell viewers or similar services in their first message.
  • Ban Discord Bots
    Automatically ban bots that ask to be added on Discord in their first message.
  • Auto-Enable Follow Attack Protection
    Automatically enter protective mode once a follow bot attack is detected.
  • Remove Botted Followers
    Automatically remove botted followers while follow attack protection is active.
  • Protective Mode Duration
    Set how long (in seconds) the follow attack protective mode stays active once enabled.
  • Actions To Disable
    Select actions (e.g. follow alerts) that are disabled during a follow bot attack.
  • Action Queues To Pause
    Select action queues that will be cleared and paused during a follow bot attack.
  • Pause All Channel Rewards
    Pause all Streamer.bot-owned channel point rewards for the duration of the attack.
  • Clear TTS
    Clear the TTS queue in Speaker.bot once a follow bot attack starts.
  • Disable All Browser Sources
    Disable all browser sources in OBS for the duration of the attack.
  • Follow Amount Threshold
    Number of follows that must occur within the configured time window to trigger protective mode.
  • Duration Threshold
    Time window in seconds during which the follow threshold must be met to trigger protective mode.
  • Send Data After Attack
    Send a list of known bot accounts from the attack to a public GitHub repository to improve global protection. Contains only bot data, no personal user data.
Bot Protection settings

Spam Protection

Handle suspicious users, blacklisted words, and caps/emote/ASCII spam with configurable consequences.

  • Suspicious Users Overlay
    Link to a browser/OBS dock to quickly moderate new chatters and accounts younger than 90 days via WebSocket.
  • Consequence
    Choose what happens on infringement: delete only, warn, timeout, or ban.
  • Timeout Duration
    Timeout duration (in seconds) used when 'Timeout' is selected as the consequence.
  • Bypass Moderators
    Ignore spam checks for messages sent by moderators.
  • Bypass VIPs
    Ignore spam checks for messages sent by VIPs.
  • Bypass Subscribers
    Ignore spam checks for messages sent by subscribers.
  • Filter Blacklisted Words
    Enable automatic filtering of messages containing blacklisted words.
  • Blacklisted Words
    Manage a list of words that will be filtered out of chat when detected.
  • Replace Bad Word
    Optionally repost the filtered message with the blacklisted word replaced by a placeholder such as [REDACTED].
  • Allow Moderators (Blacklisted Words)
    Let moderators use blacklisted words without their messages being filtered.
  • Allow VIPs (Blacklisted Words)
    Let VIPs use blacklisted words without their messages being filtered.
  • Caps Protection
    Toggle caps protection and set the allowed maximum of consecutive capital letters per message.
  • Emote Protection
    Toggle emote protection and set the allowed maximum number of emotes per message.
  • ASCII Protection
    Block chat messages that contain ASCII spam patterns.
Spam Protection settings

Hate Raid Protection

Configure how your channel reacts when you enable hate raid protection during a toxic or hostile raid.

  • Clear Chat
    Automatically clear the chat when hate raid protective mode is enabled.
  • Follower-Only Mode
    Automatically enable follower-only mode with a minimum follow duration in minutes when protection is enabled.
  • Sub-Only Mode
    Automatically enable sub-only mode when protection is enabled.
  • Emote-Only Mode
    Automatically enable emote-only mode when protection is enabled.
  • Slow Mode
    Automatically enable slow mode with a configurable interval in seconds.
  • Pause All Channel Rewards
    Automatically pause all Streamer.bot-owned channel rewards while hate raid protection is active.
  • Clear TTS
    Automatically clear all pending TTS requests in Speaker.bot when protection is enabled.
  • Disable All Browser Sources
    Disable all OBS browser sources while hate raid protection is active.
  • Actions To Disable
    Select actions that will be temporarily disabled during the protective mode.
  • Action Queues To Pause
    Select action queues that will be cleared and paused during the protective mode.
Hate Raid Protection settings

Raids & Shoutouts

Manage shoutouts as well as behavior for incoming and outgoing raids.

  • Send Twitch Shoutout
    Send the built-in /shoutout command in addition to the custom chat message. Requires you to be live and respects Twitch's 3-minute cooldown.
  • Snooze Ads On Incoming Raid
    Automatically snooze upcoming ads when a raid comes in, if snoozes are available.
  • Auto-Shoutout On Raid
    Automatically shout out incoming raiders when they raid your channel.
  • Followed Only Auto-Shoutout
    Restrict automatic shoutouts to raiders that you already follow.
  • Minimum Raid Viewers
    Only auto-shoutout incoming raiders if they bring at least this number of viewers.
  • Post Sub Raid Message
    Automatically post a preconfigured raid message for subscribers when you raid out.
  • Post Non-Sub Raid Message
    Automatically post a preconfigured raid message for non-subs when you raid out.
  • Post Sub Raid Message As Broadcaster
    Choose whether the sub raid message is posted as the broadcaster account or the bot account.
Raids & Shoutouts settings

Chat Management

Configure default durations for polls and predictions and behavior of custom commands.

  • Default Poll Duration
    Fallback duration (in seconds) used when a poll is created without an explicit duration.
  • Default Prediction Duration
    Fallback duration (in seconds) used when a prediction is created without an explicit duration.
  • Show Permitted Commands Only
    When listing all custom commands via !customCommands, only show commands the requesting user has permission to use.
Chat Management settings

OBS Management

Control how scenes are listed and manage scene exclusions for OBS-related commands.

  • Scenes In One Message
    If enabled, post all scenes in a single chat message; otherwise one scene per line for readability.
  • Whisper Scenes
    Send the list of scenes as a whisper instead of a public chat message. Falls back to chat if whispers fail.
  • Excluded Scenes
    Select scenes that should be excluded when listing or managing scenes via commands.
OBS Management settings

Super Moderators

Designate super moderators and restrict certain powerful features to them only.

  • Super Moderators
    Choose moderators that are granted super moderator status, allowing them to timeout and ban other moderators.
  • Channel Reward Management (Super Mods Only)
    Restrict channel point reward management to super moderators only.
  • OBS Management (Super Mods Only)
    Restrict OBS-related commands and management to super moderators only.
Super Moderators settings

Chat Responses

Customize chat responses for this extension. Allows disabling or overriding text for each event.

  • Per-Event Messages
    Edit the text for each chat response triggered by the extension's actions.
  • Disable With Hyphen
    Enter a single hyphen (-) as the message to disable that specific chat response entirely.
  • Reset To Default
    Use the reset icon next to each textbox to restore the default message for that response.
  • noMessage Argument
    Optionally suppress a single reply by setting a noMessage argument to True via a Set Argument subaction.
Chat Responses settings

Commands

Channel Management

Command Permission Description Example
!setTitle [Title]
Mods Only Set a channel title. !setTitle This is a super cool channel title | !sr !commands
!setGame [Game]
Mods Only Set the channel game/category. !setGame Witcher 3
!addTag [Tag]
Mods Only Add a channel tag. !addTag LGBTQFriendly
!removeTag [Tag]
Mods Only Remove a channel tag. !removeTag Calm

Custom Commands

Command Permission Description Example
!addCommand [!command] [Command Text]
Mods Only Add a custom text command. !addCommand !bluesky Check out my Bluesky profile: https://bsky.app/profile/tawmae.xyz
!editCommand [!command] [Command Text]
Mods Only Edit a custom text command. !editCommand !bluesky Follow me on Bluesky: https://bsky.app/profile/tawmae.xyz
!removeCommand [!command]
Mods Only Remove a custom command. !removeCommand !bluesky
!customCommands
Everyone Show all custom commands. !customCommands

OBS Management

Command Permission Description Example
!scenes
Mods Only List all OBS scenes. !scenes
!setScene [Scene Name]
Mods Only Set a specific OBS scene by name or index. !setScene Gaming
!refreshAudio
Mods Only Refresh all OBS Application Audio Capture sources. !refreshAudio
!refreshBrowserSources
Mods Only Refresh all OBS Browser Sources. !refreshBrowserSources
!endStream
Mods Only End the stream (double-confirmation required). !endStream

Chat Management

Command Permission Description Example
!shoutout [Username]
Mods Only Post a shoutout in chat. !shoutout tawmae
!translate [Text]
Everyone Translate a given text. Works as a reply too. !translate Hallo, guten Tag.
!timeout [Username] <Duration>
Mods Only Timeout a user. Duration optional, must use <>. !timeout tawmae <120>
!ban [Username]
Mods Only Ban a user. Reason optional. !ban tawmae
!runAds [User] [Duration]
Mods Only Run an ad for 30–180 seconds. Defaults to 180. !runAds 120
!prerollTime
Mods Only Post remaining preroll-ad-free time. !prerollTime
!snoozeAd
Mods Only Snooze the next upcoming ad. !snoozeAd
!skipTTS
Mods Only Skip currently playing TTS in Speaker.bot. !skipTTS
!modCommands
Everyone Send this website's commands tab into chat. !modCommands

URL Filter

Command Permission Description Example
!permit [User]
Mods Only Permit a user to post links for a limited time. !permit tawmae
!addURL [URL]
Mods Only Add a link to the whitelist. !addURL twitch.tv
!removeURL [URL]
Mods Only Remove a link from the whitelist. !removeURL twitch.tv
!urlAddUser [Username]
Mods Only Whitelist a user for URLs. !urlAddUser tawmae
!urlRemoveUser [Username]
Mods Only Remove a user from the URL whitelist. !urlRemoveUser tawmae
!urlFilter
Mods Only Toggle the URL filter on/off. !urlFilter
!whitelistedURLs
Everyone Show all whitelisted URLs. !whitelistedURLs

Bot & Hate Raid Protection

Command Permission Description Example
!enableFollowAttackProtection
Mods Only Enable follow bot attack protection. !enableFollowAttackProtection
!disableFollowAttackProtection
Mods Only Disable follow bot attack protection. !disableFollowAttackProtection
!removeBottedFollowers
Mods Only Remove botted followers from a registered attack. !removeBottedFollowers
!removeLatestFollowers [Minutes]
Mods Only Remove all followers within the last X minutes. Double-confirmation required. !removeLatestFollowers 15
!hateRaid
Mods Only Toggle hate raid protection. !hateRaid

Spam Filter

Command Permission Description Example
!banWord [Word]
Mods Only Add a word to the blacklist. !banWord asshat
!unbanWord [Word]
Mods Only Remove a word from the blacklist. !unbanWord asshat
!toggleBlacklistedWordsFilter
Mods Only Toggle blacklisted-words filter. !toggleBlacklistedWordsFilter
!toggleCapsProtection
Mods Only Toggle caps filter. !toggleCapsProtection
!toggleEmoteProtection
Mods Only Toggle emote filter. !toggleEmoteProtection
!toggleASCIIProtection
Mods Only Toggle ASCII filter. !toggleASCIIProtection

Channel Point Rewards

Command Permission Description Example
!enableReward all / [Group] / [Reward]
Mods Only Enable all, a reward group, or a single reward. !enableReward Hydrate
!disableReward all / [Group] / [Reward]
Mods Only Disable all, a reward group, or a single reward. !disableReward Hydrate
!pauseReward all / [Group] / [Reward]
Mods Only Pause all, a reward group, or a single reward. !pauseReward Hydrate
!unpauseReward all / [Group] / [Reward]
Mods Only Unpause all, a reward group, or a single reward. !unpauseReward Hydrate
!rewardTitle [Reward] <New Title>
Mods Only Change reward title. Title must be in <>. !rewardTitle Hydrate <Hydrate Me!>
!rewardPrompt [Reward] <New Prompt>
Mods Only Change reward prompt. Must be in <>. !rewardPrompt Hydrate <Make me chug a glass of water.>
!rewardCost [Reward] <New Cost>
Mods Only Change reward cost. Must be in <>. !rewardCost Hydrate <500>
!rewardCooldown [Reward] <New Cooldown>
Mods Only Change cooldown in seconds. 0 disables. Must be in <>. !rewardCooldown Hydrate <300>
!rewardMaxPerStream [Reward] <New Max>
Mods Only Change max redemptions per stream. 0 disables. !rewardMaxPerStream Hydrate <10>
!rewardMaxPerUserPerStream [Reward] <New Max>
Mods Only Change max redemptions per user. 0 disables. !rewardMaxPerUserPerStream Hydrate <3>

Polls & Predictions

Command Permission Description Example
!createPoll [Title] | [Duration] | [Option 1] | ...
Mods Only Create a Twitch poll. Duration optional (seconds). !createPoll What should we play next? | 180 | Borderlands 4 | The Witcher 4 | Resident Evil 9 | Alien Isolation 2
!endPoll
Mods Only End active Twitch poll. !endPoll
!createPrediction [Title] | [Duration] | [Option 1] | ...
Mods Only Create a Twitch prediction. !createPrediction Will we survive until 6 PM? | 180 | Yes | No
!lockPrediction
Mods Only Lock the active prediction. !lockPrediction
!resolvePrediction [Option Title / Number]
Mods Only Resolve prediction by title or option number. !resolvePrediction Yes
!cancelPrediction
Mods Only Cancel the current prediction. !cancelPrediction

OBS Docks

Streamer.bot WebSocket Requirements

For all docks to work, you need to enable the WebSocket server in Streamer.bot.
Go to the tab Servers/Clients → WebSocket Server and make sure:
  • Address is set to 127.0.0.1
  • Port is set to 8080
  • and the server is running.

User Chat Log

User Chat Log dock shows the latest chat messages of a specific user.
You can open it in a browser or dock it directly into OBS.
Because it relies on Streamer.bot, it only captures messages while Streamer.bot is running and connected to Twitch.
It also displays profile picture, account age, and user roles.
Docking URL: https://tawmae.xyz/overlays/mod-tools-user-chat-log
User Chat Log dock preview

Suspicious User Monitoring

Suspicious User Monitoring dock can be added directly to OBS as a browser dock.
It lists new chatters and accounts less than 90 days old and allows purge, timeout, or ban.
Useful for catching suspicious accounts early.
Docking URL: https://tawmae.xyz/overlays/mod-tools-user-monitoring
Suspicious User Monitoring dock preview

FAQ & Examples
Can I disable certain chat responses?
Yes. In the Settings UI under the Chat Responses tab, you can enter a single hyphen - as the message to disable that specific chat reply entirely.

You can also use a noMessage argument via a Set Argument subaction. If you set noMessage = True, the extension suppresses that one specific reply without disabling the entire configured message.

Changelog

No changelog entries yet.

User Reviews

5.0 (5 reviews)

Reviews

this guy does not miss, what a legendary collection of tools knowing exactly what streamers need, with incredible customization but also easy initial setup (that goes for basically everything here)

Very helpful! Coming from MIU, this really helped me get my bot into a more than usable state again. Thanks Tawmae!

To date, I have blocked over 20 bots in just a span of a month (in total) streaming! Now I have more time to make fun of them!

Must Have für jeden Stream! Habe mich solange gedrückt mich hin zu setzen und es einzurichten bereue jede Minute die ich ohne gestreamt habe :)