Word & Phrase Filter
Last updated
Was this helpful?
Last updated
Was this helpful?
The Intelligent Word & Phrase Filter module hyper intelligently detects swears configured blocked words or phrases (and words/phrases similar to those on the list) from being said in chat, commands, signs, anvils, and books (additional check contexts can be disabled).
You can access the below settings in the word-and-phrase-filter.yml file within the modules folder of the plugin's root folder.
Config excerpts taken from v4.4.0 and may not be completely up-to-date with the latest changes. To see the most up-to-date file, see below:
To block variants and attempts to bypass the filter, the module will check for similar words & phrases that are on the block list in players messages and commands.
The value below is how similar other words/phrases must be to a word/phrase on the blacklist to be considered an attempt to exploit / bypass the filter.
1.0 = exactly as one of the phrases on the list (excluding character case) 0.0 = not exact (this eliminates the purpose of the similarity checker)
When enabled, the filter will, based off the below charset process lookalike numbers and symbols as letters to detect players substituting letters with numbers numbers to bypass the filter. Ex. @ = A, # = H, 1 = I, 3 = E, etc.
Below is the substitutions the plugin will process. Please note that adding excessive amounts of substitutions will raise false positive rates.
Should detections found in players usernames be ignored?
When enabled, the filter will scan for existing commands from other plugins and allow them to go through, even if they are falsely detected due to being similar to a blocked word
Keeping this enabled is highly recommended, as it can prevent a lot of false positives depending on how many commands your server has.
Note that this option will only work if "process-commands" is true in config.yml
Below is the blacklist of words & phrases that will be blocked from being said in chat & commands.
Character case in the below list does not matter. Case variants are automatically checked by the plugin on all entries.
Set to "blocked-words-and-phrases: []" to have an empty list.
Below is the whitelist of words & phrases that will under all circumstances be ignored by the filter.
Since similar words/phrases to the blacklisted words/phrases are detected, the below list functions to fix the plugin not allowing valid but close matching words/phrases on entries you have no modifiers on.
Similarity checking is not active on these entries & character case does not matter.
Set to "whitelisted-words-and-phrases: []" to have an empty list.
The below list will only work if "process-commands" is true in config.yml
The below list is which commands (including all arguments) the module under all circumstances will not process.
Make sure to only include base commands; don't add any command arguments. (spaces)
Set to "whitelisted-commands: []" to have an empty list.
For preconfigured (English) lists of swears, slurs, etc. see here:
For an extensive guide on how the block list works and how to set it up properly, see here: HIGHLY RECOMMENDED TO READ TO PREVENT FALSE DETECTION ISSUES, OR USE THE PRESET LISTS !