Logo CensorIt

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 <u>Other</u> plugins to censor many different things involving text like signs, whispers, shouts (these features are not included in this simple plugin).


  1. Get the latest recommended build of CraftBukkit here.
  2. Download file CensorIt.jar and place it in your Plugins subfolder
  3. Start the server once and stop it.
  4. Go in folder Plugins\CensorIt
  5. Open file censored.txt and add the words that you want to censor. It is suggested to modify these files in Notepad++.
  6. Optional : Open file allowed.txt and add the words that you want to prevent from being censored. (e.g. assassin, grass, glass)
  7. 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)
  8. Start your server


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. gr<span style="color:red">ass</span>, <span style="color:red">assass</span>in)
  • /censorit replace|unreplace - Add or remove a replacement word. (e.g. bird, flower)

How to connect to the API from your plugin

  1. Add an external reference to CensorIt.jar
  2. Modify your onEnable event to verify if the CensorIt plugin is present like so : getServer().getPluginManager().isPluginEnabled("CensorIt")
  3. In the class you want to use the API in, import com.worldcretornica.censorit.CensorItAPI
  4. 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.
  5. 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.


Version 0.1
  • Initial release

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

  • Avatar of MineFun98 MineFun98 Jul 15, 2014 at 18:44 UTC - 0 likes

    Please Update!

  • Avatar of RIPtli08 RIPtli08 Jun 25, 2014 at 15:25 UTC - 0 likes

    people can still swear witch color codes, like &fN&fo&fo&fb
    is there a way to patch that? cuz ive tryed add &fN&fo&fo&fb and §fN§fo§fo§fb but it wont work, any sugestions how to patch that?

  • Avatar of Ryex95 Ryex95 Jun 24, 2014 at 12:54 UTC - 0 likes

    Can you add an option in the config to replace words by default? When I restart the server I always have to run the command /censorit replaceon

  • Avatar of LeeTheENTP LeeTheENTP Jun 18, 2014 at 19:14 UTC - 0 likes

    Although I've added some words to the allowed list, like "hello" and "grass," they still seem to be censored. Once I turn online verification on, however, the words are no longer censored.

    Any fix?

    Don't let anyone look down on you because you are young, but set an example for the believers in speech, in life, in love, in faith, and in purity.
    - 1 Timothy 4:12

    Murica Gaming: muricagaming.com

  • Avatar of TraedpoD TraedpoD Jun 04, 2014 at 19:19 UTC - 0 likes

    @sir_brando: Go

    I've spoken with the creator of this plugin. He holds an excellent point. He says that there's no way to make a 100% censor. If you think about, no matter what game you're playing, you can always find a way to bypass. In the end, this plugin does all it can, and a good job at that!

  • Avatar of sir_brando sir_brando May 15, 2014 at 05:59 UTC - 0 likes

    @TraedpoD: Go

    I tried to find a way to fix it, with no luck. Although if any of my users get around the censor they get muted, jailed or banned, so typically I don't worry about it much. There are other unusual characters they can use to get around the censor as well, and with color codes. These things will have to be fixed by an update for the plugin. I'm not sure if the creator will work on this anymore though. I enjoy the plugin despite the minor issues though. Will continue to use it.

    Last edited May 15, 2014 by sir_brando
  • Avatar of TraedpoD TraedpoD May 12, 2014 at 06:11 UTC - 0 likes

    There is a major exploit. Placing an exclamation mark in the middle of a word prevents that word from being appropriately censored. It completely bypasses.

  • Avatar of sir_brando sir_brando Apr 14, 2014 at 02:37 UTC - 0 likes

    @Morini999: Go Do not use any punctuation in the words, or symbols and numbers possibly. It will break the list.

    @BlockChunkWorld: Go I can confirm this works with 1.7

    Last edited Apr 15, 2014 by sir_brando
  • Avatar of BlockChunkWorld BlockChunkWorld Apr 11, 2014 at 02:22 UTC - 0 likes

    Whens this going to be 1.7? Or is it for all versions?

    Last edited Apr 11, 2014 by BlockChunkWorld: Idk :P
  • Avatar of Morini999 Morini999 Mar 09, 2014 at 10:21 UTC - 0 likes

    I have this great plugin of yours but every time I reload my server the word lists wipe themselves. Could you help me please?


Date created
Oct 17, 2011
Last update
Aug 09, 2012
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: v0.3 for CB 1.4.7-R0.1 Aug 09, 2012
  • R: v0.2 for CB 1.2.5-R1.0 Mar 03, 2012
  • R: v0.1 for CB 1.1-R4 Oct 22, 2011