MumbleChat
MumbleChat
Overview
MumbleChat, developed by cindy_k of Minecats Minecraft, is a plugin aimed specifically at larger servers, where chat can become unmanageable at times. MumbleChat focuses on letting each player have more control over the speed of their chat flow via the channels they join and participate in, instead of having all players chat in one unified global chat channel.
Primary features of MumbleChat include configurable chat settings and per-channel permissions in a lighter weight format aimed at speed, so that you can have your chat for your groups without worrying about it slowing down your server with your high numbers of players. For a full list of features, look below.
New Features and Fixes with this Release
- LogLevels
Severe, Info, Debug
- Broadcast Alerts
Send a message to all players on the server, no matter what channel they are listening on Can be configured to show Broadcaster's name or not. Has a settable permission, so you can restrict it to just the players you want to have the power. Configurable default color and will allow color codes in message. Set your own command name for it. Default is Alert, but it is configurable.
- AutoJoin
This is different than the Default option. Default is for first join players, that have no settings. AutoJoin sets players to listen to this channel everytime they log in. They can leave the channel after they login, but when they login again, it will be back.
- chwho Command
See who is listening in the channel. /chwho [channelname] For channels with distance set, this will show who is listening within that distance. Players that are muted in the channel will be displayed in red, all other players will be white.
- Ignore command for Tells
/ignore [playername] Players can ignore up to 20 players /ignore ? will display a list of the people they are currently ignoring. To remove a player from /ignore, just /ignore [playername] again.
- Inform players on Mute and Unmute
A message will be sent to the player who has been muted or unmuted, informing them. It does not tell them who did it, just that they are now muted/unmuted in that channel.
- Added in-game message color formating for players with mute permissions Uses the same color chart as below
- Fixed: bug with players leaving sticky tell
- Fixed: player config not always saving correctly
- Fixed: default config not being created automatically
Features
- Multiple channels for communications
Not all players talk into a global channel. By default, you have a local channel which nearby players can hear, a global channel, and a staff channel.
- Channel-based permissions
You can give specific users or groups access to join a particular channel - for example, senior members may have access to a "trade" channel.
- Configurable channel reception distance
Channels may have a definable distance at which other players can hear you speaking - by default, local chat's distance is set to 230 blocks.
- Muting
If a player is being disruptive, rude, obscene, spammy, et cetera., you can revoke the player's privileges from speaking in a particular channel.
- Support for PermissionsEx prefixes
If you've given specific users or groups prefixes in PermissionsEx, MumbleChat will pick up those prefixes at player login.
- Regular expression based chat filter
Via the config, you can filter out specific words in chat and replace them with another word or character set of your choice. Don't want bad language on your server? Replace it with less offensive words.
- Channel listings
Players can view a list of channels that they have access to and if the channel requires permissions.
- Color-coded channels
You can specify a color for each channel, within the range of the colors that Minecraft allows in-game - a different color for every channel! (Or the same color, if you so prefer.)
Commands and Syntax
/mute [player] [channel]
- Aliases: /mp
- Description: Prevent a player from sending messages to a channel.
/unmute [player] [channel]
- Aliases: /ump
- Description: Allow a player to send messages in a channel again.
/tell [player] [msg]
- Aliases: none
- Description: Send a message directly to a player.
/channel [channelname]
- Aliases: /ch, /join
- Description: Start listening to a channel if the player is not yet listening to that channel, otherwise set the player's channel focus to that channel.
/leave [channelname]
- Aliases: /lev
- Description: Stop listening to a channel.
/chlist
- Aliases:
- Description: Show the list of channels available to the player.
/chwho [channelname]
- Aliases: /chw
- Description: Allows players to see a listing of who is listening on a channel permission-message: You don't have <permission>
Configuration
- filters:
- This node is to contain a YAML list of regular expressions and associated replacements, defined by the following format:
- regex1,replace1
- regex2,replace2
- regex3,replace3
- etc,etc - loglevel
- info
- mute.permissions:
- This node should have the permission for muting players. By default, this is mumblechat.mute. You may change it as you wish.
- saveplayerdata:
- This node should either be followed by true or false. If true, player chat settings (channels being listened to, channel mutes, and so on) are saved in a player.yml file. Otherwise, the associated information is lost at restart. By default, this is true.
- tellcolor:
- This allows you to set what color tells appear in
- broadcast:
- This is the setting for broadcast messages to all players
color: colorhere - see below for a list of colors - white if excluded
displayplayername: true/false - false if excluded
displaytag: Prefix for broadcast - No displaytag will be displayed is excluded
permissions: set permission for who can broadcast command: set the command for the broadcast - if left out, broadcast is disabled
- new permissions with 1.7.8 version. (Update your config if you want to use them)
permissions: mute: mumblechat.canmute color: mumblechat.cancolor who: mumblechat.who
- usePrefix:
- This node should either be followed by true or false. If true, mumblechat will recognize prefixes defined in PermissionsEx. By default, this is false.
- channel:
- This node is to contain your list of channels as a set of sub-nodes, each with a set of sub-nodes to define settings relating to the channel, defined by the following format:
- channelname1:
- color: colorhere - see below for a list of colors
- muteable: true/false
- filter: true/false - true if excluded
- alias: aliashere
- distance: value - the channel will broadcast globally if excluded. Enter a value in number of blocks.
- default: true/false - false if excluded
- autojoin: true/false - false if excluded
- color: colorhere - see below for a list of colors
- channelname2:
- color: colorhere - see below for a list of colors
- muteable: true/false
- filter: true/false - true if excluded
- alias: aliashere
- distance: value - the channel will broadcast globally if excluded. Enter a value in number of blocks.
- default: true/false - false if excluded
- autojoin: true/false - false if excluded
- color: colorhere - see below for a list of colors
- etc...
Color Table
As a simple explanation, any string from the list on http://jd.bukkit.org/apidocs/org/bukkit/ChatColor.html will work.
color | ingame equivalent |
---|---|
black | &0 |
dark_blue | &1 |
dark_green | &2 |
dark_aqua | &3 |
dark_red | &4 |
dark_purple | &5 |
gold | &6 |
gray | &7 |
dark_gray | &8 |
blue | &9 |
green | &a |
aqua | &b |
red | &c |
light_purple | &d |
yellow | &e |
white | &f |
magic | &k |
bold | &l |
strikethrough | &m |
underline | &n |
italic | &o |
reset | &r |
Permissions
- mumblechat.canmute Allows a player to mute others
- mumblechat.who Allows a player to use /chwho command. On pvp servers, you may want to disallow /chwho so players can't see who is in a local channel.
- mumblechat.cancolor Allows players to use color codes in chat.
- channelpermission Allows a player to listen to this channel and view it in the channel list.
Installation
Just put MumbleChat.jar in your ./plugins folder and fire up your server; you're good to go. For the best installation of MumbleChat, however, make sure to edit your config.yml in the MumbleChat directory created by your plugin after initialization and then restart your server.
Upcoming and Planned Features
- Support for 1.4
- Increased set of aliases for current commands
- Admin command to force players in and out of channels
- Separate permissions for in chat color
WARNING for CommandBook Users
If you are using CommandBook, you MUST move messaging to the Disabled Section.
Still Need Help?
- Visit the MineCats Forum and post your question for Cindy there: http://minecats.forumflash.com/index.php?/forum/18-plugins/
- IRC help : On Espernet, channel #minecats
Credits
- cindy_k - Main Developer
- Net_Creator - Assistant Developer
I like this plugin but two things.
I really need this plugin since my server NEEDS to pexchat cause nothing else lets you add custom tags that way and we need like 150 groups. These are mostly suggestions but things I seriously would like. I can't write my own plugin so.... XD gj so far though, only chat plugin that works with pexchat and have local range.
@CrazyNineCR
I didn't back level test it. you will have to try it. It doesn't use any lowlevel craftbukkit calls, so it will probably just work.
@Narxon
So if global is their default channel, they can just type and it will go there. or you can /[alias] message
You want a supershort alias? where you just type a specified character in the front for a channel? There isn't much keyboard difference between typing /g message and ! message I'll think about.
@sharqman
I don't have one in the works right now but I will consider it. I do write bungee plugins occasionally.
Theres any way to let my users use global by tiping ! before the text? That would be great!
Version 1.7 work for 1.6 server or i have tout DL the 1.5 version??
This plugin looks great, just what I need to replace herochat. Will you be releasing a bungee chat bridge?
@antiemp
Thank you. :)
------I've just loaded an update that will fix some permission issues. I am working on a big update with more permissions, some new commands, and UUID support. It should be out in a couple of weeks.@mmmgames
You did not hear about this on UHC 14. You heard about Mumble. It is not the same thing. MumbleChat is a text chat plugin for Bukkit. Mumble is a voice chat system which was used along with the Mumblelink plugin to allow for the proximity volume you saw in UHC 14.
You can find Mumble here: http://mumble.sourceforge.net/
You can find Mumblelink (the Minecraft plugin) here: http://www.minecraftforum.net/topic/217587-172-mumblelink-forge-smp-lan-mumble-realism-directional-voip/
Hey, I heard of this plugin on Mindcrack UHC 14, and I installed it correctly but I can't find the folder with the config.yml
Edit: oh, it's out of date
@MINECARTART
GroupManager is also very simple and it shouldn't cause any problems as long you keep it updated. I use GroupManager on my server and find it very easy to use. When I tested Permissions EX in the past, it screwed up my server.
@sebidebi4567
I have an idea use permission ex its better than group manager and its very simple
will there be an update for 1.5.1 servers?
@MineNeMeMa
Yes, read what it says above. And EWWWWWWWW! Groupmanager. don't use that, use pex, much better.
Netti, Cindy, It wont work with groupmanager, Any ideas ?
as a loyal mutt where else would i go for the chat plugin for my own server hehe
if i have problems il come /modreq you
keep up the good work cindy_k/netcreator
acidbarr
Please update this i really need this! does it work with groupmanager?
tried installing this plugin, and it couldn't. i get this error. http://pastebin.com/GjB4XtNL
no config was generated to do as you suggested.
is there a way to download just the config, or could you have the dependency turned off by default and people can turn it on in the config?
Do i NEED permissionsex or can i stick with groupmanager?? I prefer groupmanager
What config file?? but thanks