Automatically moderate Twitch chat with message filters
Your Twitch chat bot can remove any unwanted behavior from your Twitch chat, helping you create the community you want on Twitch.
Moobot offers several built-in message filters to make your life easier. Activate the filter and Moobot will remove its unwanted behavior automatically from your Twitch chat.
Follow these steps to activate a message filter:
- Open up the
«Moderation»
menu from the main menu, then open the«Message filters»
menu from there. - While in the
«Message filters»
menu activate the toggle button to the right side of the filter you want to activate. - Your message filter is now active in Twitch chat!
To adjust the settings of a message filter, click its «Settings»
button (found in the «Message filters»
menu.)
Built-in message filtersâ
You can fully adjust your built-in message filters to fit you and your community on Twitch.
To adjust how the filtering for a filter works, activate the «Show advanced options»
checkbox at the bottom of the settings menu, which will make the adjustable settings for the filter appear at the bottom of the menu.
Links filterâ
The links filter removes messages containing any links you haven't already pre-approved in your trusted links whitelist, or clips from Twitch channels which you haven't already pre-approved in your whitelist of clips from trusted Twitch channels.
Adjustable settings for the links filterâ
Setting | Description | Default |
---|---|---|
Remove messages containing IPs | Moobot will remove the message if it contains any IP addresses, to preserve the privacy of you and your viewers. | ON |
Remove messages containing 'dot com' variations | Moobot will remove the message if it contains any hidden links like «twitch dot tv» , «google dot com» , «twitchDOTtv/moobot» , etc. |
ON |
Excessive use of CAPS filterâ
The excessive use of CAPS filter removes messages containing excessive amounts of capital letters.
Adjustable settings for the excessive use of CAPS filterâ
Setting | Description | Default |
---|---|---|
Minimum characters in the message before filtering | (â) Moobot will only check the message for excessive use of capital letters when its length is equal to or greater than this value. | 15 |
Maximum percent of capital letters allowed | (â) Moobot will remove the message if the message or the user's display name (if activated) has a percentage of upper- compared to lower-case letters (not numbers or symbols) which is greater than this value. | 60% |
Check the username for excessive use of capital letters | Moobot will check the user's display name for «Maximum percent of capital letters allowed» . |
OFF |
(â) Emotes and links do not count towards the filter's values.
General spam filterâ
The general spam filter removes messages containing repeated letters, phrases or words, or other disruptive behavior.
Adjustable settings for the general spam filterâ
Setting | Description | Default |
---|---|---|
Minimum characters in a message before filtering | (â) Moobot will only check the message when its length is equal to or greater than this value. | 20 |
Remove messages containing excessively repeated words and/or characters | Moobot will remove the message if it contains an excessive use of repeating words and/or characters, like «spam this spam this spam this spam this» . |
ON |
Remove messages containing long words | (ââ) Moobot will remove the message if it contains a single word with a length greater than the value for «Maximum characters allowed in a word» . |
ON |
Maximum characters allowed in a word | The maximum characters in a word for the «Remove messages containing long words» setting. |
30 |
Remove messages spelled out with single-characters | Moobot will remove the message if it's constructed like e.g. «e x a m p l e» . |
ON |
Maximum allowed single-characters in spelled out messages | How strict the «Remove messages spelled out with single-characters» filtering should be. |
Standard |
Remove users trolling others | Moobot will remove the message if it's constructed like «type ... in chat for...» . |
OFF |
(â) The «Remove users trolling others...»
filtering is unaffected by the length of the message.
(ââ) Moobot will not treat links as words.
Symbols filterâ
The symbols filter removes messages containing disruptive or excessive use of symbols.
Adjustable settings for the symbols filterâ
Setting, excessive use | Description | Default |
---|---|---|
Minimum symbols in a message before filtering | Moobot will only check the message for excessive use of symbols when it contains an amount of symbols equal to or greater than this value. | 3 |
Maximum grouped symbols allowed in a message | Moobot will remove the message if it contains a grouping of symbols with a length greater than this value. | 8 |
Minimum characters in a message before filtering for percent of symbols | Moobot will only check the message for percent of symbols when its length is equal to or greater than this value. | 15 |
Maximum percent of symbols allowed in a message | Moobot will remove the message if its percentage of symbols is greater than this value. | 40 |
(â) Emotes and links do not count towards the filter's values.
Setting, unwanted use | Description | Default |
---|---|---|
Remove messages containing block symbols | Moobot will remove the message if it contains any special block symbols (commonly used to spam.) | ON |
Remove messages containing zalgo symbols | Moobot will remove the message if it contains any special zalgo symbols (commonly used to spam.) | ON |
Remove messages containing Moobot's blacklisted symbols | Moobot will remove the message if it contains any of Moobot's blacklisted symbols. | ON |
Large texts filterâ
The large texts filter removes lengthy messages.
Adjustable settings for the large texts filterâ
Setting | Description | Default |
---|---|---|
Maximum characters allowed in a message | Moobot will remove the message if its length is greater than this value. | 375 |
(â) Emotes do not count towards the filter's values.
Emotes filterâ
The emotes filter removes messages containing an excessive amount of emotes.
Adjustable settings for the emotes filterâ
Setting | Description | Default |
---|---|---|
Maximum amount of emotes allowed in a message | Moobot will remove the message if it contains an amount of emotes greater than this value. | 12 |
Number spam filterâ
The number spam filter removes messages containing excessive or undesirable use of numbers.
Adjustable settings for the number spam filterâ
Setting | Description | Default |
---|---|---|
Minimum characters in a message before filtering for percent of numbers | (â) (ââ) Moobot will only check the message when its length is equal to or greater than this value. | 15 |
Maximum percent of numbers allowed in a message | (â) Moobot will remove the message if its percentage of numbers is greater than this value. | 80% |
Remove messages containing just numbers | Moobot will remove the message if it only contains numbers. | OFF |
(â) Emotes and white-space do not count towards the filter's values.
(ââ) The «Remove messages containing just numbers»
filtering is unaffected by the length of the message.
Repeated messages filterâ
The repeated messages filter removes messages which are the same or very similar to messages recently posted by the same person.
By removing repeated messages you are potentially able to drastically reduce the duration of your Twitch chat's Slow Mode, as the negative effects of doing so will be handled by the filter.
Being able to reduce Slow Mode means your viewers will be able to interact with you more often, and keep their conversations flowing without pausing to wait for their Slow Mode to expire.
Adjustable settings for the repeated messages filterâ
Setting | Description | Default |
---|---|---|
Minimum characters in message before filtering | (â) Moobot will only check the message when its length is equal to or greater than this value. | 70 |
Maximum percent of similarity between messages allowed | (ââ) Moobot will remove the message if the calculated similarity-percentage between two messages it finds is greater than this value. | 90% |
(âââ) Amount of repeated messages allowed | Moobot will remove the message if it finds an amount of repeated messages greater than this value. | None (0) |
Message expiration time (in minutes) | Moobot will only check the message against other messages which have been sent within this expiration time. | 5 |
Exclude valid commands from filtering | Moobot will allow valid commands to be repeated when this option is activated. | ON |
(â) Emotes do not count towards the filter's values.
(ââ) Any emotes in the messages will be ignored when determining their similarity.
(âââ) By "repeated message" it means the first message must be found again. In other words, the 2nd message is the 'repeated message'. So if the value is set to «Allow a message to be repeated again once»
, it means the message will not be removed until the 3rd similar message is sent.
Special letters filterâ
The special letters filter removes messages containing excessive use of special letters like «ââ§âââââ»
.
Adjustable settings for the special letters filterâ
Setting | Description | Default |
---|---|---|
Maximum special letters allowed in a message | Moobot will remove the message if it contains an amount of special letters greater than this value. | 4 |
/me messages filterâ
The /me messages filter removes any stylized messages from someone who uses Twitch's «/me»
chat command in chat.
Nonexistent commands filterâ
The nonexistent commands filter removes messages trying to use nonexistent bot commands.
Adjustable settings for the nonexistent commands filterâ
Setting | Description | Default |
---|---|---|
Remove messages only after the second occurrence of a nonexistent command | Moobot will only remove the message if a recent message has used a nonexistent bot command. | ON |
Fake removals filterâ
The fake removals filter removes messages pretending to be deleted («message deleted by a moderator»
variations.)
Announcing unwanted behavior in Twitch chatâ
The Twitch bot can automatically announce in your Twitch chat when someone breaks your rules.
By announcing when and why someone is removed from your Twitch chat, you make everyone aware of your rules and the consequences for breaking them.
While in a filter's settings menu, use the toggle button for «Announcements»
to toggle its announcement.
The announcement messages are also fully adjustable in the «Announcements»
section of a filter's settings menu.
Setting the repercussions of unwanted behaviorâ
Once Moobot filters a user's chat message you have two options on how it will affect the chat message and user.
Option | Result |
---|---|
Remove only the message | Moobot will remove the single offending chat message, but the user and their past and future messages will be unaffected. |
(â) Remove both the message and the user | Moobot will remove the offending chat message, and the user's recent messages. Moobot will also put the user in a temporary timeout. |
(â) If a user is put in a timeout they will be unable to send any more messages to Twitch chat until the timeout has expired. You can adjust the duration in the «Timeout duration»
input, allowing you to adjust the severity of the repercussions.
Warning users on their first offenseâ
Before giving a timeout, you can give misbehaving users a warning on their first offence. This allows them to learn your rules without any major repercussions.
To activate warnings for a filter, activate the toggle button for «Warning»
while in a filter's settings menu.
Moobot gives a user one warning per filter.
Once a warning expires (usually after 24 hours), the user will be given another warning (instead of a timeout) if they get filtered again. You can adjust the expiration time in the «Warning expiration time»
input once the «Show advanced options»
checkbox is activated.
Adjusting the repercussions for warningsâ
You have several options on how warnings will affect the chat message and user.
Option | Result |
---|---|
Don't remove the message nor the user | The chat message and user will be unaffected, but Moobot will make an announcement in Twitch chat (if activated.) |
Remove only the message | Moobot will remove the single offending chat message, but the user and their past and future messages will be unaffected. |
(â) Remove both the message and the user | Moobot will remove the offending chat message, and the user's recent messages. Moobot will also put the user in a temporary timeout. |
(â) You can adjust the timeout duration in the «Warning timeout duration»
input.
Having users acknowledge their offenses before they can chat againâ
You can require users to acknowledge their offenses before they can chat again by activating the «The user must acknowledge the warning before they can chat again»
checkbox in the «Warning»
section of a filter's settings menu.
Moobot will display this acknowledgment message in the user's chat window, which they must click to continue chatting.
This allows your viewers to confirm exactly which of your chat rules they have broken, without any confusion or repercussions.
Moobot can perform this action for the user's first offense (warning) when you have set the warning to either «Don't remove the message nor the user»
or «Remove only the message»
.
Excluding special Twitch viewers from auto moderationâ
You can exclude certain special viewers from your auto moderation, like your Twitch subs, Twitch VIPs and Moobot regulars.
Activate any of the following checkboxes in the «Whitelist»
section of your filter's settings menu to exclude these special viewers:
«Exclude Moobot regulars (basic mode only)»
.«Exclude Twitch subscribers (basic mode only)»
.«Exclude Twitch VIPs (basic mode only)»
.
Excluding special Twitch chat messages from auto moderationâ
You can exclude certain special messages from your auto moderation, like Twitch re-sub alerts, highlighted messages from Twitch Channel Points, and chat messages with Bits.
Activate the various checkboxes in the «Whitelist»
section of your filter's settings menu to exclude these special messages.
You can also adjust the amount of Bits required to exclude the chat message, by adjusting the «Minimum amount of Twitch Bits to exclude»
value.
Basic mode vs. Advanced modeâ
Your built-in message filters have two modes: «Basic mode»
and «Advanced mode»
.
While your filters are in «Advanced mode»
, each user type can have their own unique filter settings applied to them.
This means that you can set up your filtering to e.g. make your fresh (new) Twitch subs have standard filtering applied to them, your normal non-subs have strict filtering, and your 5 year Twitch subs and VIPs have some very lenient filtering applied to them.
Mode | Pros | Cons |
---|---|---|
Basic mode | No need for adjustments. | Cannot have different settings for certain users, only toggle off/on for Twitch subs, VIPs and Moobot regulars. |
Advanced mode | Can adjust the settings for each user type, allowing more strict or lenient settings for certain users. | Requires additional adjustments. |
Follow these steps to activate «Advanced mode»
:
- Open up the
«Moderation»
menu from the main menu, then open the«Message filters»
menu from there. - While in the
«Message filters»
menu activate the«Show advanced options»
checkbox at the bottom of the menu. - Navigate to the
«Advanced mode»
section, which is now visible at the top of the«Message filters»
menu. - Activate the toggle button in the
«Advanced mode»
section. - Click the
«Enable»
button in the confirmation dialog that pops up. «Advanced mode»
is now active, and you can set up the setting profiles for your filters.
Using different settings for different usersâ
You can set up unique settings for different users in Advanced mode by making a «Profile»
for the type of user you want different settings for.
Adjusting your setting profilesâ
Follow these steps to adjust your setting profiles:
- Open up the
«Moderation»
menu from the main menu, then open the«Message filters»
menu from there. - While in the
«Message filters»
menu, make sure you have activated«Advanced mode»
, and then click the«Settings»
button for the filter you want to adjust the setting profiles for. - While in the settings menu, at the bottom of the menu, click the
«Edit»
button to the right-hand side of the«Setting profiles (Advanced mode)»
section. - Make different profiles for each user type you want to have different settings for, by clicking the
«Add a profile»
button at the bottom of the menu. - Adjust the sliders of the profiles to only show the user type you want each profile to apply to. You may have to adjust your Tiers if you do not already see the specific user type you want.
- Make sure you have a profile set for every one of your Tiers, which will make the menu green (opposed to red) with an
«All good!»
message displayed at the top of the menu. - Click the
«Save»
button at the bottom of the menu.
Now adjust the settings of each of the setting profiles you created.
Adjusting the settings of a setting profileâ
Follow these steps to adjust the settings of a setting profile:
- Find the profile you want to adjust the settings for in the
«Setting profiles»
section of the filter's settings menu. - Click the pencil-iconed button (labeled as
«Edit»
) in the profile's table row. - In the profile's settings menu, select the settings you want to adjust in the
«Active settings»
drop-down. - Adjust the settings to fit your needs.
- (â) Repeat step 3 and 4 for each of the setting types (
«Lenient»
,«Standard»
, and«Strict»
), and then in the«Active settings»
drop-down select which setting type you want to be the active one. - Click the
«Save»
button at the bottom of the menu to save your changes.
(â) Step 5 is not required, but highly recommended so that you can easily switch between settings.
Different settings for a setting profileâ
Each setting profile has 3 different setting types that you can switch between: «Lenient»
, «Standard»
, and «Strict»
.
Only one of them is active at a time, which you select in the «Active settings»
drop-down.
This means if you want to make your settings more lenient or strict, you do not have to discard your previous settings, just switch to another setting type and adjust its settings, then switch back to your previous setting type at a later time.
By setting up and adjusting each of the different setting types for your profile, you can also temporarily override the settings, allowing you to switch your settings to e.g. be more strict when your Twitch chat becomes disorderly, or more lenient during a Twitch raid.
Excluding a setting profile from auto moderationâ
You can exclude a setting profile from auto moderation by deactivating the «Enable message filtering»
checkbox while adjusting its settings.
This means Moobot will deactivate the filtering for the selected filter for any user the profile applies to, allowing you to e.g. exclude your Twitch subs, Twitch VIPs and Moobot regulars from the filter.
Easily switching between lenient and strict filteringâ
Advanced mode allows you to override the active settings for all your filters, e.g. in case your Twitch chat becomes unusually disorderly.
In the «Select override settings»
drop-down at the top of the «Message filters»
menu, select which settings you want to apply, and give the duration of the override (in seconds.)
The active settings will then be (temporarily) switched over to your selection, being your «Lenient»
, «Standard»
, or «Strict»
settings.
Handling BetterTTV and FrankerFaceZ emotesâ
With Moobot's BetterTTV (BTTV) and FrankerFaceZ (FFZ) integration your message filters will correctly identify emotes from these extensions, and treat them as such instead of just ordinary words as vanilla Twitch chat sees them.
This allows your Moobot to apply the correct filtering for any messages containing such emotes, which avoids your viewers getting incorrectly filtered.
Follow these steps to activate the BTTV and/or FFZ integration for your Moobot:
- Open up the
«More»
menu from the main menu, then open the«BTTV and FFZ»
menu from there. - In the
«BTTV and FFZ»
menu find and activate the toggle buttons belonging to the integration you wish to activate. - Click the
«Reload»
button if you wish to immediately re-sync your emotes.