bChatManager
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
Requirements
- Vault
- Craftbukkit
Configuration
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.
formats: 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' toggles: control-me: true ranged-mode: false special-features: true other: chat-range: 100.0
Formats
- 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
Toggles
- 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,
Other
- 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
Commands
- /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.
MCStats
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)
Download
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 :)
@rymate1234: Very nice plugin, is it possible to support multiverse worldaliases instead of the plain worldname? That way you don't see world but the alias of the world
@EmperorXing3
does it still work? (it does btw, I'm suing it on my own server at this very moment with no issues.)
If so, why bother updating what ain't broke?
This plugin really needs to update. It's beggining to go on too long.
is the plugin updated for 1.4.6?
Have %group parameter?
When i put a message up its doesnt show any suffix or prefix just comes up as <user>, is there a setting i have to change or is it a bug.
after updating to latest version of bPermissions this: '&6[&f%channel&6] %prefix%player&f: &f%message' used to work just fine, but when i updated %prefix get's overridden by the &6 in front of it.. for some reasons :/ is there's a possible fix for this?
my default chat channel is called "Global" but it wont allow cap letters like G.. so its automatic changed to global.. would it be possible to fix that? :)
@Gunnerrrrr
That's not a bug - spaces are part of the chat format. They'll get featured in even if the faction isn't there
@rymate1234
Alright cool, I also had this which the edit didn't work:
Also, I add space between a players faction tag and name, but if a player ISN'T in a faction, there name has a space before it.
@Gunnerrrrr
1. I'll think about chat per world support - maybe not in the initial recode though.
2. Shouldn't factions disable faction tags in certain worlds? :P
3. Already implemented - use %displayname instead of %player in your config files.
@rymate1234
Awesome!
I would recommend adding a couple things though. Such as /me is not blocked when a player is muted (with essentials) and my recommendations from below:
- Making certain worlds have separate chat - Disabling faction tags in certain worlds - Essentials /nick support
Hey guys. Sorry about the absence, been busy with exams and stuff.
I am doing a complete recode of bChatManager, using vault. This one will not have chat channels however - I'm gonna try and keep it as simple as possible
@DreadThunder
It works for me o.O
And I don't think this will be updated anymore, the owner hasn't logged in since Sep. 30th. So time to migrate to a new chat plugin...
This plugin worked before. Now it doesn't show the prefixs and suffixes.
Would really like to see TagAPI Integrated into this not as part of the prefix or any thing like that but as a new setting in the permissions file called tag, and allow us to set the format in the main config.
I think many many server owners would much like this feature if they knew it existed.
( Basically it allows the setting of the name above the players HEAD or there in adding color to it.)
Hey guys, id love to use bchatmanager however running CB 1.2.5 R4.1 on a test server with bpermissions 2.9.10 and bChatManager 2.0-b1 i get LOL READ THIS 1 whenever anyone chats. Its even worse when I try and load it onto a server with other plugins it LOL READ THIS 4 as well as a failed to pass event playerevent to bchatmanager. Any ideas?
I really want to switch to this from herochat. Please update it!
Couple suggestions:
- Making certain worlds have separate chat
- Disabling faction tags in certain worlds
- Essentials /nick support
Latest version of both bPermissions and bChatManager, CB 1.3.1-R1.0 I can't use /bchatreload even though I'm op, either.
EDIT: I have other plugins that work with the Async ChatEvent.