Profanity Guard: Custom Chat Filter for Minecraft Servers

Keep your Minecraft server chat clean with Profanity Guard for Minecraft. Customizable word filters, aliases, and replacements in one lightweight mod.

Profanity Guard

Running a public Minecraft server means dealing with everything from friendly banter to chat that makes your moderators cringe. Profanity Guard is a lightweight mod built specifically for server owners who want a cleaner, more respectful in-game chat environment without babysitting every message. Instead of relying on clunky chat plugins or manual moderation around the clock, this mod uses datapacks to filter profanity in a way that fits naturally into your existing setup.

What Profanity Guard Actually Does

At its core, Profanity Guard scans chat messages and replaces flagged words with a character of your choice. By default, offensive terms get swapped out for hashtags (#), but that is just the starting point. The real strength of the mod lies in how flexible the filtering system is. You are not locked into a fixed word list that ships with the mod. Instead, you define your own filters through simple .json files, which means your server's rules and your filter list can stay perfectly in sync.

Customizable Word Filters

Server owners can expand or modify the profanity list at any time by editing .json files. This makes it easy to adapt the filter to your community. Maybe your players speak multiple languages, or maybe there is a specific slang term that keeps popping up. Either way, adding a new entry takes seconds.

Flexible Word Management With Aliases

One of the smartest features is alias support. Offensive terms rarely appear in just one form, and players love to get creative with misspellings to dodge filters. Profanity Guard lets you attach aliases to a main word, so common typos and variations all get caught by a single entry. That means less maintenance for you and fewer loopholes for troublemakers.

Customizable Replacement Characters

Not everyone wants a wall of hashtags in chat. Using the "replacement" tag, you can specify any character to stand in for flagged words. Some servers prefer asterisks, others use a neutral symbol that fits their theme. The choice is entirely yours, and it can be set per word if you want that level of control.

Supported Minecraft Versions and Loaders

Profanity Guard is designed around the datapack system, which makes it compatible with modern Minecraft Java Edition releases where datapack-driven mods are supported. Because it leans on datapacks rather than deep engine hooks, it tends to stay stable across version updates, which is a big plus for servers that do not want to rebuild their moderation setup every few months. Always check the mod page for the exact Minecraft version and loader requirements before installing, since support can vary between releases.

How to Install Profanity Guard for Minecraft

Getting started is straightforward, even if you have never touched a datapack before. Here is the basic process:

  • Download Profanity Guard for Minecraft from the official mod page and place it in the correct mods or datapacks folder for your loader.
  • Launch the server once so the necessary folders generate.
  • Navigate to the profanity folder inside your datapack directory.
  • Create your first .json file using Minecraft's naming conventions: lowercase only, no spaces.
  • Add your words, aliases, and replacement characters, then reload the datapack.

If you would rather skip the manual file juggling, the foxygame.net launcher streamlines the whole process: it lets you install Profanity Guard with a single click from its curated add-on catalog, so your server filter is ready before you even open the world. That approach also handles version compatibility checks automatically, which saves a lot of guesswork.

Example .json Configuration

The structure is simple. To add a new word to the filter, create a .json file in your datapack using this format:

{ "this_is_the_main_profanity_word": [ { "aliases": [ "These_are_common_typos_or_aliases_of_the_word" ], "replacement": "*" } ] }

Replace the placeholder text with your actual word, list any aliases inside the brackets, and set the replacement character you want to appear in chat.

Helpful Tips for Managing Your Filter

  • You can include multiple profanity words and their aliases in a single .json file, so there is no need to create dozens of tiny files.
  • File names are unrelated to how the mod parses them. Name them however you like as long as they follow Minecraft's naming conventions.
  • Any file placed in the profanity folder loads automatically, so you never have to register entries manually.

Final Thoughts

Profanity Guard fills a niche that many server owners know all too well: keeping chat respectful without turning moderation into a full-time job. The datapack-based approach keeps it lightweight, the alias system handles the creative spellings players inevitably try, and the customizable replacement character means your chat can still look the way you want. Whether you run a small survival world for friends or a busy public server, this mod is a practical, low-maintenance addition to your toolkit. Download Profanity Guard, drop in a few .json files, and let your chat clean itself up.