Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

Profanity Filter

Quick rating

Community listing page, reviews may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

Profanity Filter

By Fabric Server Essentials

No reviews yet

Server-side profanity filter that blocks flagged chat, warns repeat offenders, and escalates to kicks and bans.

Mod Loaders
Minecraft
26.3 26.2
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

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.

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

  1. Drop the .jar into your server's mods folder.
  2. Ensure you have the correct Fabric API version installed for your target environment (1.21.x or 26.x).
  3. Configure your word list and thresholds in config/profanity_filter.json.
  4. Restart the server to apply changes and enjoy a clean chat!