BDchat

1Overview

Overview

Basic 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. (Technically there is a limit if you are planning on making several thousand channels :P lol) 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.

Commands

There is only one command in BDchat, and it is /cc. This command is used to change your channel and it is used like this: /cc (channel name) If you want to say a message in a certain channel without changing to that channel for future messages you can also do /cc (channel) (message) That will send your message in the specified channel, and the next message will still be in the channel you were in before.

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. There are also many other uses for this. If you do not set these permissions properly chat messages will not be seen.

Permission to switch channels: BDchat.cc
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:globalPrefix:.&1[G]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. This is due to the yaml file type not accepting "&" as the first character in a value. There is also a description which is currently not used, but it is recommended filling it in anyway because a future version of this plugin will require it.

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. As of version 2.0 this feature is not working properly, and the plugin will treat it like it says 150 no matter what the actual value is. Once this property is working properly it will determine how far away players can be to still see messages sent in a local 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.

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.