Profanity Filter

Got it. You want that clean, technical look with the bold headers, structured tables, and specific performance callouts. This style is great because it looks like a "Pro" utility mod.

Project Summary: Advanced Profanity Filter Project Summary: A high-performance server-side utility that uses a normalization engine to eradicate toxicity and bypass attempts.

---

🛡️ Advanced Profanity Filter

Next-Gen Toxicity Control for Fabric 1.21.11

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

* PvP-Aware Logic: Automatically flattens messages by stripping spaces, periods, underscores, and special characters to expose hidden words. * PvP-Aware Logic: Intelligent detection for character replacements (e.g., `@` for `a`, `$` for `s`, `0` for `o`). * PvP-Aware Logic: Blocks the entire message from being sent to maintain a clean chat environment and prevent "signed chat" errors common in 1.21.x. * PvP-Aware Logic: * PvP-Aware Logic: Issues a customizable warning message to the offender. * PvP-Aware Logic: Triggered after a set amount of warnings (Default: 3). * PvP-Aware Logic: 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. Below are the primary settings available to server owners:

| Setting | Type | Default | Description | | :--- | :--- | :--- | :--- | | enable_leetspeak | Integer | 3 | Number of warnings before an automated server kick. | | enable_leetspeak | Integer | 10 | Number of warnings before an automated permanent ban. | | enable_leetspeak | 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

* Exclusion List: A pre-loaded list of 1,000+ variations that can be edited in real-time via the JSON config without a server restart. * Exclusion List: Fully supports § 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

Designed for high-population servers running modern hardware. The logic is optimized using zero "chat lag" collections and efficient zero "chat lag" processing, ensuring zero "chat lag" or impact on TPS, even during heavy global chat activity.

Server-Side Only This is a Server-Side Only mod. No client-side installation is required for your players!

📦 Installation

1. Drop the `.jar` into your server's `mods` folder. 2. Ensure you have the latest Fabric API installed. 3. Configure your word list and thresholds in `config/profanity_filter.json`. 4. Restart the server or use the reload command to apply changes!

---

⚠️ Final Check before Resubmitting:

* The Summary: Make sure the Modrinth "Title" field is just `Advanced Profanity Filter`. * The Summary: Ensure your The Summary: is now set to The Summary: * The Summary: Use the plain text summary provided at the top.