
Profanity Guard
Profanity Guard is a Minecraft mod that utilizes datapacks to filter and block profanity in chat, ensuring a cleaner and more respectful experience for players.
Screenshots

About this Mod
Profanity Guard is a Minecraft mod designed to help server owners maintain a more respectful in-game chat environment. By using datapacks, Profanity Guard enables customizable filtering of profanity.
Features:
- Customizable Word Filters: Server owners can easily expand or modify the profanity list using
.jsonfiles. - Flexible Word Management: The mod supports aliases and common misspellings, making it possible to easily blocking variations of offensive terms.
- Profanity Replacement: Words flagged as profanity are replaced with
#(hashtags) by default, but server owners can customize this replacement character. - Customizable Replacement Characters: Using the
"replacement"tag, server owners can specify a custom character to replace profanity words instead of the standard#. - Simple Integration Path: To add new words to the filter, place the
.jsonfiles in the following path:
data/<id>/profanity/<filename>.json
Replace <id> with your datapack’s namespace and <filename> with your chosen name for the file.
Example .json Configuration:
To add a new word to the filter, server owners can create a .json file in their datapack using the following structure:
{
"this_is_the_main_profanity_word": [
{
"aliases": [
"These_are_common_typos_or_aliases_of_the_word"
],
"replacement": "*"
}
]
}
Additional Notes:
- Add Multiple Words in a Single File: It's perfectly fine to include multiple profanity words and their aliases in the same
.jsonfile. - Naming Flexibility: The
.jsonfile names are unrelated to the parsing process. You can name them however you like, as long as they follow Minecraft's naming conventions (lowercase only, no spaces, etc etc). - Automatic Loading: Any file placed in the
profanityfolder will automatically load.
Available Versions
How to Install Profanity Guard on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.6).
Install Mod
Open the mod browser in the dashboard and search for "Profanity Guard". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.6, 1.20.5, 1.20.4 (+3 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Profanity Guard server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.6). You can switch loaders with one click in the panel.
Is Profanity Guard compatible with fabric and forge?
Profanity Guard officially supports fabric, forge for Minecraft 1.20.6, 1.20.5, 1.20.4. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Profanity Guard – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Profanity Guard consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Profanity Guard with just one click on your server.