# Chat Filter<\/p>\n
### About
\nChat Filter is a simple yet highly configurable plugin that uses regex to scan and handle messages. It can support an unlimited number of patterns in an unlimited number of categories, each capable of executing commands and notifying the proper staff when a match is made.<\/p>\n
### Features:
\n – Mute and unmute players
\n – Unlimited filter categories
\n – Unlimited Regex patterns per category
\n – Execute commands based off which category was matched
\n – Log filter violations with a discord weblink
\n – Built-in profiler for optimisation
\n – Wide compatibility with other chat plugins
\n – Everything is configurable<\/p>\n
### Try out GlowCraft’s Filter “`yaml # [ REGISTER FILTER CATEGORIES ] # [ SPAM LIMITER ] # This is the message format sent to ghosted players. # Server Mute settings # [ NOTIFY ] # logs violations # Should scan times be timed? # enable debug console output “`<\/p>\n<\/details>\n “`yaml # Resources: # Action tag allowed arguments: # Placeholders for commands (case-sensitive) # You must add the category to the list in config.yml to enable # You can add unlimited categories demo-all_caps: # The GamerSafer Regex list cannot be modified as it uses GamerSafer’s official list <\/code> # Support A simple yet highly configurable plugin to filter your servers chat. Should be compatible with most chat plugins.<\/p>\n","protected":false},"featured_media":38776,"template":"","meta":{"_minecraft_slug":"chat_filter","_minecraft_project_id":"8IftuIlR","_minecraft_author":"Tesla6426","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":677,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chat_filter.zip","_minecraft_size_bytes":220631,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T09:42:36.814801Z","_minecraft_date_created":"2025-04-23T03:50:57.203346Z","_minecraft_date_modified":"2025-06-01T23:58:37.814357Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chat_filter","_minecraft_icon_attachment_id":38776,"_minecraft_imported_at":"2026-06-01T20:10:19+00:00","_minecraft_import_hash":"b69616dab4c72b98ec98d951c8f7f1e4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,73,74,38,78],"class_list":["post-38775","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n– [[ GlowCraft’s Filter Repo]](https:\/\/github.com\/PlayGlowCraft\/GS-REGEXChatFilter)
\n– Official ChatFilter partner
\n– Regularly updated
\n– High-performance regex patterns
\n– Minimal false-positives<\/p>\nconfig.yml<\/summary>\n
\n# Chat Filter by _txsla and NBT Archives
\n# This plugin uses MiniMessage to parse messaged
\n# https:\/\/docs.advntr.dev\/minimessage<\/p>\n
\n# Add a category here to register it
\n# The plugin will not recognize categories that are not listed here
\n# Permission ‘chatfilter.filter.bypass’ will bypass these filters
\n# It is recommended that you put more important categories first on the list.
\n# Messages are filtered from first category in this list to last, so if two filters both match the pattern [a-zA-Z].(.com|.net), only the one listed first will be triggered
\n# The ‘gamersafer’ list is the official list of GamerSafer.com
\nregistered-categories:
\n – ‘demo-websites’
\n – ‘demo-all_caps’
\n – ‘gamersafer’<\/p>\n
\n# Every time a player sends a message, it increments a counter
\n# Every x milliseconds that counter is decremented
\n# If a player hits the max messages on their counter, their messages are not shown to other players
\n# Permission `chatfilter.spam.bypass` will bypass this limiter
\nspam-limiter:
\n enabled: true
\n ghost: true # send player their own messages, so they do not know they are muted
\n count-repeats: true # should repeat messages increment twice? ADD THIS LATER
\n counter-ceiling: 5 # if a player’s message counter goes above this number, their messages will be hidden to other players
\n decrement-timer: 3000 # milliseconds between message counter decrements
\n ghost-player: true # should we show the player their cancelled message, so they do not know they are currently muted?<\/p>\n
\n# Can also be used to tell players to slow down
\n# Placeholders:
\n# %PLAYER% – player who sent the message
\n# %MESSAGE% – player’s message
\n# %SERVER% – server that player is in
\n# %WORLD% – world that player is on
\nghost-format: “[GHOSTED]
\n# Muted players’ messages can not be s
\nmute:
\n # should mods be required ot provide a reason?
\n require-reason: true
\n # show muted player’s their messages
\n ghost-player: true<\/p>\n
\n# Notify a player when someone triggers a filter
\n# Players with permission ‘chatfilter.notify’ will be notified
\n# Placeholders:
\n# %PLAYER% – violator’s username
\n# %MESSAGE% – message that triggered the filter
\n# %CATEGORY% – filter category that got triggered
\n# %PATTERN% – regex pattern that matched
\n# %RECIPIENT% – player who is receiving the message
\nnotify:
\n enabled: false
\n message: ‘
\nlog:
\n # Log Message Placeholders:
\n # %PLAYER% – player that triggered the filter
\n # %MESSAGE% – message that triggered the filter
\n # %CATEGORY% – category of filter that got triggered
\n # %PATTERN% – regex pattern that matched
\n message-format: “%PLAYER% has violated filter %CATEGORY% with message %MESSAGE%”
\n to-file: true
\n to-discord: false
\n webhook: “WEBHOOK URL”<\/p>\n
\n# Use this to optimise your regex patterns
\nprofile: false<\/p>\n
\ndebug: false<\/p>\nfilter.yml<\/summary>\n
\n# This filter uses regex to match messages and will not work if you set up your expressions correctly
\n# PATTERNS ARE CASE SENSITIVE, design your regex accordingly<\/p>\n
\n# https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/JavaScript\/Guide\/Regular_expressions\/Cheatsheet
\n# https:\/\/regex101.com\/<\/p>\n
\n# ‘notify’ – notify user as specified in config.yml under notify
\n# (only put one of the below per category)
\n# ‘cancel’ – cancel the message
\n# ‘ghost’ – return message to sender but hide message from other players
\n# ‘ignore’ – does not cancel or modify the message, but still runs the commands<\/p>\n
\n# %PLAYER% – offending player’s username
\n# %UUID% – offending player’s UUID
\n# %MESSAGE% – message that triggered the violation
\n# %PATTERN% – pattern that matched the offending text
\n# %CATEGORY% – filter category that got triggered
\n# %WORLD% – world that offending player was in
\n# %IP% – player’s IP address, useful for auto IP BANS<\/p>\n
\ncategories:
\n # Name of category
\n example:
\n # Whether this category is enabled by default
\n enabled: false
\n # Action to be taken when violation occurs
\n action:
\n – ‘cancel’
\n – ‘notify’
\n # These commands are executed as console when a player triggers the filter
\n commands:
\n – ‘\/ban %PLAYER%’
\n # Regex patterns for the filter to match
\n regex:
\n – ‘pattern-1’
\n – ‘pattern-2’
\n – ‘pattern-3’<\/p>\n
\n # This is an example category to block websites in chat
\n demo-websites:
\n enabled: false
\n action:
\n – ‘cancel’
\n commands:
\n – ‘\/chatfilter mute %PLAYER% 5m Chat Filter’
\n regex:
\n – ‘https?:\/\/’
\n – ‘[wd-]+.(net|com|org)’
\n – ‘[d]+.[d]+.[d]+.[d]+’<\/p>\n
\n enabled: false
\n action:
\n – ‘cancel’
\n commands:
\n – ‘\/chatfilter mute %PLAYER% 1h Chat Filter’
\n regex:
\n – ‘^[A-Zs]+$’<\/p>\n
\n # If there are ever issues with this filter, please make an issue on ChatFilter’s GitHub Page
\n gamersafer:
\n enabled: false
\n action:
\n – ‘cancel’
\n – ‘notify’
\n commands:
\n ‘\/mute %PLAYER% 1h’
\n # How strict should the filter be?
\n # 0 : exact match, case-insensitive
\n # 1 : matches extra letters, case-insensitive
\n # 2 : matches whitespace, extra letters, case-insensitive
\n strictness: 1
\n # For words that have too many false-positives
\n exclude:
\n – ‘cok’
\n – ‘iap’
\n – ‘sm’
\n – ‘ho’
\n – ‘hell’
\n“`<\/p>\n<\/details>\nCommands<\/summary>\n
\nchatfilter\n |disable
\n<\/details>\n
\nIf you stumble across any bugs, please create a support ticket.<\/p>\n","protected":false},"excerpt":{"rendered":"