Skip to content
FirstTimeEZ edited this page Nov 5, 2024 · 23 revisions

Rule Creation Guide

You can view/change the content rules by clicking the button in the address bar to open the pop-up

Settings Bar

You can mouse-over a setting to see what it does, detailed explanations below.

Hide Bot Spam

Content containing the words below will be removed from chat if the Hide Bots setting is active

StreamElements
Streamlabs
SoundAlerts
Moobot
Nightbot
Fossabot
DeepBot
WizeBot
PhantomBot
Streamlabs Chatbot
Botisimo
TwitchBot

Hide Command Spam

Content containing the words below will be removed from chat if the Hide Commands setting is active

!join
!gamble
!following
!followage
!links
!points
!hype
!uptime
!commands
!watchtime
!socials
!donate
!schedule
!vote
!specs
!sens
!party
!song
!playing
!game
!music
!patch
!event

View Removed Message History

Click the settings cog to open the removed message history in a new tab

Download List

You can download the list of content rules any time by clicking the download button in the pop-up window


Basic Rules

The simplest way to create a rule is to use a basic text match. However, remember that simpler rules can have broader effects.

ExampleUser     # Blocks ANY content containing "ExampleUser"
!commands       # Blocks ANY content containing "!commands"

⚠️ Important: Simple rules like these will match anywhere in messages, usernames, or replies. Consider using more specific rules for better control.

Specific Rule Types

1. Display Name Rules

To block specific users:

display-name=NightBot
display-name=StreamElements

This only blocks messages from these exact usernames.

2. Message Content Rules

To block specific message patterns:

:this is an example message    # Blocks this exact message
example phrase                 # Blocks messages containing this phrase
!gamble                        # Blocks messages containing this command
discord.gg                     # Blocks Discord invite links

3. User ID Rules

For more precise user blocking:

user-id=19264788    # Blocks Nightbot (more reliable than display-name)

Advantage: User IDs never change, even if the user changes their display name.

4. Message Type Rules

emote-only=1              # Blocks emote-only messages
first-msg=1               # Blocks first-time chatters

5. User Type Rules

Block based on user categories:

user-type=mod

Best Practices

  1. Be Specific

    • ❌ Bad: hello (blocks any message containing "hello")
    • ✅ Good: display-name=SpamBot123 (blocks specific user)
  2. Common Bot Blocking

    display-name=StreamElements
    display-name=Nightbot
    display-name=Moobot
    display-name=Fossabot
    
  3. Common Command Blocking

    !join
    !gamble
    !followage
    !watchtime
    

Advanced Rules

  • You can see output from messages that are not blocked when Debug Mode is turned on
  • The output can be used to create content rules.

Notes

  • Rules are case-sensitive
  • More specific rules reduce false positives
  • The extension stores rules locally for privacy
  • Does not filter your own comments unless you refresh

⚠️ Remember: The more specific your rules, the less likely they are to accidentally block desired content.