CleanerX
A filtering plugin that censors offensive language, with options to block links and automatically punish offenders.
I don't know my version or loader
CleanerX
CleanerX is an advanced plugin designed to filter and replace inappropriate language with censored alternatives or remove it entirely, ensuring a clean and respectful gaming environment. It allows you to configure automatic execution of commands, for example, to punish players who repeatedly use offensive language after a specified number of infractions. The plugin also blocks the ability to send links in chat, and if needed, you can clear the chat with a simple command.
🔹 Features
- ✅ Partial or complete word censorship depending on configuration
- ✅ Ability to block unwanted links
- ✅ Add custom words to the blacklist via command without needing to restart the server
- ✅ Add custom words to the whitelist via command without needing to restart the server
- ✅ Automatic execution of commands based on configuration – recommended integration with PunisherX
- ✅ Ability to clear chat using a command
- ✅ Plugin update notifications with an option to enable automatic updates
- ✅ Extensive configuration file for flexible settings. Check the default settings here
- ✅ Multi-language support via
messages_xx.ymlfiles
⚙️ Technical Information
- 🟢 Designed for the latest Minecraft versions 1.20.6–1.21.4+
- 🟢 Optimized for Paper and its forks (Pufferfish, Purpur, Leaves)
- 🟢 Requires Java 21 or newer
- 🟢 Written in Kotlin – a modern, expressive, and safer alternative to Java
If you have any questions, you might find answers on our Discord.
🛠️ Commands and Permissions
| Command | Permission | Description |
|---|---|---|
/whitelistx <add/remove/list> |
cleanerx.cmd.whitelist |
Adds, removes or displays words from the whitelist |
/blacklistx <add/remove/list> |
cleanerx.cmd.blacklist |
Adds, removes or displays words from the blacklist |
/cleanx |
cleanerx.cmd.clean |
Clears the in-game chat |
/cleanerx reset <player> or /crx reset <player> |
cleanerx.cmd.crx |
Resets swear counter for player |
/cleanerx help or /crx help |
cleanerx.cmd.crx |
Displays a list of available commands |
/cleanerx reload or /crx reload |
cleanerx.cmd.crx |
Reloads the configuration file. |
/cleanerx version or /crx version |
cleanerx.cmd.crx |
Shows plugin info |
📥 Download
- The latest stable version is available on Hangar:
- You can also build the latest development version from:
🚀 Installation
- Download the latest version of the plugin from the release section.
- Place the JAR file into the
pluginsfolder on your server. - Start your Minecraft server.
- Configuration:
Open theconfig.ymlfile to customize settings such as the list of banned words or full censorship mode.
📞 Contact
If you have any questions or need support, feel free to reach out on our Discord or send us a direct message.
📜 License
This plugin is available under the MIT License. You can find the details in the LICENSE file.
Thank you for using CleanerX! I hope it meets your expectations. 😊
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20.6, 1.21, 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as CleanerX-Spigot-1.5.8-all.jar — drop this file into the mods folder
- Download size: 1.9 MB
- Download link checked 5 Sept 2026 — working
These come from our own check of the pack file, not from the source page.