Back to mods
Profanity Filter project artwork

Modrinth · Minecraft mod

Profanity Filter

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Profanity Filter release matches 26.2?

Updated 2 months ago
Best match for your filters 1.0.1
Game version 26.2
Loader Fabric

Profanity Filter 1.0.1 targets 26.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.

Where it goes

Is Profanity Filter required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked server-only.

What else does Profanity Filter 1.0.1 need?

1.0.1 on 26.2. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by Profanity Filter 1.0.1
required
Matching file found Matched file: 0.158.0+26.2

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Profanity Filter without breaking your instance.

Built for Profanity Filter 1.0.1 on 26.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.1. It targets 26.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.1. It opens that exact file at the source.

About this project

What does Profanity Filter add?

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!

Project description from Modrinth.

Pick your setup

Profanity Filter by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

16 available setups

Showing the newest 12 of 16 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Profanity Filter versions and loaders

1 of 4 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.