Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
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 Title: 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
- 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 1.21.x.
- 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. 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 § 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 FastUtil collections and efficient Regex processing, ensuring zero "chat lag" or impact on TPS, even during heavy global chat activity.
Note: This is a Server-Side Only mod. No client-side installation is required for your players!
📦 Installation
- Drop the
.jarinto your server'smodsfolder. - Ensure you have the latest Fabric API installed.
- Configure your word list and thresholds in
config/profanity_filter.json. - Restart the server or use the reload command to apply changes!
⚠️ Final Check before Resubmitting:
- The Title: Make sure the Modrinth "Title" field is just
Advanced Profanity Filter. - The Links: Ensure your Discord Link is now set to "Never Expire."
- The Summary: Use the plain text summary provided at the top.


