🛡️ 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., @ for a, $ for s, 0 for o).
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.

⚙️ 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 Determines how strictly the engine strips special characters. enable_leetspeak Boolean true Whether to check for character replacements like $ for s.

🛠️ 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 .jar into your server's mods folder.
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!