🚫 Auto mod Twitch chat with message filters

Your Twitch bot can remove 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. Simply activate the filter and its unwanted behavior will be automatically removed from your Twitch chat.

Simply follow these steps to activate a message filter:

1. Open up the Moderation menu from the main menu, then open the Message filters menu from there.
2. While in the Message filters menu activate the toggle button to the right side of the filter you want to activate.
3. Your message filter is now active in Twitch chat!

To adjust the settings of a message filter, simply click its Settings button (found in the Message filters menu.)

Built-in message filters

Your built-in message filters can be fully adjusted 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	The message will be removed if it contains any IP addresses, to preserve the privacy of you and your viewers.	ON
Remove messages containing 'dot com' variations	The message will be removed 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 message before filtering	(⁎) The message will only be checked for excessive use of capital letters when its length is equal to or greater than this value.	15
Maximum percent of capital letters allowed in a message	(⁎) The message will be removed if its percentage of upper- compared to lower-case letters (not numbers or symbols) is greater than this value.	60%

(⁎) 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	(⁎) The message will only be checked when its length is equal to or greater than this value.	20
Remove messages containing excessively repeated words and/or characters	The message will be removed 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	(⁎⁎) The message will be removed 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	The message will be removed 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	The message will be removed if it's constructed like type ... in chat for....	ON

(⁎) The Remove users trolling others... filtering is unaffected by the length of the message.

(⁎⁎) Links are not treated 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	The message will only be checked for excessive use of symbols when it contains an amount of symbols that is equal to or greater than this value.	3
Maximum grouped symbols allowed in a message	The message will be removed 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	The message will only be checked for percent of symbols when its length is equal to or greater than this value.	15
Maximum percent of symbols allowed in a message	The message will be removed 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	The message will be removed if it contains any special block symbols (commonly used to spam.)	ON
Remove messages containing zalgo symbols	The message will be removed if it contains any special zalgo symbols (commonly used to spam.)	ON
Remove messages containing Moobot's blacklisted symbols	The message will be removed 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	The message will be removed 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	The message will be removed 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	(⁎) (⁎⁎) The message will only be checked when its length is equal to or greater than this value.	15
Maximum percent of numbers allowed in a message	(⁎) The message will be removed if its percentage of numbers is greater than this value.	80%
Remove messages containing just numbers	The message will be removed if the message is constructed of just numbers.	OFF

(⁎) Emotes and whitespace do not count towards the filter's values.

(⁎⁎) The Remove messages containing just numbers filtering is unaffected by the length of the message.

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	The message will be removed if it contains an amount of special letters greater than this value.	4

Colored messages filter

The colored messages filter removes colored messages (from someone using the /me command in Twitch 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	The message will only be removed 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.

Simply use the toggle button for Announcements (while in a filter's settings menu) to toggle its announcement.

The announcement messages are also fully adjustable in the Announcements section of a filter's settings menu.

Tip: If you want to disable the announcements, you can disable all auto moderation announcements in the General settings menu instead of disabling them for each individual filter.

Setting the timeout duration of unwanted behavior

Once a user's chat message has been filtered, their message is removed, and they are put on a chat timeout where they are unable to send any more messages to Twitch chat until their timeout has expired.

The duration of the timeout can be adjusted in the Timeout duration input, allowing adjustment to the severity of the filter's punishment.

Warning users on their first offense

By giving misbehaving users a warning on their first offence, you allow them to learn your rules without you coming down on them full force.

A warning lasts 24 hours, and a user is given one warning per filter.

Simply activate the toggle button for Warning (while in a filter's settings menu) to activate warnings for a filter.

You have several options on how warnings affect the chat message and user:

1. Don't remove the message nor the user:

The chat message and user will be unaffected, but an announcement will be made in Twitch chat (if activated.)

2. Remove only the message:

The single offending chat message will be removed, but the user and their past and future messages will be unaffected.

3. Remove both the message and the user:

The offending chat message will be removed, in addition to any of the user's recent messages, and the user will be put into a timeout.

The duration of the warning timeout can be adjusted separately in the Warning timeout duration input.

Excluding special Twitch viewers from auto moderation

You may want to exclude certain special viewers from your auto moderation, like your Twitch subs, Twitch VIPs and Moobot regulars.

Simply 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).

Note: These options are only active while your filtering is in Basic mode. The same can be accomplished in Advanced mode by assigning a Profile to your Twitch subs, VIPs and Moobot regulars, and adjusting that profile.

Excluding special Twitch chat messages from auto moderation

You may want to exclude certain special messages from your auto moderation, like Twitch re-sub alerts and chat messages with Bits.

Simply activate the Exclude Twitch subscription announcements and/or Exclude messages containing Twitch Bits 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 before the chat message is excluded, 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 and every user type can have their own special 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 and every user type, allowing more strict or lenient settings for certain users.	Requires additional adjustments.

Simply follow these steps to activate Advanced mode:

1. Open up the Moderation menu from the main menu, then open the Message filters menu from there.
2. While in the Message filters menu activate the Show advanced options checkbox at the bottom of the menu.
3. Navigate to the Advanced mode section which is now visible at the top of the Message filters menu.
4. Activate the Enable advanced mode checkbox.
5. Click the Enable button in the confirmation dialog that pops up.
6. Advanced mode is now active and you can set up the setting profiles for your filters.

Note: You can go back to Basic mode at any time by deactivating the Advanced mode checkbox at the top of the Message filters menu.

Using different settings for different users

Different settings for different users can be set up in Advanced mode by making a Profile for the type of user you want different settings for.

Adjusting your setting profiles

Simply follow these steps to adjust your setting profiles:

1. Open up the Moderation menu from the main menu, then open the Message filters menu from there.
2. While in the Message filters menu make sure Advanced mode is activated, and click the Settings button for the filter you want to adjust the setting profiles for.
3. 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.
4. 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.
5. 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.
6. Make sure you have a profile set for every one of your Tiers, which will make the menu green (opposed to red) with a All good! message displayed at the top of the menu.
7. Click the Save button at the bottom of the menu.

Now go ahead and adjust the settings of each of the setting profiles you created.

Adjusting the settings of a setting profile

Simply follow these steps to adjust the settings of a setting profile:

1. Find the profile you want to adjust the settings for in the Setting profiles section of the filter's settings menu.
2. Click the pencil-iconed button (labeled as Edit) in the profile's table row.
3. In the profile's settings menu, select the settings you want to adjust in the Active settings dropdown.
4. Adjust the settings to fit your needs.
5. (⁎) Repeat step 3 and 4 for each of the different setting types (Lenient, Standard, and Strict), and then in the Active settings dropdown select which setting type you want to be the active one.
6. Click the Save button at the bottom of the menu to save your changes.

(⁎) Step 5 is not required, but highly recommended for easily switching between settings.

Different settings for a setting profile

Each setting profile has 3 different setting types that you can switch between at any time: Lenient, Standard, and Strict.

Only one of them is active at a time, and is selected in the Active settings dropdown.

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 a different 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 easily 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

A setting profile can be excluded from auto moderation by deactivating the Enable the spam filter for this specific group and settings checkbox while adjusting its settings.

This means the filtering for the selected filter will be deactivated for any user the profile applies to, allowing you to e.g. exclude your Twitch subs, Twitch VIPs and Moobot regulars from the filter.

Note: The exclusion setting is tied to the different setting types of the profile: Lenient, Standard, and Strict, which makes it possible to deactivate the filter for the profile's Lenient settings, while keeping the filter active for its Strict settings.

Easily switching between lenient and strict filtering

Advanced mode allows you to easily override the active settings for all your filters, e.g. in case your Twitch chat becomes unusually disorderly.

Simply select which settings you want to apply in the Select override settings dropdown at the top of the Message filters menu, 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.

Note: To properly take advantage of this functionality, make sure your Lenient, Standard, and Strict settings are properly and individually adjusted for each profile of each of your filters.