Chat Filter

Running a family server? Fed up of griefers not only griefing your world - but your chat too?
Then you need new ChatFilter!

ChatFilter lets you set up a list of trigger words that, when matched in chat will cancel the message and send the player a custom message, be it a warning or just a friendly nudge. It can even kick offenders if required.

ChatFilter offers both part and whole word matching options, so you can block messages very intelligently.

You can also set up a list of words to trigger a custom server broadcast.

Just download - run once - and then edit lang.yml to setup your filter words and trigger phrases.

ChatFilter is a lightweight plugin for when you want a simple solution for controlling swearing on your server.

You can see the default settings here . Warning contains the swear words that trigger warnings.

Current Version: 1.7.2


kick: [true|false] Set to true to kick players who swear.

showInConsole: [true|false] Show player's name and the offending message in console.

censor: [true|false] Censor messages instead of blocking entire message.

agressiveMatching: [true|false] Attempts to match more words by looking for 3=e 0=o etc.

Edit lang.yml (created on first run) to change the trigger words and notification text.


/ChatFilter reload
Reload settings from lang.yml


Allows user to reload.

Allows users with this node to bypass filters.

Users with this node cannot chat.

Users with this node can chat.


1.7.2: Changed permissions node for chat to chatfilter.canchat

1.7.1: Fixed config typo

1.7.0: Aggressive matching option. Permissions node to block chat completely.

1.6.0: Permissions node for reload. Colour support.

1.5.0: Permissions node to allow select users to swear.

1.4: Optional censorship mode. Replaced words with configurable text.

1.3: Config options to enable whole word matching.

1.2: Option to display information about blocked messages in console.

1.1: Added kick option.

1.0: First release.

Source Code


Donations of any amount are, of course appreciated :)

Contributions go towards maintaining my development server to encourage continued development. ChatFilter is solo coded by me so if you think that time is worth something then hit the button in the top right! ;)

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

  • Avatar of jjkrause jjkrause Mar 24, 2014 at 06:49 UTC - 0 likes

    @SableDnah: Go

    Its not being run from a command block.... being run from the console by plugins such as ServerSigns or Craftbook.

    Last edited Mar 24, 2014 by jjkrause
  • Avatar of SableDnah SableDnah Mar 23, 2014 at 17:18 UTC - 0 likes

    @jjkrause: Go

    Have you tried "/gamerule commandBlockOutput false" ?

    "All this technology and it still takes forever to get anywhere"

    Mob Health

    MobHealth: Simple plugin to let you know the damage you just caused to a mob, and how much health it has left. [ Donate ] [ Twitter ]

  • Avatar of jjkrause jjkrause Mar 23, 2014 at 15:41 UTC - 0 likes

    @SableDnah: Go

    The example I gave you was a direct message yes... but there are others that appear for everybody, such as [CONSOLE: Given JUMP ( ID 8 ) to JasonKrause for 30 seconds] when using the effect command from console... If I could block everything starting with certain words, that would be awesome!

    In the above example, I could block "[CONSOLE: Given*" and that would block all effect commands.

    Last edited Mar 23, 2014 by jjkrause
  • Avatar of SableDnah SableDnah Mar 20, 2014 at 16:38 UTC - 0 likes

    @jjkrause: Go

    Thats a direct message to the player - not broadcast chat.

    I could add a list of entire sentences to look out for tho and block those.. will see what i can do.

  • Avatar of SableDnah SableDnah Mar 20, 2014 at 16:37 UTC - 0 likes

    @MURD3RUS: Go

    That would be awesome, but hard - at the moment the same message is sent to "broadcast" chat. I'd have to block that if there was a swear and instead manually message each player the filtered or unfiltered test. Its a bit of a hack - and would break a lot of other chat plugins as they would no longer be "chats"... but its a great idea so i will think on it further.

  • Avatar of jjkrause jjkrause Mar 20, 2014 at 16:31 UTC - 0 likes

    I'm looking for a filter program that will remove text generated by commands. Example: I have a command block that clears a person's inventory using /clear @p -a. In that person's chat, he sees "Your inventory has been cleared by @". Would it be possible to filter any output from any commands?

  • Avatar of MURD3RUS MURD3RUS Mar 20, 2014 at 08:11 UTC - 0 likes

    Can you add a permission so, only certain people can SEE swears??  That'd be really fresh.

    Last edited Mar 20, 2014 by MURD3RUS
  • Avatar of Jobsti2 Jobsti2 Feb 25, 2013 at 16:58 UTC - 0 likes

    Doesn't work with herochat anymore.

    Any plans for updating this great plugin?
    Survival Server X-rated, Hard. Since Alpha 1.1!
    How to run and configure a Minecraft Server with Bukkit (WIP) German,

  • Avatar of SableDnah SableDnah Jan 04, 2013 at 15:21 UTC - 0 likes

    @Krevex: Go

    Yeah - chatfilter grew out of an easter egg in MobHealth till it got its own plugin.

  • Avatar of Krevex Krevex Dec 14, 2012 at 02:03 UTC - 0 likes

    Plugin works great with towny. Nice work, something i found in the plugin.yml though made me laugh =)

    chatfilter.*: description: Gives access to all MobHealth commands/functions. children:


Date created
Feb 07, 2012
Last update
Mar 16, 2014
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files