TWITCH ONLY OBS DOCK DLL REQUIRED

Keep the bots out and your chat in check. Link and spam filters, follow bot and hate raid protection, plus one dock to manage your Twitch stream. Powered by Streamer.bot.

  • Catch spam bots, disguised links, caps, emote spam and blacklisted words
  • Deal with follow bot attacks and hate raids
  • Keep an eye on suspicious users and look up their chat history
  • Manage stream info, polls, predictions, rewards and custom commands in one dock
MODERATION TOOLS dock overview

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…

OBS Dock URL

Add this as a custom browser dock in OBS.
https://tawmae.xyz/overlays/moderation-tools-dock

Setup Guide

1

Copy the Action Import String

Copy the Action Import String from Quick Access above.

2

Import the actions into Streamer.bot

In Streamer.bot, click Import in the top menu. Paste the text into the Import String field and hit Import.

3

Open the Settings UI

Open the action [MODERATION TOOLS] #0 - Settings. Right-click its Test trigger and hit Test Trigger. Pick the filters and protection you want, then hit Save. The extension already runs on its defaults after the import, so you can come back and change things whenever you like.

NoteRequires TawmaeUI.dll 1.8.8 or newer. If it is missing or outdated, the Settings action will offer to download it. Check behind Streamer.bot if the popup does not appear.
4

Enable the commands you want to use

In the Commands tab, find the imported commands and enable !game and !title. Set their permissions to Moderators. Permissions and cooldowns are managed on the commands in Streamer.bot.

5

Start the WebSocket Server

Go to Servers/Clients → WebSocket Server. Enable Auto Start WebSocket Server, use 127.0.0.1 and port 8080, then start the server. Leave Enforce All Requests unchecked.

6

Add the dock to OBS

Copy the OBS Dock URL from Quick Access. In OBS, go to Docks → Custom Browser Docks, give it a name and paste the URL. Hit Apply and put the dock wherever you want.

Using a different WebSocket address, port or a password? Add ?address=127.0.0.1&port=8080&password=YOUR-PASSWORD to the URL and adjust the values to match your server. Leave out the password part if you do not use one.

7

Done!

Your moderation tools are ready :) Keep Streamer.bot running and use the dock to manage things while you stream.

OBS Dock

Stream Info

Change your title, search for a category and manage tags without leaving OBS. Ads, snoozes and pre-roll free time are right there too, along with your pinned message, raids and shoutouts.
Stream Info tab with title, category, tags and ad controls

Filters

Toggle the link, word, caps, emote and ASCII filters. Manage allowed sites and users, give someone a temporary link permit or edit your blacklisted words. The word list stays blurred until you choose to show it.
Filters tab with filter toggles, allowed links and users

Bots & Raids

Turn follow bot and hate raid protection on or off, check the last attack and its accounts, and manage chat modes or Shield Mode. You can clear chat and skip TTS from here too.

The tab pulses red when a follow burst needs your attention and shows a yellow flag while protection is on.
Bots and Raids tab with protection and chat controls

Sus Users

Young accounts and first-time chatters show up with their first message. Open their chat log, purge, timeout, ban or unban them, or use Twitch's monitor, restrict and trust options. Dismiss anyone you have already checked.

The badge counts users you have not looked at yet and clears when you open the tab. Being on the list does not mean someone is a bot.
Sus Users tab showing accounts to review and moderation controls

Polls

Polls and predictions each have their own panel with live results. Start a new one, end a poll, lock a prediction, pick the winning outcome or cancel it.
Polls tab with poll and prediction panels

Rewards

Manage your channel point rewards by group. Show, hide, pause or unpause them, and edit titles, prompts, costs, cooldowns and limits.

Twitch only lets the app that created a reward change it. Rewards created outside Streamer.bot can be viewed here, but cannot be edited.
Rewards tab with grouped channel point rewards

Commands

Add, edit and delete custom commands directly in the dock. Each one keeps its own response, permissions, cooldowns and counter, so you do not need to create a separate Streamer.bot action for it.
Commands tab with custom command settings

Followers

Load followers from the last few minutes or choose a time range. Tick the accounts you want to remove and confirm. A progress display and stop button let you keep track while it runs.
Followers tab with time range filters and removal controls

Chat Log

Search for a chatter to see their account age, follow, subscription and ban status, then browse their messages by date or search term. Deleted messages are marked, and moderation controls are right next to the profile.

The log is stored locally, so it only contains messages recorded while Streamer.bot and Keep A Chat Log were running.
Chat Log tab with chatter profile, message history and moderation controls

Settings UI

General

The everyday chat stuff.

  • Chat replies Send command responses as replies to the message that used them.
  • Shared chat Leave messages from other channels alone. Those viewers cannot use your custom commands either.
  • Offline chat Turn on emote-only when you go offline and turn it off again when you go live.
  • Translation language Choose the language for translated messages.

Link Filter

Decide who can post links and which sites are always allowed.

  • Block links Remove links from viewers who are not allowed to post them, with an option to catch disguised links too.
  • Allowed sites & viewers Keep a list of allowed sites and choose whether VIPs, subscribers or people who have followed long enough can post links.
  • Permits & consequences Set how long a temporary permit lasts, whether to warn the viewer and whether to time them out.

Spam Filter

A few filters to keep chat readable.

  • Blacklisted words Add words or phrases to block. Disguised spellings and stretched letters are caught too. Choose what happens to the message and whether to replace the bad words.
  • Caps, emotes & ASCII Set caps and emote limits, filter text art and choose the consequence.
  • Exceptions Choose whether VIPs and subscribers skip the spam filters, and set the timeout duration.

Bot Protection

For the cheap viewers bots and the ones that all decide to follow at once.

  • Spam bots Ban sale and scam bots based on their first message. Built-in rules are included.
  • Follow bot attacks Choose how many follows within how many seconds count as an attack. Turn protection on automatically or handle it from the dock.
  • During an attack Disable selected actions, clear and pause queues, pause rewards, stop Speaker.bot or hide browser sources. Only things changed by the protection are restored afterwards.
  • After an attack Set how long things need to stay quiet before protection turns off, and whether followers from the attack should be removed.

Hate Raids

Pick what should happen when you turn on hate raid protection in the dock.

  • Chat Clear chat, enable followers-only, slow mode, subscribers-only or emote-only, or turn on Twitch Shield Mode.
  • Streamer.bot & OBS Pause rewards, stop Speaker.bot, hide browser sources and choose actions or queues to put on hold.
  • Restore afterwards Turning protection off restores what it changed. Anything still needed by follow bot protection stays on hold until that ends too.

Raids & Shoutouts

A little help welcoming people in and sending your own chat off.

  • Incoming raids Greet raiders, limit greetings to channels you follow, set a minimum viewer count and snooze the next ad.
  • Shoutouts & raid messages Choose whether to send the Twitch shoutout and set up your outgoing raid messages.
  • BETTER SHOUTOUTS If BETTER SHOUTOUTS is installed, it handles shoutouts and raid greetings so they do not fire twice.

Monitoring

Keep an eye on new chatters and look up what people said earlier.

  • Suspicious users Choose how young an account has to be to appear in the dock, and whether to include first-time chatters.
  • Chat log Save messages locally in your Streamer.bot folder. Set how long to keep them or clear the log from here.
  • Streamer.bot 1.0.7 Keep the chat log on for the first-time chatter fallback in this version. It needs enough history to tell a newcomer from a regular, so a fresh log will not catch every spam bot yet.

Chat Tools

Defaults for polls, predictions and the lists your viewers can see.

  • Polls & predictions Set their default durations.
  • Command & scene lists Show only custom commands the viewer is allowed to use, and choose which OBS scenes to hide from the scene list.

Chat Responses

Make the bot sound like your bot.

  • Customize responses Edit chat messages and moderation reasons. The available variables are shown under each field.
  • Disable a response Enter a single hyphen (-) to keep that response quiet.
  • Reset Reset individual responses or all of them, then save the window to keep the changes.

Commands

!game Access Mods Only

Change the Twitch category. Put the category name after the command.

Example!game Just Chatting
!title Access Mods Only

Change the stream title. Everything after the command becomes the new title, up to 140 characters.

Example!title Definitely a professional stream
!addCommand <!command> <text> Access Mods Only

Add a new custom command with the specified name and response.

Example!addCommand !discord discord.gg/yourserver
!deleteCommand <!command> Access Mods Only

Delete an existing custom command.

Example!deleteCommand !discord
!translate <message> Access Mods Only

Translate a message to another language. You can also reply with '!translate' to a specific chat message to translate it. The target language is set in the Settings UI.

Example!translate Hello, how are you?

FAQ

How do I create commands for my moderators?

Most controls live in the dock now, so importing the extension does not fill Streamer.bot with 10,000 actions. If your mods need something as a chat command, you can make one for the method you want.

  1. Create a new Action in Streamer.bot and give it a name you will recognize.
  2. Create your command in the Commands tab, enable it and set its permissions to Moderators. Set any cooldowns here too.
  3. Go back to your action, add a Core → Commands → Command Triggered trigger and pick the command you just created.
  4. Add a subaction: Core → C# → Execute C# Method.
  5. Pick MODERATION TOOLS Handler as the code, then choose the method you want from the method dropdown. There are plenty to choose from :)
  6. Save, then test the command in your Twitch chat.

For example, pick SetTitle for a !title command. A moderator can then type !title Definitely a professional stream to change the stream title. Everything after the command is passed to the method automatically. If you already have !title, edit that command and its action instead of creating a duplicate.

Keep permissions on the command, the method itself does not decide who is allowed to use it.

Do simple text commands need their own action?

Nope. If you only want the bot to post a response or keep a counter, use the dock's Commands tab. Those custom commands have their own text, permissions and cooldowns, and do not need a separate Streamer.bot action.

The action and Execute C# Method setup above is for controls that do something, like changing the stream title.

Why does the dock not connect to Streamer.bot?

Make sure Streamer.bot is running and its WebSocket Server is started under Servers/Clients → WebSocket Server. The dock uses 127.0.0.1 and port 8080 by default.

If you use a different address, port or a password, add them to the dock URL, for example ?address=127.0.0.1&port=8080&password=YOUR-PASSWORD. Leave out the password part if you do not use one, and leave Enforce All Requests unchecked in Streamer.bot.

If the dock connects but says the handler is missing or disabled, check that you imported the extension and enabled its handler action. If it says Streamer.bot did not answer, check that the handler still has its Trigger Custom Event subaction after the code, with %sbClientResponse% as the event name and Use Args enabled.

Can my moderators use the dock on their own PC?

The dock connects to your running Streamer.bot. Sending a moderator the dock URL alone will not connect them to your PC, 127.0.0.1 always means the PC opening it.

For mods working from their own PCs, create the chat commands they need using the guide above. They can then use those commands in your Twitch chat while your Streamer.bot handles them.

Why can I see a reward but not edit it?

Twitch only lets the app that created a channel point reward change it. Rewards created outside Streamer.bot can be viewed in the dock, but cannot be edited there.

If you want the dock to manage a reward, create it through Streamer.bot.

Why do some spam bots still get through?

Check that Ban Sale Bots and Ban Scam Bots are enabled under Bot Protection. These checks look for known patterns, so they will not catch every possible message.

Streamer.bot 1.0.7 also has an issue with identifying first-time chatters. In that version, MODERATION TOOLS uses the chat log as a fallback. Keep Monitoring → Keep A Chat Log on and let it build up some history. A fresh log cannot reliably tell an older account from a regular who just has not chatted recently, so the extension leaves it alone when it is unsure.

Clearing the chat log or turning it off and on resets that history. The Streamer.bot log tells you why a matching message was left alone.

Where is the chat log stored, and can I clear it?

The chat log stays on your PC, in tawmae - MODERATION TOOLS - Chat Log inside your Streamer.bot folder. It only contains messages recorded while Streamer.bot and Keep A Chat Log were running.

Under Settings UI → Monitoring, choose how long messages are kept or use Clear Chat Log to delete the saved messages and chatters. Clearing it also resets the history used for the first-time chatter fallback on Streamer.bot 1.0.7.

Changelog

v1.0.0 latest

  • New Release

User Reviews

5.0 (1 reviews)

This is a must-have for streamers. Adding the Dock in OBS instantly levels up your workflow.

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 ↗