CensorIt - Bukkit

How to use video by Samkio and Torrent

Tired of people cursing on your server and reading their immature messages or what they think of your family? Search no more! CensorIt is the plugin for you. CensorIt has been specifically designed to remove unwanted words no matter how they are spelt, let it be with special characters, repeated characters, spaces or capitals!

The plugin contains a list of censored words and a list of allowed words. This way you can censor for example ass without censoring glass, assassin, grass, etc. You only need to add the normal form of the word in lower case. For example if you censor only ass, the plugin takes care of preventing ass, AsS, @$$, a ss, a.ss, a s s or a_s_s.

The plugin also has a learning function with which verifies online for the existence of a word and automatically adds them to the allowed list. It makes censoring a little slower at first, but as words are added automatically to the allowed lists it will become faster.

The plugin also contains a public API which can be used by Other plugins to censor many different things involving text like signs, whispers, shouts (these features are not included in this simple plugin).

Installation

Get the latest recommended build of CraftBukkit here.
Download file CensorIt.jar and place it in your Plugins subfolder
Start the server once and stop it.
Go in folder Plugins\CensorIt
Open file censored.txt and add the words that you want to censor. It is suggested to modify these files in Notepad++.
Optional : Open file allowed.txt and add the words that you want to prevent from being censored. (e.g. assassin, grass, glass)
Optional : Open file replacement.txt and add the words that you want to use as replacement words when /censorit replaceon is active. (e.g. cloud, hug, happy)
Start your server

Commands

General commands (require CensorIt.word and/or CensorIt.admin permissions)

/censorit config - List configuration commands.
/censorit word - List word management commands.

CensorIt.admin commands

/censorit enable - Server-wide enable censoring.
/censorit disable - Server-wide disable censoring.
/censorit reload - Reload configuration.
/censorit verify - SLOW! Verify words online (added to allowed list). Currently using http://dictionary.cambridge.org/ dictionary. Other plugins can change this property through the API.
/censorit unverify - Stop verifying words online.
/censorit replaceon - Enable word replacement (e.g. bird, flower).
/censorit replaceoff - Disable word replacement.

CensorIt.word commands

/censorit censor|uncensor - Censor or uncensor a word. (e.g. ass, fuck)
/censorit allow|unallow - Allow or unallow a word. (e.g. grass, assassin)
/censorit replace|unreplace - Add or remove a replacement word. (e.g. bird, flower)

How to connect to the API from your plugin

Add an external reference to CensorIt.jar
Modify your onEnable event to verify if the CensorIt plugin is present like so : getServer().getPluginManager().isPluginEnabled("CensorIt")
In the class you want to use the API in, import com.worldcretornica.censorit.CensorItAPI
You do not need to instantiate the API, it is a static class and contains the same configuration as other plugins. Just type CensorItAPI.something to get the list of available commands.
Basic usage : use the function CensorItAPI.censor(string) to receive the string censored

Things to do

Save the censoring state configurations : verify, enabled, replace words. Currently only the word lists are saved.
Add option to color censored words/replacement words.
If possible, need to find a way to disable censoring for the current player. Best would be to leave this to other plugins to implement. If someone has a suggestion on how to implement this without breaking other plugins please tell me how.
Check for 8 used as a b and () used as an o
Fix incompatibility with SpamHammer. Censored text don't count as spam for some reason
Put option to censor IPs
Add other charset support (e.g. russia). I thought they would already work but I've been told otherwise.

Changelog

Version 0.1

Initial release

You must login to post a comment. Don't have an account? Register to get one!

81 comments
1
2
3
4
5
6
7
8
9
Next →

- Reply
- #82
GamingMania Apr 17, 2013 at 02:53 UTC - 0 likes
can u plllllzzz make it so when somebody says a censored word a certain amout of times it excecutes a command ex. I say ass 5 times and get muted or I say fuck 10 times and get bannedPlz that would make this the best censoring plugin ever!
- Reply
- #81
zachbora Apr 14, 2013 at 03:51 UTC - 0 likes
@Panjinatof: Go

yeahhh about those planned things... I don't have time and I don't feel the need at the moment to do them.

If anyone wants to continue this plugin (I'll still update it if it stops working) just give me a shout and I'll add you.
- Reply
- #80
zachbora Apr 14, 2013 at 03:50 UTC - 0 likes
@Brangspears: Go

No need, it works in 1.5.1
- Reply
- #79
Brangspears Apr 14, 2013 at 01:23 UTC - 0 likes
Update Pleaseeeee
- Reply
- #78
Panjinatof Apr 04, 2013 at 02:43 UTC - 0 likes
Its nice that your implementing the ip censor, but can u see if you can add caps as well? That would he awesome because this plugin is great :D
- Reply
- #77
Wizardofdoom Mar 30, 2013 at 23:29 UTC - 0 likes
This a great plugin, but it's not smart enough. I censored noob, I type in a lot of ways to say noob. When I said it like N()()B It is censored, but when I say N@0B it isn't. should I just block these words?
- Reply
- #76
zachbora Mar 28, 2013 at 18:13 UTC - 0 likes
@Crazykool5: Go

It's not abandoned, it just still worked from all this time.

Could you elaborate on how this breaks because of Vault?
- Reply
- #75
Crazykool5 Mar 28, 2013 at 17:40 UTC - 0 likes
It breaks with the newest version of Vault. A question: Is this plugin abandoned?
- Reply
- #74
jrdmetsfan Feb 22, 2013 at 17:00 UTC - 0 likes
When I censor a word that is in a sentence, it screws up the sentence. For example 'what the hell' turns into 'whathe #&%$'

Last edited Feb 22, 2013 by jrdmetsfan
- Reply
- #73
oliverkeen77 Feb 15, 2013 at 23:09 UTC - 1 like
Wow, great plugin. It would be even better if players could add a word to censor but optionally could include a corresponding word. For example, I want to replace "ass" with "butt," so I would type /censorit add ass:butt. Now when I type "ass" it says "butt." If I don't want a corresponding replacement word, it would just say the normal &%#. So I would just type /censorit add ass. So the command layout would be like this: /censorit add <word>:[replacement]. Thanks. :)

Server: keencraft.zapto.org Personal Website