TWITCH ONLY DLL REQUIRED

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 1
MOD 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.

NoteIf 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

!setTitle [Title] Access Mods Only

Set a channel title.

Example!setTitle This is a super cool channel title | !sr !commands
!setGame [Game] Access Mods Only

Set the channel game/category.

Example!setGame Witcher 3
!addTag [Tag] Access Mods Only

Add a channel tag.

Example!addTag LGBTQFriendly
!removeTag [Tag] Access Mods Only

Remove a channel tag.

Example!removeTag Calm

Custom Commands

!addCommand [!command] [Command Text] Access Mods Only

Add a custom text command.

Example!addCommand !bluesky Check out my Bluesky profile: https://bsky.app/profile/tawmae.xyz
!editCommand [!command] [Command Text] Access Mods Only

Edit a custom text command.

Example!editCommand !bluesky Follow me on Bluesky: https://bsky.app/profile/tawmae.xyz
!removeCommand [!command] Access Mods Only

Remove a custom command.

Example!removeCommand !bluesky
!customCommands Access Everyone

Show all custom commands.

Example!customCommands

OBS Management

!scenes Access Mods Only

List all OBS scenes.

Example!scenes
!setScene [Scene Name] Access Mods Only

Set a specific OBS scene by name or index.

Example!setScene Gaming
!refreshAudio Access Mods Only

Refresh all OBS Application Audio Capture sources.

Example!refreshAudio
!refreshBrowserSources Access Mods Only

Refresh all OBS Browser Sources.

Example!refreshBrowserSources
!endStream Access Mods Only

End the stream (double-confirmation required).

Example!endStream

Chat Management

!shoutout [Username] Access Mods Only

Post a shoutout in chat.

Example!shoutout tawmae
!translate [Text] Access Everyone

Translate a given text. Works as a reply too.

Example!translate Hallo, guten Tag.
!runAds [User] [Duration] Access Mods Only

Run an ad for 30–180 seconds. Defaults to 180.

Example!runAds 120
!prerollTime Access Mods Only

Post remaining preroll-ad-free time.

Example!prerollTime
!snoozeAd Access Mods Only

Snooze the next upcoming ad.

Example!snoozeAd
!skipTTS Access Mods Only

Skip currently playing TTS in Speaker.bot.

Example!skipTTS
!modCommands Access Everyone

Send this website's commands tab into chat.

Example!modCommands
!pin [Message] Access Mods Only

Pin a message in the chat. Note: Also works if you reply to a message with just '!pin' and it will then pin the message you replied to.

Example!pin This is an important message!
!unpin Access Mods Only

Unpin the pinned message.

Example!unpin

URL Filter

!permit [User] Access Mods Only

Permit a user to post links for a limited time.

Example!permit tawmae
!addURL [URL] Access Mods Only

Add a link to the whitelist.

Example!addURL twitch.tv
!removeURL [URL] Access Mods Only

Remove a link from the whitelist.

Example!removeURL twitch.tv
!urlAddUser [Username] Access Mods Only

Whitelist a user for URLs.

Example!urlAddUser tawmae
!urlRemoveUser [Username] Access Mods Only

Remove a user from the URL whitelist.

Example!urlRemoveUser tawmae
!urlFilter Access Mods Only

Toggle the URL filter on/off.

Example!urlFilter
!whitelistedURLs Access Everyone

Show all whitelisted URLs.

Example!whitelistedURLs

Bot & Hate Raid Protection

!enableFollowAttackProtection Access Mods Only

Enable follow bot attack protection.

Example!enableFollowAttackProtection
!disableFollowAttackProtection Access Mods Only

Disable follow bot attack protection.

Example!disableFollowAttackProtection
!removeBottedFollowers Access Mods Only

Remove botted followers from a registered attack.

Example!removeBottedFollowers
!removeLatestFollowers [Minutes] Access Mods Only

Remove all followers within the last X minutes. Double-confirmation required.

Example!removeLatestFollowers 15
!hateRaid Access Mods Only

Toggle hate raid protection.

Example!hateRaid

Spam Filter

!banWord [Word] Access Mods Only

Add a word to the blacklist.

Example!banWord asshat
!unbanWord [Word] Access Mods Only

Remove a word from the blacklist.

Example!unbanWord asshat
!toggleBlacklistedWordsFilter Access Mods Only

Toggle blacklisted-words filter.

Example!toggleBlacklistedWordsFilter
!toggleCapsProtection Access Mods Only

Toggle caps filter.

Example!toggleCapsProtection
!toggleEmoteProtection Access Mods Only

Toggle emote filter.

Example!toggleEmoteProtection
!toggleASCIIProtection Access Mods Only

Toggle ASCII filter.

Example!toggleASCIIProtection

Channel Point Rewards

!enableReward all / [Group] / [Reward] Access Mods Only

Enable all, a reward group, or a single reward.

Example!enableReward Hydrate
!disableReward all / [Group] / [Reward] Access Mods Only

Disable all, a reward group, or a single reward.

Example!disableReward Hydrate
!pauseReward all / [Group] / [Reward] Access Mods Only

Pause all, a reward group, or a single reward.

Example!pauseReward Hydrate
!unpauseReward all / [Group] / [Reward] Access Mods Only

Unpause all, a reward group, or a single reward.

Example!unpauseReward Hydrate
!rewardTitle [Reward] <New Title> Access Mods Only

Change reward title. Title must be in <>.

Example!rewardTitle Hydrate <Hydrate Me!>
!rewardPrompt [Reward] <New Prompt> Access Mods Only

Change reward prompt. Must be in <>.

Example!rewardPrompt Hydrate <Make me chug a glass of water.>
!rewardCost [Reward] <New Cost> Access Mods Only

Change reward cost. Must be in <>.

Example!rewardCost Hydrate <500>
!rewardCooldown [Reward] <New Cooldown> Access Mods Only

Change cooldown in seconds. 0 disables. Must be in <>.

Example!rewardCooldown Hydrate <300>
!rewardMaxPerStream [Reward] <New Max> Access Mods Only

Change max redemptions per stream. 0 disables.

Example!rewardMaxPerStream Hydrate <10>
!rewardMaxPerUserPerStream [Reward] <New Max> Access Mods Only

Change max redemptions per user. 0 disables.

Example!rewardMaxPerUserPerStream Hydrate <3>

Polls & Predictions

!createPoll [Title] | [Duration] | [Option 1] | ... Access Mods Only

Create a Twitch poll. Duration optional (seconds).

Example!createPoll What should we play next? | 180 | Borderlands 4 | The Witcher 4 | Resident Evil 9 | Alien Isolation 2
!endPoll Access Mods Only

End active Twitch poll.

Example!endPoll
!createPrediction [Title] | [Duration] | [Option 1] | ... Access Mods Only

Create a Twitch prediction.

Example!createPrediction Will we survive until 6 PM? | 180 | Yes | No
!lockPrediction Access Mods Only

Lock the active prediction.

Example!lockPrediction
!resolvePrediction [Option Title / Number] Access Mods Only

Resolve prediction by title or option number.

Example!resolvePrediction Yes
!cancelPrediction Access Mods Only

Cancel the current prediction.

Example!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

v2.0.8 latest

  • New Added '!pin' command to pin messages. Works with '!pin [Message]' or with replying with '!pin' to a message.
  • Removed Removed '!ban' and '!timeout' commands since Twitch introduced Lead Moderators
  • New Added '!unpin' command to unpin the current pinned message

v2.0.7

  • Changed If BETTER SHOUTOUTS exist, command and raid shoutouts from the MOD TOOLS will be skipped
  • Changed Bumped required DLL to v.1.7.8

User Reviews

5.0 (5 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 :)

Before you post your review

Please make sure this is not a support issue. If you have trouble getting it to work, join my Discord, open a support post and attach your logs.

Join the Discord for support ↗