Clean Chat: Chat Filter/Coloured messages/Mute Players/Global Mute/Anti spam/Server Join Message/Broadcast Messages

Table of Contents

Clean Chat is so far the best chat management plugin out there.

Why? Because unlike other plugins Clean Chat enables you to properly and effectively prevent abusive language on your server. Clean Chat enables you to mute players and also create a global mute to talk unimpeded. Added to that by using a new programming technique, Clean Chat can detect if a player is swearing even if they are trying to circumvent the filter!

As of version 1.4 of Clean Chat you can now colour your messages! By using special colour tags that clean chat has specially created you can now colour your own messages. Try out these tags by using the /ColourTags <page number> command.

NOTE 17/01/2025: Some users have been complaining of issues with the serverjoinmessage appearing despite running the command /cc setserverjoinMessage. If it still appears /stop the server and edit the serverjoinmessage directly from the config file, the direct config changing commands usually all work but the serverjoinmessage one reads directly from config, given I haven't the time this month to fix it I recommend editing the config directly and either /reloading the server or really stopping it and starting it again to apply the changes as the command /cc setserverjoinMessage doesn't currently work properly.

For example:

A player tries to use the banned word "bleeep" by saying "b$%^£l___eee%&^%p" . Unlike other plugins clean chat will detect this banned word despite all the characters trying to hide it and replace the players entire message with something you set.

Features

Mute and unmute players
See a players mute and spam history
Broadcast repeating messages
Ignore server broadcasts
Clear your own personal chat
If your an operator you can clear server chat
Incredibly effective chat filter that blocks most ways players circumvent normal filters
In depth help pages available to all operators in game
A spam filter that you can turn on or off
Global mutes which prevent everyone that does not have permission from speaking
The ability to set what a player sees when they log in and what the server sees when a player logs in
You can now send coloured messages to chat and create coloured mute reasons, spam warnings, broadcasts, player join messages and server join messages.

Commands(caps do not matter):

As of version 1.4 colour tags can be used for anything involving a message:

You can either use /CC OR /CleanChat

/CC <page number> OR /CleanChat <page number> : Shows the specified Clean Chat help page which gives in depth assistance on all clean chat commands.
/Mute <playername> <reason> <hour(s)> <minute(s)> <second(s)> : Mutes the specified player for a particular duration, if they are online. If you do not give a reason a default reason can be set which will be given instead.
/UnMute <playername> : Unmutes the specified player if they are online.
/GlobalMute : Mutes all of chat except yourself and as of version 1.2 anyone who has permission to speak, so that you can talk uninterrupted.
/SetMuteReason <reason> OR /smr <reason>: Sets the default mute reason.
/CC ReplaceWith <phrase or words>: Set what a players abusive message is replaced with.
/CC AddWord <word>: Add a word to the banned list of words.
/CC RemoveWord <word>: Remove a word from the banned list of words.
/CC PrintConsole <true/false>: Enable or disable clean chat notifying the server console when a player uses a banned word.
/BannedWords : Displays all the currently banned words, by default this plugin comes with a few, check them out once you download it and remove any you don't need/want.
/History <player name> : This command shows the mute history of the specified player.
/ClearHistory <player name> : This command clears the mute history of the specified player.
/Broadcast <message>: This command broadcasts a message to the entire server. To colour it insert colour tags.
/AddBroadcast <hours> <minutes> <seconds> <message>: Create a repeating broadcast that will repeat after the specified time.
/RemoveBroadcast <message>: Removes the broadcast with the specified message. This message must be identical to the broadcasted one. If your unsure on what the broadcasted message is, simply type /broadcastList which will give you all the scheduled broadcasts.
/BroadcastList : Displays all the broadcasts currently scheduled on your server.
/cc SpamCheck : Toggle whether or not the spam checker is on.
/cc SpamWarning <message> : Set the message players see when they spam chat
/ToggleBroadcasts :Toggle whether or not you want to see server broadcasts. By default anyone can use this.
/ColourTags <page number> : Displays all colour tags that can be used to customize your messages.
/ClearServerChat : Clears every online player's chat.
/ClearChat : Clears the users chat. By default anyone can use this.
/cc SetPlayerJoinMessage <message> : Sets the message a player sees when they log in. The special #name tag can be used to get the players name and put it in your message.
/cc SetServerJoinMessage <message> : Sets the message all online players see when a player joins the server. The special #name tag can also be used here.

Permissions (as of version 1.4):

By default every operator has all of these permissions

CleanChat.* :Gives the specified player(s) permission to use all Clean Chat commands.
CleanChat.ManageFilter : Allows access to all of the Clean Chat filter management commands. (All of the commands which begin with /cc).
CleanChat.Mute : Allows access to the /Mute command.
CleanChat.UnMute : Allows access to the /UnMute command.
CleanChat.GlobalMute : Allows access to the /GlobalMute command.
CleanChat.SetDefaultMuteReason : Allows access to the /SetMuteReason command.
CleanChat.BannedWords : Allows access to the /BannedWords command. By default everyone has this permission.
CleanChat.GlobalMuteSpeak : This permission allows the specified players to speak during a global mute.
CleanChat.History : This permission allows the use of the /history command.
CleanChat.ClearHistory : This permission allows the use of the /clearhistory command.
CleanChat.Broadcast : This permission allows the use of the /broadcast command.
CleanChat.ClearChat : Allows the use of the /ClearChat command. By default everyone has this.
CleanChat.ClearServerChat : Allows the use of the /ClearServerChat command.
CleanChat.ColouredMessages : Allows the use of the special tags that customize your messages and the /ColourTags command.
CleanChat.ToggleBroadcasts : Allows the use of the /ToggleBroadcasts command. By default anyone can use this.

Colour Tags

The /ColourTags command can be used in game to see this list

Insert these in front of your messages to customize them in the anyway you choose. They can be combined together but the colour must always come first.

#o - bold
#u - underline
#i - italic
#m- magic (loads of squiggly characters, try it out in game)
#p - light purple
#dp- dark purple
#dr- dark red
#r - red
#ck - black
#d1 - dark grey
#1 - grey
#b - blue
#w - white (white if you can't see it)
#da - dark aqua
#a - aqua (aqua if you can't see it)
#g - green
#ld - gold
#dg - dark green
#db - dark blue
#y - yellow (yellow if you can't see it)
#s - ~~strikethrough~~
#es - reset (basically resets the colour back to white)
#name - A special tag that can be used in the /cc setPlayerJoinMessage and /cc setServerJoinMessage commands to put into your message the name of the player who just joined. For example: A player join message that said "Welcome to the server #name" would actually display when the player logged in "Welcome to the server (whatever the player's name is)".

If you have any recommendations or requests please feel free to comment below.

Comments

Skittlez
- Join Date: 1/17/2025
- Posts: 2
- Member Details
#12 Skittlez

View User Profile

Send Message

Posted Jan 17, 2025
DO NOT DOWNLOAD THIS PLUGIN, it is not maintained, and it will linger after deleting. the plugin also adds things edited from the config file back in -.-

Rollback Post to Revision RollBack
RedFnx
- Join Date: 7/14/2018
- Posts: 3
- Member Details
#8 RedFnx

View User Profile

Send Message

Posted Jul 14, 2018
I got this plugin and it worked really well, but i decided to delete one of my broadcasts and now i can't! I went to the config and deleted it, and when i came back IT WAS THERE AGAIN!!! I did this like 20 times then got mad and deleted the whole plugin. With the plugin deleted i restarted my server AND BROADCASTS WERE STILL GOING!!! HOW DO I FIX THIS?! I cant make my server public like this!!!

Rollback Post to Revision RollBack
likemoneysecretly
- Join Date: 3/31/2017
- Posts: 5
- Member Details
#9 likemoneysecretly

View User Profile

Send Message

Posted Aug 3, 2018
In reply to ansonfry:

I'm sorry that you are currently facing this issue. Could you please specifiy which version of craftbukkit you were using. It is highly likely that this is an issue with a newer version of craftbukkit not integrating correctly with this plugin that was overlooked in the testing period before release.

Sorry again for your trouble with this issue

- Silence__

EDIT: Could you please also give me a list of the plugins you are running on your server at the time of the bug. Also did you delete it in the recommended fashion shown below in reply to another comment?

Last edited by likemoneysecretly: Aug 3, 2018

Rollback Post to Revision RollBack
SilverHealer
- Join Date: 5/23/2018
- Posts: 1
- Member Details
#7 SilverHealer

View User Profile

Send Message

Posted May 23, 2018
Quetion can you make this plugin easyer to use? for the anti spam. I cant get it to stop saying do not spam. after 2 msgs,

Rollback Post to Revision RollBack
likemoneysecretly
- Join Date: 3/31/2017
- Posts: 5
- Member Details
#10 likemoneysecretly

View User Profile

Send Message

Posted Aug 3, 2018
In reply to AlphaWolves12:

Could you please clarify what your issue is. After two messages does it warn you not to spam and you don't like this? Or would you like to ability to determine how many messages a player is allowed to send before it is classified as spamming?

Rollback Post to Revision RollBack
Forge_User_96799397
- Join Date: 11/25/2017
- Posts: 6
- Member Details
#4 Forge_User_96799397

View User Profile

Send Message

Posted Nov 25, 2017
How to delete all broadcast

Rollback Post to Revision RollBack
likemoneysecretly
- Join Date: 3/31/2017
- Posts: 5
- Member Details
#5 likemoneysecretly

View User Profile

Send Message

Posted Dec 21, 2017
In reply to Forge_User_96799397:

It is possible to delete all current broadcasts by deleting all of the terms in the Broadcasts array in the config file. Remember to delete all of them and leave this [] in their place so that you can still add more broadcasts and the server does not throw up an error.

It is recommended to do this after stopping the server as it will not work whilst the server is running.

Last edited by likemoneysecretly: Aug 3, 2018

Rollback Post to Revision RollBack
ChillSlash
- Join Date: 5/17/2017
- Posts: 1
- Member Details
#1 ChillSlash

View User Profile

Send Message

Posted May 17, 2017
How to clear SetServerJoinMessage and SetPlayerJoinMessage if I don't want it?

Rollback Post to Revision RollBack
likemoneysecretly
- Join Date: 3/31/2017
- Posts: 5
- Member Details
#3 likemoneysecretly

View User Profile

Send Message

Posted May 17, 2017
In reply to ChillSlash:

Good point, thank you for your reply concerning this issue. At the moment your best hope is to write a Server join message that looks like the original minecraft one. However, (in version 1.5) I will make sure to include into the update (coming out latest next weekend) the ability to disable specific features of the plugin. This can already be done with the spam filter, but as I now see, it needs to be done with everything.

Thanks for your reply

- Silence__

Last edited by likemoneysecretly: May 17, 2017

Rollback Post to Revision RollBack
likemoneysecretly
- Join Date: 3/31/2017
- Posts: 5
- Member Details
#11 likemoneysecretly

View User Profile

Send Message

Posted Aug 3, 2018
In reply to Silence__:

Now that this plugin is back in active development I will look into perhaps adding the disable feature. I will note that you could just set the serverjoinmessage and the playerjoinmessage to a space and the player will effectively see nothing. I think that should work otherwise the disable feature will probs be coming in the next update.

Last edited by likemoneysecretly: Sep 24, 2020

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.