ChatReplace - modify chat messages using regular expressions.

ChatReplace is plugin for the Minecraft wrapper Bukkit that provides a method for administrators to reactively modify chat on a server through matching regular expressions. You could use this to match undesirble words and change them into less offensive ones or censor them completely. Alternatively you could use the plugin to create simple roleplay themed events or enforce a particular style of language on a server.


  • Simple and easy to configure.
  • Match messages using powerful regular expressions.
  • Randomly chooses a replacement for each match from the list attached to each pattern.


Ensure you are using the latest recommended build.

Before installing, you need to make sure you are running at least the latest recommended build for Bukkit. Support is only given for problems when using a recommended build. This does not mean that the plugin will not work on other versions of Bukkit, the likelihood is it will, but it is not supported.


  1. Configure your settings (config.yml) and choose what type of replacement you want to do.
  2. Add patterns that you want match to the respective configuration file.
  3. Configure permissions if necessary.

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

  • Avatar of TVExtrem TVExtrem Dec 03, 2013 at 20:25 UTC - 1 like

    Pls update! :)

  • Avatar of Redletteredition Redletteredition Sep 18, 2012 at 15:58 UTC - 0 likes

    @grandwazir: Go

    How do you put that into the substitution file?

  • Avatar of Redletteredition Redletteredition Sep 18, 2012 at 15:57 UTC - 0 likes

    @GlabbichRulz: Go

    Definitely Nodus

  • Avatar of Redletteredition Redletteredition Sep 18, 2012 at 15:52 UTC - 0 likes

    Hi guys, I really like the idea of this plugin but I ran a test on our server and it didn't work. Can you tell me what I'm doing wrong? Here is what I put in the substitution file:

    Sorry the format was no good so look at this pastie:

    example-pattern: pattern: [Hitest] replacements: - Hi all - Hello

    This is the Config.yml

    debugging: false formatters: append: false substitution: true

    Thanks in advance

    Last edited Sep 18, 2012 by Redletteredition
  • Avatar of Mrcomputeranswers Mrcomputeranswers Sep 07, 2012 at 02:50 UTC - 0 likes

    @GlabbichRulz: Go

    I do believe this is a feature of the hacked client, nodus. Correct me if I am wrong..

    Kenny VFX Artist/Director/Developer [email protected] BFAK:kennylax12,90608164,6561ace513693b2e7eb9c146a5659b013c12783e278c6d5af213e31fb08a17a7

  • Avatar of grandwazir grandwazir Aug 07, 2012 at 07:13 UTC - 0 likes

    @MegaNarwhal: Go

    Yup. Just put in the right expression to capture it and you can strip out advertising on your server. The following would filter out most web addresses for example: ^((https?\:\/\/)?([\w\d\-]+\.){2,}([\w\d]{2,})((\/[\w\d\-\.]+)*(\/[\w\d\-]+\.[\w\d]{3,4}(\?.*)?)?)?)$

    Last edited Aug 07, 2012 by grandwazir
  • Avatar of MegaNarwhal MegaNarwhal Aug 02, 2012 at 17:53 UTC - 0 likes

    Can this filter web addresses and ip addresses?

    Owner of BlockBox

  • Avatar of grandwazir grandwazir Jul 30, 2012 at 00:20 UTC - 0 likes

    @Lukethenuke: Go

    I use it on my server to replace swearwords with things like 'kittens'. Regular expression support allows you to easily foil many of the usual work arounds.

  • Avatar of grandwazir grandwazir Jul 30, 2012 at 00:19 UTC - 0 likes

    @Heruux: Go

    You should be able to use capture groups? I think I have a couple in my medievil speech script. Reload command is in the latest version.

    @GlabbichRulz: Go

    You have to edit the yml manually.

  • Avatar of Heruux Heruux Jul 05, 2012 at 23:30 UTC - 0 likes

    Would be nice with a command to reload the substitution.yml file or the whole plugin. Support for capture groups would also be a great addition if possible.


Date created
Nov 27, 2011
Last update
Aug 08, 2012
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files