HChat
- Chat formatter -
- # Main Page
- Commands and Permissions
- Variables and Codes
- Configuration
- Source @ GitHub
- Stats @ MCStats
Features
- Player groups with different options
- Chat channels
- Ranged chat
- Away (AFK) features
- Format display name, list name and chat, death, join, quit, motd, me and tell messages
- Separate formats and configurations for each group and channel
- Word censoring
- Links to permission groups through Vault (optional)
- Lots of variables (like world, location, group, prefix, food level, ...)
- Colors and formatting codes
- ... much more
- Using Gravity's Updater
- Using evilmidget38's UUID Fetcher and Name Fetcher
- Using Plugin Metrics
- Requires Bukkit v1.6.4-R2.0 or later, but the latest versions are recommended
What it is
hChat is a plugin for formatting chat messages, display names, list names, join messages, quit messages, death messages, me command messages, tell command messages, and more. It can also send a motd (message of the day) to the player when he/she connects. All messages are customizable and can use color codes and so-called variables which gets replaced by values such as the world, group, location, prefix, etc. You can create player groups with individual message formats that automatically bind to different groups from permission plugins (through Vault). Players can also create and join chat channels, which is a sort of closed chat.
Groups and Channels
Groups are meant to provide different formats, prefixed, motds, etc, to different groups of the server. The «default» group is obviously the default group and is used if no other groups match a players group. If values in other groups are missing, values from the default group will be used. Every group also have the option to be censored, to allow color codes, to be able to chat, and to hide PMs from the server log and admins with the right permission. Every group can also select a default channel and a default channel per world (which overrides the former).
Channels are closed chat groups which players can join and create. The «default» channel is still, obviously the default channel. Channels can have an owner, members and banned members, can be public or private and can be password protected. If the group is private, the member needs to be a member. The owner has always access and is the only one who can delete the channel. Channels can also have a separate chat format from whichever group the player is in, as long as the format is longer than zero characters. The channel can be not universal which means chat messages will not go between worlds. Lastly, channels can also monitor other channels, meaning it will receive chat messages from those channels.
For help with the configuration files, see the configuration page.
Updating and metrics
Version 1.3 and later uses Gravity's Updater. Version 1.3 to 1.4.1 updates the plugin automatically, but v1.4.2 and later informs that there is an update instead. The command /hchat update
can be used to automatically update the plugin. To disable this feature, set check_for_updates
in config.yml
to false
.
Version 1.4 and later uses Plugin Metrics which collects anonymous data like java version, number of players, etc.. To disable this feature, set collect_data
in config.yml
to #
Bugs
Report a problem: New ticket
Current problems: Tickets
@Frankyi9
You most likely have to rename the group in the permission plugin. But you can try putting the group ID in single quotation marks ('V.I.P.' instead of V.I.P.). Is it really necessary to have dots in the permission group ID though? Can't you just have that in the hChat group name (not ID)?
Hi! I have a problem in configuring a group with dots in its name:
https://imgur.com/sRaT3uk
Can you tell me maybe a workaround? :)
@EnderdragonDotDe
No, that isn't possible any more because Vault doesn't support prefixes and suffixes from permission plugins, but from chat plugins instead. It was possible before i started using Vault and hooked three permission plugins directly. Thanks for notifying me about the missing spaces.
is it possible to use prefix and suffix of permission plugin? just leaving prefix and suffix blank doesn't work
btw. a space is missing, under /channel in line /channel delete "Delete a channelif ...." and the line below
@KnightcraftRPGServer
Oh, sorry about that. Is the chat format for channel default set, maybe? As long as it is set and longer than zero characters, channel chat formats will be used. I don't see any apparent other ways of the problem happening.
I found a bug in the "/hchat list players" command, though, where all the real groups are taken from the command sender instead of the relevant player, but that doesn't affect the chat format.
EDIT: Why don't you use the same chat format for all groups and add the "owner" or "[Owner] " as the prefix or suffix? It seems as if that is what you are doing, somewhat, since you have "[]" in your chat format when the other group has "[+Wolfpack ]". I don't fully understand the problem because of this...
Hi, your latest version still won't change the groups chat formats. It assigns the groups but they all get the default group's format.
http://i.imgur.com/rQCA12b.png is evidence. My chat format is the same as DJ_Flip and Hansenboouy buy my name has a nickname. My format should have the prefix 'Owner' as set in the format. this is the same for all groups. Downgrading for now..
@EnderdragonDotDe
Channels can monitor other channels, meaning getting all chat messages from that channel while your own chat messages get only sent to the chat you are currently in. To do so, add the ID if the group you want to monitor to the
monitor_channels
(or similar) list under the channel in channels.yml.is it possible to be in more than one channel at the same time?
@elkidz
There isn't one. Guess I should add one.
What is the variable for money?
@KnightcraftRPGServer
I have uploaded a new version, check the changelog on the linked page for updates: hChat v1.4.2 (not yet approved)
@KnightcraftRPGServer
No, but I can make the mute command mute PMs as well.
Could you add an ignore option? /ignore jimwocky Would ignore jimwockys chat messages and PM's
@HON95
The players were all assigned the correct hchat groups and the RaC plugin assigns subgroups for permissions not main groups.
@KnightcraftRPGServer
I have fixed the RaC problem and will upload the new version shortly. Some permissions have also been changed.
The file has not yet been approved by the BukkitDev staff, but can be found here: hChat v1.4.1
@KnightcraftRPGServer
Can you check if players are in the right groups using the command /hchat list players? Is hChat the only chat plugin active? I didn't understand the last thing you said, how could the RaC dev have added features to the plugin when the last release was May 15?
EDIT: One thing came to mind. If i rmember correctly, RaC places all players in a race and class group as well. Both my and Vaults way of getting the primary group may fail due to that... Use '/hchat list players' to see if I'm right. I will fix it later today or tomorrow.
Since updating my chat broke. No errors, every group is assigned to a player but no format is changed. It just says 'Jim: MESSAGE ' It used to say '[RACE][CLASS][FACTION][GROUP]Jim: MESSAGE' (Jim is my nick). Also the RacesAndClasses dev added [Race] and [Class] tags for the tags you set in the RaC plugin, like factions.
@KnightcraftRPGServer
I might. I'm working on something else within this plugin at the moment, so it might be a week (+) until the next release, with exams and all.
Hey could you add the ability to hook into a players Race and Class please? like {race} {class} from this plugin.
dev.bukkit.org/bukkit-plugins/racesandclasses/
The dev working on that plugin has no time for adding it.
@KnightcraftRPGServer
Hmm, not sure if that fits the plugin. I'll see what I'll do.