bChatManager - The easy to use chat manager for bukkit

What is this?

bChatManager is an easy to use chat plugin for bukkit. Now supporting any plugin that works with vault, it has a number of features such as:

  • Supports most plugins that provide prefixes
  • Intuitive messaging format based off the twitter @messaging system
  • Factions support

bChatManager was originally forked off the PEX ChatManager, so users coming from pex may vaguely recognise the config file. (even though I completely reworked it)

Installation and Usage


  • Vault
  • Craftbukkit


Once you've installed the plugin (which I'm not going to go into here, if you can't put a jar file in a folder then god help you), you may want to configure it. Here is the default config.

    message-format: '%prefix %player: &f%message'
    local-message-format: '[LOCAL] %prefix %player: &f%message'
    personal-message-format: '[MSG] [%player -> %reciever] &f%message'
    op-message-format: '&c[OPS ONLY] %player: &f%message'
    me-format: '* %player %message'
    control-me: true
    ranged-mode: false
    special-features: true
    chat-range: 100.0


  • message format: Format of a global chat message
  • local-message-format: Format of a local chat message.
  • personal-message-format: Format of the @messaging messages
  • me-format: Format for /me
  • op-message-format: Op only message format


  • control-me: Toggle whether bChatManager should handle /me
  • ranged-mode: Toggles local messages. Doesn't work with chat channels.
  • special-featues: Toggles whether @messaging and !global messaging in local chat should be enabled,


  • chat-range: If local chat is enabled, this sets how far the players can speak

Special Chat Functions

  • !message - Sends a message globally. Only useful in ranged mode.
  • @playername message - Sends a private message to another player on the server. Can autocomplete the name, so if you have someonee called "OmG_CoMpleX1234" you could just do @omg message to message them. You can also message ops with @ops message.

Formatting Placeholders

  • %message - Message text
  • %player - Player's name
  • %prefix - Player's prefix
  • %suffix - Player's suffix
  • %group - Player's group
  • %world - World the player is in
  • %mvworld - Multiverse formatted world tag. Requires bChatManager 3.1 and Multiverse core
  • %faction - the faction the player is in. Requires factions 2.0
  • %displayname - displayname of the player. USE THIS FOR ESSENTIALS NICKS
  • Colors you can use - http:www.minecraftwiki.net/wiki/Classic_server_protocol#Color_Codes for the colors. Alternatively, try this site - http://buildworx-mc.com/bukkitColor/
  • &l - bold text
  • &m - striked text
  • &n - underlined text
  • &o - italic text

Permissions nodes

  • bchatmanager.chat.global - allows you to use global chat in local chat
  • bchatmanager.chat.color - allows you to color chat
  • bchatmanager.chat.message - allows you to @message someone
  • bchatmanager.spy - 1.3.2 feature, allows you to hear all PM's and local messages


  • /me <message> - the /me command
  • /bchatreload (must have the permissions bchatmanager.reload or be op) - Reloads bChatManager

Why did you remove the chat channels?

The way I had implemented chat channels was terrible. It was buggy, the code was convulted and messy, and I really should't have released it. Chat channels have therefore been removed from bChatManager 3.0 until I can implement them in a more robust fashion.


I like knowing people are using my plugin, so I have a anomynous plugin stats tool called MCStats built into bChatManager. if you wish to disable it, find the PluginMetrics folder in your plugins folder and edit the config.yml to disable the stats :). If you wish to see these stats, they are publically avaliable https://mcstats.org/plugin/bChatManager. All the information there is the information that gets sent. Nothing else.

Video Tutorial (Thanks to BukkitTeacher)


Latest version is 3.0. Download from http://dev.bukkit.org/bukkit-plugins/bchatmanager/files/19-bchat-manager-3-0/ today!

Development builds of this project can now be acquired at the provided continuous integration server located at http://build.rymate.co.uk:8080/ These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Source code!

My github is at https://github.com/rymate1234/bChatManager Feel free to fork me :P

The bottom bit

Any suggestions on how I can improve this plugin? Post in the comments! And if you need any help, also feel free to post on the forums section of this :)

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

  • Avatar of zaap01 zaap01 Apr 19, 2014 at 12:12 UTC - 0 likes

    Update it to 1.7.2, its perfect !

    mcelite.servegame.com | mce.zapto.org | Dev Phase - Plugin Test Server

  • Avatar of ManBeastPigDev ManBeastPigDev Apr 11, 2014 at 09:09 UTC - 0 likes

    Any chance of a UUID %name" variable?

    Crafty Creeper Party Server

  • Avatar of rymate1234 rymate1234 Mar 02, 2014 at 21:04 UTC - 0 likes

    @mc_RROD: Go

    So you'd rather have every developer who wants to support more than one permissions system use a custom implementation for every plugin, rather than have one central plugin to do all the heavy lifting for them?

    Lets put it another way - would you rather every windows develop come up with their own UI toolkit, rather than using the one windows provides?

    Seriously, it just seems like such a nitpicky little detail, especially when Vault is only 314.4 KiB and probably uses barely any ram.

  • Avatar of mc_RROD mc_RROD Mar 02, 2014 at 20:20 UTC - 0 likes

    Can we please have "Vault support" optional? It really is a silly and unwanted dependency of mine, which is being used more and more by plugin authors who are trying to be lazy.

  • Avatar of nostalgicbadger nostalgicbadger Feb 22, 2014 at 21:10 UTC - 0 likes

    For some reason, the /me command is appearing twice for whomever sends it, even though everyone else sees it once. I don't have anything else installed that would be messing with chat, so any idea what might be causing this? I wouldn't mind just turning /me off, but I want to keep @pms, and I don't see a way to disable just one.

    Last edited Feb 22, 2014 by nostalgicbadger
  • Avatar of BizBink BizBink Feb 10, 2014 at 19:15 UTC - 0 likes

    Is there a permission for url clickable links? If not I think it would be a nice small addition

  • Avatar of rymate1234 rymate1234 Feb 08, 2014 at 14:24 UTC - 0 likes

    @TNTftw21: Go

    Put the bracers in the prefix rather than the chat config

  • Avatar of TNTftw21 TNTftw21 Feb 08, 2014 at 03:47 UTC - 0 likes

    I have each of my items in the chat surrounded by bracers, like so:

    message-format: '&1<%world> &b<%group> &5<%prefix> &6%player: &f%message'

    Is there a way to make it to where the bracers don't show up if, say, the prefix isn't there?


  • Avatar of Fabyold Fabyold Feb 05, 2014 at 17:40 UTC - 0 likes

    update 1.7.2?

  • Avatar of Macitron3000 Macitron3000 Jan 30, 2014 at 06:49 UTC - 0 likes


    The only thing that I can think of that would cause that is that you used the section symbol instead of the "&" symbol. I can't make the section symbol because I'm on my iPod, but hopefully you know what I mean (the thing that looks like 2 s's merged together). When making the colors, use the & symbol. E.g. &6%prefix&7 or whatever, I can't remember them off the top my head


Date created
Nov 13, 2011
Last update
Oct 12, 2013
Development stage
  • enUS
GNU General Public License version 2 (GPLv2)
Curse link
Recent files