AUTOMATICALLY Replace swear words in chat with other words of your choice!

(Imagine the following, but without the * s)

Player types:
"F* you."

Plugin changes message to:
"[Whatever you've told it to replace "f*" with] you."

Are you like me, in that you see people who constantly swear as utterly delinquent or juvenile? Well this plugin is for you! You can make them seem like complete fools by replacing their cusses with ridiculous other statements or words! xD

One of the funniest uses of this plugin so far was on my server, some guy came on, clearly just to insult the server and all admins, and he said something rather vulgar. My plugin corrected him, and he came out as having said:

"Engage with my Male Chicken you Cigarette!"

I'll leave you to figure out what he actually said..


  • /swear add [WordToBeReplaced] [WordToReplaceItWith]
    Adds a new word to be replaced, and its replacement to the replacement dictionary. Note with this, you can only add ones with multiple words in the config. With the in-game commands, you can only use single words for each.
  • /swear remove [WordBeingReplaced] [WordReplacingIt]
    Removes a word and its replacement from the replacement dictionary
  • /swear change [WordBeingReplaced] [WordReplacingIt] [NewOrSameWordToBeReplaced] [NewOrSameWordToReplaceIt]
    Changes that entry in the replacement dictionary to whatever you put in the last 2 fields.
  • /swear help
    Shows plugin help if you're stuck :)


  • swearreplacer.manipulate
    Allows full usage of the plugin.

The replacements I talked about above aren't in the config by default. You have to put in your own. However I will post a link to my config here soon if you want to get all my approximately 100 replacements that I've added.


  • Add ability to add colored replacements
  • Add ability to define punishments on individual words (like lightning strike for example)
  • Add a configurable option for it to differentiate between words on their own and words connected to other words.
  • Make the plugin understand "_"s as spaces so you can add multiple word replacements in-game

If you have any funny experiences with imbeciles coming on your server, spouting vulgar drivel and then this plugin wreaking havoc on their messages, please do post below!

I'd also just like to thank woutwoot for helping me get started with Bukkit and Java. He is the reason I was able to develop the skills to make this plugin for you guys in the first place.

By the way, if you see me on Minecraft do say Hi! (My Minecraft name is Warby579) :)

Any questions? Post them in the comments below and I'll try and respond :D

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

  • Avatar of smoothie321 smoothie321 Apr 27, 2015 at 11:53 UTC - 0 likes

    Hello, how do I stop a word from changing like class? whats the command? Like I want you to say class and not clHi but, Class

  • Avatar of erdrickk erdrickk Apr 06, 2015 at 15:34 UTC - 0 likes

    Will this plugin catch things like:

    If I sensor "lag" and change it to "awesome" and someone types Village will it come out as Vilawesomege ??

    Most of the text replace plugins have this problem. I have yet to find one that actually works

  • Avatar of martijnpold martijnpold Mar 14, 2015 at 19:34 UTC - 0 likes

    @Reece117: Go

    Thats a very specific problem, how many times do you have to say shital in your life

    for (int i = 0; i < 1000; i++) {
        System.out.println("I luv cookies");
  • Avatar of Reece117 Reece117 May 01, 2014 at 14:36 UTC - 0 likes
    • Works in 1.7.+
    • No errors
    • FINALLY!

    Great plugin, works fine this is exactly what I've been looking for. however you could improve by adding a word white-list here is what I mean:

    I replaced "shit" with "poo" but say if someone says "Shital" it would come out as "pootal" So It would be great if you added something new like

    /swear whitelist Shital

    So people can say "shital (thats a name in india lel)" instead of the outcome being "pootal"

    Last edited May 01, 2014 by Reece117
  • Avatar of DivinePhoenix DivinePhoenix Feb 05, 2014 at 00:58 UTC - 0 likes

    Can you PLEASE add the ability to use color codes with this plugin so that the swear words can be in colors? Thanks!

  • Avatar of puckman1971 puckman1971 Nov 02, 2013 at 07:09 UTC - 0 likes

    Ok, I made a jap to Japanese replacer rule but when people type japanese they now get japaneseanese

  • Avatar of puckman1971 puckman1971 Nov 02, 2013 at 06:58 UTC - 0 likes

    Ok, now restarting does not even seem to work.

  • Avatar of puckman1971 puckman1971 Nov 02, 2013 at 06:21 UTC - 0 likes

    Nice, just what I was looking for. One thing though. I can add via the game with the /swear ad command but those words don't show in the config file and words added in the config file don't work in the game. restarting the whole server seems to merge them but that is rather silly.

    Last edited Nov 02, 2013 by puckman1971: Added info.
  • Avatar of Jnaejnae Jnaejnae Sep 30, 2013 at 06:04 UTC - 0 likes

    I used this plugin so whenever somebody says awesome it will replace it with my username. LOLOLOLOLOLOLOL!

    Last edited Sep 30, 2013 by Jnaejnae
  • Avatar of kezzawozza kezzawozza Sep 26, 2013 at 01:32 UTC - 0 likes

    Hi, just adding here too, cos I do like your plugin idea a lot and I'm hoping to be helpful if it can be fixed, is this: the only way I have found (I've kept trying!) to make it use my replacements, is by removing the default ones in game before adding new; that seems to work, but I don't know yet if it's going to stick. But the trouble with that is it won't allow phrases in game; no spaces at all. So I can't replace your phrase jesus christ, for example, and I can't put in anything but single words. That's a real shame; I had some rippers ready!


Date created
Apr 06, 2013
Last update
Apr 06, 2013
Development stage
  • enUS
All Rights Reserved
Curse link
Recent file