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 :)
@ExstoCraft
ok the newest version 3.0 doesn't create the bchatmanager folder so just grab the older version start it up and get the config. Then you can use the 3.0 version or use the other one both will work.
@crazy6227
yes, it did.. but after searching for like ten minutes I couldn't even seem to find the folder that was extracted or a config.. as soon as I deleted the .jar from the ftp, everything went back to normal.. but no extracted folder with the config..
@ExstoCraft
Does it say in the server log that bchatmanger has been loaded?
I installed this on my server correctly, but there doesn't even seem to be a folder for bChatManager.. what's going on, everyone on my server is freaking out.
@rymate1234
That's fine as long as it just doesn't have that bland white for every player I'm fine. I just want it to show my "Owner" prefix so I can feel cool.
@crazy6227
I can try, but be advised that afaik the maximum character length of the tab player menu is 16 characters, so not everything might fit in!
@rymate1234
Now with this plugin is it possible to add the color names and prefixes to the player menu when I hit tab or is that not possible? I've been trying to find a plugin that has the ability to do that and if this one could that would be amazing.
@crazy6227
Mainly support for other permissions plugins that provide prefixes. Also means if the bPermissions API changes, you'll only have to wait for a vault update, not a bchatmanager update :)
Testing the new version will get back to you later if I find any errors.
Edit: Working great so far no errors of any sort. Also with the vault support what will it add to the plugin?
I'll upload an alpha test of the vault recode later. This recode only features basic chat formatting at the moment.
UPDATE
Exams will be over next week, so I can start making more progress then.
However, it might take a while, as my laptop is broken and coding on an iPad is hard :D
Any eta on a fix for this?
@rymate1234
cool while your working on the code maybe you can add support for TAG API.
http://dev.bukkit.org/server-mods/tag/
Its really quite cool colors the name above the players head and some of the other plugins even include the Tab menu I think if this plugin did that it would be the best.
@Dayshade90926
Yes
@rymate1234
And that'd be with the same Bukkit build (Beta 0.3)?
@RustyDagger
@Afotai
I am able to reproduce the error :o
Quick fix - Don't use the latest bPermissions
I'm using this version on my server: http://dev.bukkit.org/server-mods/bpermissions/files/134-v2-9-26/ with 0 errors. :)
I'll investigate the issue further when I have time. I've got exams coming up, so I'm putting them first.
@rymate1234
I have the same issue with bChatmanager-2.0.jar with the bpermissions .27 and CB Beta .3 while doing a fresh install
rymate1234
I have the same error I have Bpermissions really you think the other guy is that stupid its kind of insulting really.
I am 99% sure a recent change in Bpermissions caused this error its crashing my server it needs to be fixed. latest Bpermissions and latest Bchatmanager causes that error.
@itsMEE2
You need bPermissions
Bukkit Beta BUild 1.4.6-R0.3