Bukkit

Overview

BDchat aka Blocky Development Chat adds chat channels to your Minecraft server! There are several different types of channels you can use, and they are made to be configurable as possible meaning that you can make your own channels, and you can add as many channels as you want to. You can also set permissions to set who can talk and/or view messages sent in a certain channel.

If the plugin is not working for you read this entire page before commenting or creating a ticket! If you find any bugs please report them.

Update News

Latest Update (v2.2)

• Added a new help command and channel list with /bdchat help and /bdchat list
• Minor bug fixes

Next Update (v3.0)

• Will improve performance and memory usage (finished)
• Minor bug fixes
• Possibly a spy command to allow admins to listen in on local channels
• Will compile on Java 6 (It will work on both Java 6 and Java 7 after this) (finished)
• Config will be split into a main config and a channels config (finished)
• Will be able to set up channels in game
• Possibly a Towny chat channel type (cancelled)
• Possibly faction ally chat
• Will add support for chat managers other than just Essentials
• Ability to use chat from console in a certain channel
• BukkitDev page will look cooler :D

Credits

StevenMG - Author and Manager

Addicted_24_7 - Tester and Contributer

Commands

Permissions

You need to set who can view and talk in each channel. This makes it possible to add a staff channel where staff on a server can talk freely without members knowing what they are saying. You could also add a prisoner chat that only allows them to listen. There are also many other uses for this. If you do not set these permissions properly chat messages will not be seen.

• Permission to view messages in a channel: BDchat.(channel name).View
• Permission to send messages in a channel: BDchat.(channel name).Talk

Configuration

Channels are set up in the configuration file. Each channel will be under the section "Channels:" To create another channel create a sub-section with the channel name. Under that you will need a few basic properties. Here is an example channel:

g:
    Type: global
    Prefix: .&1[G]
    MessageFormat: .&1
    Description: Anyone can see messages sent in this channel.

The channel name for this is "g", and the type is a global channel. (Look below for a list of channel types and how they work) The prefix for this channel is a blue "[G]" You can use the normal chat formatting characters for the channel prefixes. The plugin will not work unless you put a dot (".") in front of the prefix and format. This is due to the yaml file type not accepting "&" as the first character in a value. The description is shown when a player does /BDchat list. The MessageFormat field can be used to set a certain color for different channels.

There is one channel type that requires an extra property. That type is local_range (again, look below to see what this channel type does). You will need to put "Range: (number)" for this channel. This number determines how far away people can be in order to see people's messages sent in this channel.

To add prefixes you need to use Essentials Chat. In the chat format option use the string {BDchat} where you want the channel prefix to be.

At the bottom of thew config file there is a HelpMessage field with several numbered sub-fields underneath it. This is where you can change the plugin's help message. Each sub-field represents a new line, and you can add as many more as you want. You can set the config paths to whatever you want as long as they are not the same as each other. I used numbers simply because it was neater.

Channel Types

There are currently four different channel types:

• global: This will be seen by anyone
• local_range: This will be seen by anyone within 150m of the sender
• local_world: This will only be seen by people in the same world as the sender
• faction_only: This will be seen by anyone in the same faction as the sender (Uses the Factions plugin)

I plan to add a channel type that will allow the entire faction and allies to see messages, and I also plan to add Towny related channels.

Dependencies and Incompatibilities

• Essentials chat is required if you want to use channel prefixes
• You must have the local chat built into Essentials turned off for this plugin to work.

If you find any incompatible plugins please create a ticket letting me know what it is.

How to Help

• If you are a programmer and would like to help me make this plugin I uploaded it to Github! https://github.com/stevenmg/BDchat
• If you are not a programmer, but you have ideas on how to improve the default channels submit your changes to the config file on Github! https://github.com/stevenmg/BDchat
• Of course, we also need people to know that this plugin exists! Let the admins of your server know about this plugin!