Skip to main content

How to Filter Bad Language and Spam from Your Chat (ChatControl)

Note:

This incredibly powerful plugin acts as an automated security guard for your chat box. Out of the box, it automatically blocks spamming, stops players from using ALL CAPS, filters out swear words, and prevents players from advertising other server IP addresses

1. Download ChatControl and ProtocolLib Plugins

Note: Make sure to match your Server Version and Platform

Locating and downloading the ChatControl plugin from the official Modrinth resource page
Locating and downloading the ProtocolLib companion plugin from the official SpigotMC resource page

2. Log In to Your Panel

3. Select the ‘Files’ Tab

Cybrancee panel Minecraft files page, with files tab outlined

4. Select the ‘Plugins’ Folder

Navigating to the plugins folder in the server file manager.

5. Upload the ‘ChatControl.jar‘ and ‘ProtocolLib.jar‘ Into the ‘Plugins’ Folder

Uploading both the ChatControl and ProtocolLib jar files into the server's plugins directory

6. Restart Your Server

7. Inside ‘Plugins’ Folder, Select ‘ChatControl’ Folder

home > container > plugins > ChatControl

Navigating to the ChatControl folder inside the server's plugin directory

8. Select the ‘Rules’ Folder

home > container > plugins > ChatControl > Rules

Opening the rules configuration folder inside the ChatControl plugin directory

9. Select the ‘Rules.txt‘ File

Locating the swear.txt file inside the ChatControl rules folder to edit chat filters

10. How to Add Custom Swear Words

Open the swear.txt file.

You will see a huge list of rules with a hashtag (#) in front of them. This # tells the plugin to ignore that rule. To enable a pre-made block, simply delete the # match line from the handle line!

To add your own custom word: Scroll to the bottom of the file and copy the same format! Type match YourCustomWord on one line, and handle as swear on the line right below it.

You can find pre-made lists of banned words here: https://github.com/Hesham-Elbadawi/list-of-banned-words (multiple languages available)

https://cybrancee.com/learn/wp-admin/post.php?post=14543&action=edit

11. How the Automatic Filters Work

ChatControl works immediately. The moment the server boots up, the plugin enforces basic chat etiquette.

Spam Filter: If a player types the exact same message twice, the plugin blocks the second message and warns them.

Caps Filter: If a player types a message entirely in uppercase letters, ChatControl will automatically convert it to lowercase.

IP Filter: If a player tries to post a URL or an IP address to another Minecraft server, the message is hidden, and the player is warned.

12. Essential ChatControl Commands

/chatcontrol reloadReloads the plugin. You must run this every time you add a new word to the text files
/chatcontrol clearInstantly wipes the entire chat box for all players
/chatcontrol muteMutes the entire server chat. Only server admins will be able to talk until you unmute it

Minecraft Server Hosting

Starts at $1.99

External link icon
Was this article helpful?
Please Share Your Feedback
How Can We Improve This Article?
Table of Contents