How to install and use ChatCensor plugin [Java]
ChatCensor
How you can utilise anti-spam and anti-swear on your server!
ChatCensor is a spigot plugin currently supported by minecraft versions 1.8, 1.9, 1.10, 1.11 and 1.12. It might work on later versions of minecraft, though I would recommend creating a backup before you try your luck.
ChatCensor's main purpose is simple: detect spams and swears, and give out appropriate punishment. In this article, you'll learn about ChatCensor's installation process, commands and their respective permissions and the configuration file.
Let's get started!
Installation
ChatCensor's installation process is the same as every other plugin. Just go along with the following steps:
- Download the plugin here
- Drop the jar file into your server's plugins folder.
- Restart (or start) your server.
All done! Most of the settings can be changed while you're playing the game. Due to this, we'll take a look at the commands ChatCensor offers before getting to the configuration file.
Commands
Command | Permission | Description |
---|---|---|
/chatc add <insert word> | chatcensor.admin | Add a word to the list of swear words. |
/chatc antiswear <on/off> | chatcensor.admin | Turns the antiswear on or off. |
/chatc antispam <on/off> | chatcensor.admin | Turns the antispam on or off. |
/chatc remove <insert word> | chatcensor.admin | Removes a word from the list of swear words |
/chatc anticaps <on/off | chatcensor.admin | Turns the anticaps on or off. |
Players with the permission chatcensor.admin will still be affected by the antispam, antiswear and anticaps. To bypass the plugin's detection, these permissions are required:
Permission | Respective bypass |
---|---|
chatcensor.antiswear.bypass | Anti swear |
chatcensor.antispam.bypass | Anti spam |
chatcensor.anticaps.bypass | Anti caps |
You now know everything about the commands and permissions of ChatCensor. Let's take a look at the configuration file now.
Configuration file
Below is the default config file.
settings:
antiswear:
enabled: true
antispam:
enabled: true
cooldown: 3
anticaps:
enabled: true
min-msg-lenght: 4
max-caps-percentage: 25.0
blockmsg: true
uppercase-characters: ABCDEFGHIJKLMNOPQRSTUVWXYZ
messages:
nopermission: '&cno permission'
antiswear:
blocked: '&cWords are not allowed'
adminmsg: '&c%player% tried to swear'
antispam:
blocked: '&cYou have to wait &6%time% &cseconds.'
adminmsg: '&c%player% tried to spam'
anticaps:
adminmsg: '&c%player% is using caps-lock.'
blocked: '&c%player%, please disable caps-lock.'
# Variables:
- %player% = playername(sender)
- %time% = cooldowntime
The sections of interest are antispam and anticaps. Notice that antispam has a cooldown you can change. Anticaps has a very important parameter called max-caps-percentage. This percentage dictates how much of a message send needs to be capital letters in order for the plugin to punish the sender. I personally recommend that this setting be set to atleast 60%.
And that brings us to the end of the article! You now know everything needed to start using ChatCensor. I hope this article leaves no rooms for doubt. But if you do have any queries, consider visiting the official spigot page here. If you still have doubts, join the official witherhosting discord server with the following invite: https://discord.gg/witherhosting-607675165785980932 to seek help.
Article made by @apostle_of_vanity ( ID 718710286596702220 )
Updated on: 20/07/2023
Thank you!