Advanced Profanity Filter
Next-Gen Toxicity Control for Fabric 1.21.x & 26.x
Advanced Profanity Filter is a lightweight, server-side utility designed to maintain community standards without constant manual moderation. Unlike basic filters that are easily tricked by spaces or symbols, this mod uses an aggressive Normalization Engine to strip bypass attempts before they ever hit the chat.
Key Features
Multi-Version Protection: Fully compatible across all Fabric 1.21.x versions and the latest 26.x snapshots/releases.
Normalization Engine (Anti-Bypass): Automatically flattens messages by stripping spaces, periods, underscores, and special characters to expose hidden words.
Symbol & Leetspeak Detection: Intelligent detection for character replacements (e.g.,
@fora,$fors,0foro).Total Message Prevention: Blocks the entire message from being sent to maintain a clean chat environment and prevent "signed chat" errors common in modern Fabric versions.
Automated Enforcement Tiers:
Warnings: Issues a customizable warning message to the offender.
Automated Kick: Triggered after a set amount of warnings (Default: 3).
Automated Ban: Permanent removal after repeated violations (Default: 10).
PvP-Aware Logic: Specifically tuned to ignore common gameplay terms (TNT, Spear, Raid) while focusing strictly on insults and toxic behavior.
Enhance your server setup! Check out my other server-side mods over at : Fabric Server Essentials
Configuration (profanity_filter.json)
The mod generates a highly granular config file in your server's /config folder. Below are the primary settings available to server owners:
| Setting | Type | Default | Description |
|---|---|---|---|
kick_threshold |
Integer | 3 |
Number of warnings before an automated server kick. |
ban_threshold |
Integer | 10 |
Number of warnings before an automated permanent ban. |
normalization_level |
String | AGGRESSIVE |
Sets how strictly the engine strips special characters. Supports AGGRESSIVE or BASIC. |
enable_leetspeak |
Boolean | true |
Whether to check for character replacements like $ for s. |
Normalization Levels Explained
BASIC: Checks for simple word matches and direct leetspeak transformations without changing the sentence layout drastically.AGGRESSIVE: Completely flattens the input message by completely stripping out all spaces, tabs, periods, underscores, and special punctuation characters to expose hidden or spaced-out toxic text strings.
Management & Dictionary
- Live Dictionary: A pre-loaded list of 1,000+ variations that can be edited in real-time via the JSON config without a server restart.
- Custom Messaging: Fully supports classic mini-message or standard color codes for all warning, kick, and ban messages.
- Exclusion List: Add specific phrases that the filter should ignore, even if they contain flagged characters.
Performance & Tech
Server-Side Only: Players do not need to install this mod to join your server!
Designed for high-population networks running modern hardware. The logic is heavily optimized using FastUtil collections and efficient processing pipelines, ensuring zero "chat lag" or impact on TPS, even during intense, heavy global chat activity.
Installation
- Drop the
.jarinto your server'smodsfolder. - Ensure you have the correct Fabric API version installed for your target environment (1.21.x or 26.x).
- Configure your word list and thresholds in
config/profanity_filter.json. - Restart the server to apply changes and enjoy a clean chat!
