By blacklisting certain words and phrases, you can remove specific unwanted behavior from your Twitch chat.
Your Twitch bot's blacklists act as a list of unwanted behavior, and are curated to your channel.
Simply follow these steps to blacklist a phrase:
- Open up the
Moderationmenu from the main menu, then open the
Blacklisted phrasesmenu from there.
- Type the phrase you want to blacklist into the
Phrase...input at the bottom of the menu.
- Click the
Addbutton to the right of the input, or press the
ENTERkey on your keyboard.
- Adjust the settings to fit your needs.
- Click the
Addbutton at the bottom of the menu.
Adjusting the settings of your blacklisted phrase
An important goal for your blacklisted phrase is to avoid false positives while still remaining effective for its purpose.
The settings of the blacklisted phrase gives you several tools to achieve this goal:
Setting where the phrase appears in a Twitch chat message
You have several options to narrow down where the phrase should appear in a message:
Message has the phrase anywhere in the message
The phrase is somewhere inside the message, but does not necessarily have any word boundaries (e.g. spaces) surrounding it.
|Sed do eiusmod tempor ||YES|
|Class aptent taciti||YES|
Message is the phrase exactly
The message is the phrase exactly, with nothing else surrounding it.
Message starts with the phrase
The message starts with the phrase, but may or may not also have something else added at the end of it.
Message has the phrase and is surrounded by word boundaries
The phrase is somewhere inside the message, but is also surrounded by word boundaries (spaces.)
|Sed do eiusmod tempor ||YES|
|Class aptent taciti||NO|
Message ends with the phrase
The message ends with the phrase, but may or may not also have something else added at the beginning of it.
Ignoring letter case in the phrase
By ignoring letter case in the phrase, it will apply to all lower- and upper-case variations of the phrase.
Ignoring word boundaries in the phrase
By ignoring word boundaries in the phrase, it will apply to all variations containing spaces inside the phrase itself.
Example: The phrase
example will also apply for
e x a m p l e,
e xample etc.
Normalizing message characters
By normalizing the characters of a message, certain special characters like
ă will simply be treated as a normal
Tip: In some cases it may be a good idea to normalize the message if you find someone is attempting to get around your blacklist by using special characters.
Checking the phrase against usernames
When activating the
Check username checkbox, the phrase will also be checked against the username of the user, not just their Twitch chat message.
Setting the timeout duration of unwanted behavior
Once a user's message has been detected as a blacklisted phrase, their message is removed, and they are put on a chat timeout.
The duration of the timeout can be adjusted in the
Timeout duration input, and is unique to each blacklisted phrase, allowing the severity of its punishment to be adjusted.
Announcing your blacklisted phrases in Twitch chat
In most cases you want to keep the specifics of your blacklisted phrases unavailable to the public, but in some cases you may still want to remind everyone of your rules and the consequences for breaking them.
For such phrases you can set a custom announcement in the
Announcement section of your blacklisted phrase's settings, for whenever a user's message has been detected as the blacklisted phrase.
Setting who a blacklisted phrase applies to
Certain user groups can be whitelisted, allowing them to bypass the blacklisted phrase.
Simply select the Tiers you want to whitelist by adjusting the
Whitelist slider in your blacklisted phrase's settings menu.
Auto-removing out-of-date blacklisted phrases
For certain temporary unwanted behavior, the blacklisted phrase can be automatically removed once the blacklisting has peaked, and its relevancy in Twitch chat has decreased.
Simply set an expiration time for the phrase in its settings menu by dragging the
Expiration slider to the desired time.
Tip: Keeping your blacklist clean and up-to-date is important so that it doesn't cause you problems (like false positives) in the future. Expiring blacklisted phrases is one way to deal with this.
Quick-moderating using temporary blacklisted phrases
When adding a new blacklisted phrase, your Twitch bot will go back and look at the recent messages in your Twitch chat, and apply the new blacklisted phrase to those as well.
This means that you can effectively moderate by blacklisting parts of a specific message instead of individual users, which is valuable when chat is going fast and the same undesirable message (including variations of it) is being sent by several different users.
By utilizing the
Blacklist a phrase... input in the controls widget on your Moobot dashboard, you can quickly add a new blacklisted phrase (optimally a temporary one), clearing out any spam breaking out in Twitch chat.