HappyFilter – Forbidden-Word Plugin!
Key Features
️ Ultra-Smart Forbidden-Word Filtering
Command Reference
Bug reports: QQ 1031612019 or open an issue on GitHub.
Key Features
️ Ultra-Smart Forbidden-Word Filtering
- More than simple keyword matching – detects words split by special characters (e.g. c/n/m)
- Regex rules block URLs, ads, etc.
- Chat-history tracking: forbidden words sent in several messages are still caught
- Logs caught words to console
- Fully customizable warning messages
- Define your own replacement words – whatever you want!
- Random pick from replace_words list
- Aho-Corasick automaton – “use it in OI and you’ll AK!”
- Asynchronous chat-event processing
Code (YAML):
# config.yml
enabled : true # Enable/disable filtering
log_to_console : true # Print caught words to console
filter_words : # Forbidden-word list
- "cnm"
- "sb"
- "byd"
- "nm"
filter_rules : # Filtering rules
regex : # Regular expressions
- "(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}(?:\\.[a-zA-Z]{2,})?"
interference_characters : # Characters used to split words
- '/'
- '\'
- '.'
- ','
- '|'
- ' '
replace:
replace_words : # Replacement words (random pick)
- "~"
warning : # Warning message
enabled : true
message : "§cDo not post sensitive content!"
enabled : true # Enable/disable filtering
log_to_console : true # Print caught words to console
filter_words : # Forbidden-word list
- "cnm"
- "sb"
- "byd"
- "nm"
filter_rules : # Filtering rules
regex : # Regular expressions
- "(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}(?:\\.[a-zA-Z]{2,})?"
interference_characters : # Characters used to split words
- '/'
- '\'
- '.'
- ','
- '|'
- ' '
replace:
replace_words : # Replacement words (random pick)
- "~"
warning : # Warning message
enabled : true
message : "§cDo not post sensitive content!"
Code (YAML):
messages.yml
prefix : "§7[§dHappy§bFilter§7] " # Chat prefix
commands:
reload_success : "§aConfig reloaded"
plugin_enabled : "§aPlugin enabled"
plugin_disabled : "§aPlugin disabled"
unknown_command : "§cUnknown command!"
no_permission : "§cYou don't have permission!"
help:
header : "§aHappyFilter Help"
reload : "§a/happyfilter reload - Reload config"
help : "§a/happyfilter help - Show help"
enable : "§a/happyfilter enable - Enable word filter"
disable : "§a/happyfilter disable - Temporarily disable filter"
log : "Left index: {l} Right index: {r} Word: {w}" # Console log format
warning:
message : "§cDo not post sensitive content!"
prefix : "§7[§dHappy§bFilter§7] " # Chat prefix
commands:
reload_success : "§aConfig reloaded"
plugin_enabled : "§aPlugin enabled"
plugin_disabled : "§aPlugin disabled"
unknown_command : "§cUnknown command!"
no_permission : "§cYou don't have permission!"
help:
header : "§aHappyFilter Help"
reload : "§a/happyfilter reload - Reload config"
help : "§a/happyfilter help - Show help"
enable : "§a/happyfilter enable - Enable word filter"
disable : "§a/happyfilter disable - Temporarily disable filter"
log : "Left index: {l} Right index: {r} Word: {w}" # Console log format
warning:
message : "§cDo not post sensitive content!"
- /happyfilter reload – Reload configuration files
- /happyfilter help – Show help message
- /happyfilter enable – Turn the filter on
- /happyfilter disable – Temporarily turn the filter off
- happyfilter.bypass – Bypass the filter
- happyfilter.admin – Admin commands
- Escape special chars: always write \\ in regex sections!
- Add new words: just append a new line under filter_words!
- Performance: the automaton is rebuilt only when the word list changes!
- Testing: use disable to switch it off for tests, then enable to turn it back on!
Bug reports: QQ 1031612019 or open an issue on GitHub.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
HappyFilter is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 18 times (via Spigot). Download it and open it directly in the game.