Articles on: Plugin Setup

How to install and use ChatCensor plugin [Java]


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!


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.


/chatc add <insert word>chatcensor.adminAdd a word to the list of swear words.
/chatc antiswear <on/off>chatcensor.adminTurns the antiswear on or off.
/chatc antispam <on/off>chatcensor.adminTurns the antispam on or off.
/chatc remove <insert word>chatcensor.adminRemoves a word from the list of swear words
/chatc anticaps <on/offchatcensor.adminTurns 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:

PermissionRespective bypass
chatcensor.antiswear.bypassAnti swear
chatcensor.antispam.bypassAnti spam
chatcensor.anticaps.bypassAnti 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.

    enabled: true
    enabled: true
    cooldown: 3
    enabled: true
    min-msg-lenght: 4
    max-caps-percentage: 25.0
    blockmsg: true
    uppercase-characters: ABCDEFGHIJKLMNOPQRSTUVWXYZ
  nopermission: '&cno permission'
    blocked: '&cWords are not allowed'
    adminmsg: '&c%player% tried to swear'
    blocked: '&cYou have to wait &6%time% &cseconds.'
    adminmsg: '&c%player% tried to spam'
    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: to seek help.

Article made by @apostle_of_vanity ( ID 718710286596702220 )

Updated on: 20/07/2023

Was this article helpful?

Share your feedback


Thank you!