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.


Older versions of bChatManager had a anonymous plugin stats tool called MCStats built into bChatManager. If you're using one of these older versions, and 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/26-bchat-manager-v3-1-4/ today!

Development builds of this project can now be acquired at the provided continuous integration server located at http://rymatemc.co.uk/jenkins/job/bChatManager/

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 RichpeopleSwag RichpeopleSwag May 21, 2016 at 03:41 UTC - 0 likes

    Should make it show the leader and mods and other types of people in the factions when talking. e.g Hey Player

  • Avatar of Inysal Inysal May 04, 2016 at 01:25 UTC - 0 likes

    Using Spigot v1.9.2 I haven't encountered any bugs at this current time. If I do. I will update!


  • Avatar of rymate1234 rymate1234 Mar 02, 2016 at 10:40 UTC - 0 likes

    @freakyy85: Go

    Taking a look now, thanks for the bug report!

    @achap1989: Go

    /me is a default minecraft command - disabling bChatManager handling of /me merely allows other plugins to handle it

  • Avatar of freakyy85 freakyy85 Mar 01, 2016 at 16:52 UTC - 0 likes

    i also gave a group ^bchatmanager.chat.message. but it didnt help. the group still can use @nick <msg>

  • Avatar of freakyy85 freakyy85 Mar 01, 2016 at 16:43 UTC - 0 likes

    im having a problem. i put special-features: false - but still the @nick <msg> works. i want to disable that. :)

  • Avatar of rymate1234 rymate1234 Jan 09, 2016 at 21:26 UTC - 0 likes

    @FuraHub: Go

    You need to edit the config file to use %displayname instead of %player

  • Avatar of FuraHub FuraHub Jan 09, 2016 at 21:14 UTC - 0 likes

    When I use /nick it says I get a nickname, but it doesn't show my nickname when I type in chat. Does this plugin not work with essentials nick and the nickname plugin?

  • Avatar of achap1989 achap1989 Oct 17, 2015 at 07:00 UTC - 0 likes

    I seem to have issues with using /me with this plugin, when disabled a user can use /me, however when enabled and given the node they can not use it

  • Avatar of JP2112 JP2112 Jul 07, 2015 at 16:39 UTC - 0 likes

    This is a great plugin, would love to see two features:

    (1) Allow for more control over what color codes are allowed. So I don't have 15 people spamming with '&k' every minute (2) A reply feature using /r [msg] or @@ [msg] to reply to last private message.

    Great work though.

  • Avatar of lunglion lunglion Apr 15, 2015 at 22:49 UTC - 0 likes

    I'm having a similar problem with colours not being shown from pex and yes i have vault installed