Inactive [CHAT] HeroChat v4.10.3 - Comprehensive Chat Channel Plugin [1060]

Discussion in 'Inactive/Unsupported Plugins' started by DThielke, Jan 26, 2011.

  1. Offline


    HeroChat The Chat Channel Plugin (v 4.10.3)
    Download HeroChat
    Source Code on GitHub This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License.
    Redmine (Issue/Feature Tracker)

    Permissions 3.0
    Rcjrrcjr has been working quite hard on this upgrade to Permissions. However, it currently still suffers from a number of bugs. The most important of these which directly affects HeroChat is the non-functioning of prefixes and suffixes. There are less-than-pretty workarounds, but I'm refraining from fully supporting an update until Permissions 3.1 is released which should include a number of significant bug fixes. When this does occur, however, I have a build ready for you guys that should work. You can download it here. Again, I highly suggest not using this until Permissions 3.1 is released unless you really don't care about prefixes and such.

    See you when I get back!

    Is your config resetting when you make changes?
    If you make changes to the config while the server is running, you need to use the /ch reload command to make the changes stick. I wish this message wasn't necessary, but people only seem to read things in big, bold, red text (if at all).

    Have a problem? a feature request? Go here.
    HeroChat now has its very own redmine found here. If you have an issue or would like to suggest a new feature, I urge you to file it via redmine. I will be checking this much more often than this thread from here on out.

    Show your thanks! Maintaining plugins like HeroChat is very nearly a full time job. If you enjoy my plugins and appreciate the support I provide, then please consider providing some support of your own. Donating even a tiny amount keeps me motivated and makes me feel loved so go ahead and donate!

    What is HeroChat? HeroChat brings a multiple channel system to Minecraft. Through the use of highly customizable channels, even the largest of servers can have manageable and readable chat.

    • Chat channels
      • Highly configurable
      • Public, private and password protected channels
      • Configurable custom message formatting including colors and health bars
      • Channel moderation
      • Local channels
    • Ignore lists
    • Regex-based censorship
    • User setting persistence
      • Automatically saves your settings when you log out
    • Permissions integration
      • Prefixes and suffixes
      • Restrict joining and speaking in channels
      • Restrict important commands
    • CraftIRC integration
      • Relay messages between Minecraft and IRC
      • Configurable links between in-game and IRC channels
    How do I install it? Take a look at the installation and configuration wiki found here.

    How do I use it? Take a look at the usage wiki found here.

    A Message to Users
    Thanks for all your support! I will do my best to keep this plugin updated and bug free. If you have any issues or feature requests, feel free to either leave a message here or find me in #herochat on EsperNet.

    Extra special thanks to my donors: TheYeti, playnight

    Change Log
    Show change history (open)

    Version 4.10.3
    • Fixed players not rejoining private channels when Permissions isn't loaded first.
    Version 4.10.2

    • Fixed a bug with {group} when not using Permissions
    Version 4.10.1

    • Fixed a bug with CraftIRC join/leave events ignoring the join-messages option
    • Added the {group} tag
    • Added the {groupprefix} tag
    • Added the {groupsuffix} tag
    Version 4.10.0

    • Added the separate-chat-log option
    Version 4.9.0

    • Renamed the global craftIRC-tag option to craftIRC-prefix to avoid confusion
    • Replaced the channel specific craftIRC-tags option with game-to-IRC and IRC-to-game to allow one-way communication
    Version 4.8.11

    • Added color support for the irc-tag
    Version 4.8.10

    • Fixed a bug with privileged channels and reloads
    Version 4.8.9

    • Added the local-distance option to set the local distance on a per-channel basis
    Version 4.8.8

    • Removed debugging code I left in accidentally
    Version 4.8.7

    • Fixed an infinite loop with certain censors
    Version 4.8.6

    • Updated for CraftBukkit 612
    Version 4.8.5

    • Updated for CraftBukkit 602
    Version 4.8.4

    • Added a permissions check before rejoining channels during a /ch reload
    Version 4.8.3

    • User settings are now saved before /ch reload does its thing
    Version 4.8.2

    • Added one-time tells to the /tell command
    • Added the {receiver} tag for use in tell formats
    Version 4.8.1

    • Changing focus now ends /tell conversations
    Version 4.8.0

    • Added the cross-world-chat channel option
    • Separated user data into multiple files
    • Added the /ignore alias for /ch ignore back in
    Version 4.7.6

    • Minor improvement to command handling
    Version 4.7.5

    • Minor fix for certain command specific help pages
    • Added global toggle (toggles all channels) to /ch toggle
    Version 4.7.4

    • Minor internal change to how format tags work
    • Minor change to how messages are sent to CraftIRC (allows player specific tags such as {prefix})
    Version 4.7.3

    • Fixed issue with CraftIRC messages being repeated in IRC
    Version 4.7.2

    • Fixed a bug where /qm g ? would show the command help rather than sending a message
    Version 4.7.1

    • Fixed a minor formatting bug regarding join/leave messages in the console
    Version 4.7.0

    • Added the /tell command to create private conversations
    • Added the incoming-tell-format and outgoing-tell-format options to the config
    Version 4.6.0

    • Added the /ch toggle command to allow temporary enabling/disabling of channels
    Version 4.5.0

    • Added custom replacements to the censor feature in the format 'censoredword;replacement'
    • Added the 'herochat.color' permission to allow players to use colors on the fly in their messages
    • Added the mute (per channel) and gmute (global) commands
    • Revamped help menu
    • Added command specific help. Type /<command> ? to use it (ie. /ch create ?)
    Version 4.4.3

    • Fixed a bug when creating a channel with all 5 arguments provided
    Version 4.4.2

    • Improved command handling
    • Fixed a bug where commands longer than the actual commands were being accepted
    • Removed the {color.COLOR} tags - use the usual &c colors now
    • Replaced the {color.CHANNEL} tag with {color}
    Version 4.4.1

    • Fixed a bug with colors in message formats containing underscores
    Version 4.4.0

    • Added regex based word censor
    Version 4.3.7

    • Fixed any and all line wrapping issues (thanks to Bukkit for fixing MC's color line-wrapping bug)
    Version 4.3.6

    • Added the reserved channel name list back in
    • Fixed a potential issue with the /<channel> <message> shortcut command
    Version 4.3.5

    • A default configuration file is now created if you do not have one
    Version 4.3.4

    • Removed the DEBUG message I left in
    Version 4.3.3

    • Fixed line wrapping issues related to Finnish characters.
    Version 4.3.2

    • Fixed the ignore feature
    Version 4.3.1

    • Quick messaging now also relays to IRC
    • Added an option to configure the format for game->IRC messages
    Version 4.3.0

    • Added CraftIRC support!
    Version 4.2.1

    • Updated the help command to reflect the password additions
    Version 4.2.0

    • Added passworded channels
    • Updated /ch create command to allow passworded channel creation
    Version 4.1.6

    • Fixed a bug related to negative health values.
    Version 4.1.5

    • Fixed an error when using custom display names.
    Version 4.1.4

    • Added full error reporting to Permissions issues.
    Version 4.1.2

    • Added licensing information to source and original post.
    Version 4.1.1

    • Finally found the cause of the line wrapping bug. It's fixed now.
    • Implemented stricter version checking for Permissions. HeroChat will disable itself it the right version isn't found.
    Version 4.1.0

    • Added a message for the plugin's onDisable() method.
    • Re-implemented the old quick message feature.
    • Added world specific channels.
    • Fixed the /ch reload command.
    • Added the {world} and {healthbar} tags.
    • Added an overloaded sendMessage for other plugins to use.
    Version 4.0.2

    • Minor change to make HeroChat compatible with future Permissions version names
    Version 4.0.1

    • Fixed a bug when creating channels without specifying a color
    • Decided on a more logical version naming scheme
    Version 4.00

    • Major internal rewrite
    • Added error handling around Permissions to help identify issues with Permissions configs
    • Temporarily removed iChat support
    • Updated for new versions of Permissions
    • The old /ch channels command is now /ch list
    • The old /ch list command is now /ch who
    Version 3.21

    • Another attempt to fix line wrapping.
    Version 3.20

    • Fixed an issue with the /ch remove command.
    Version 3.19

    • Minor adjustment to line wrapping.
    Version 3.18

    • Moved command handling to onCommand.
    • Removed replaced old quick messaging behavior with /qm <channel> <message>.
    • Reworked /ch create command.
    • Added special /ch help create menu.
    • Updated to add Permissions 2.4 support.
    • Removed GroupManager support.
    Version 3.17

    • Fixed banning and kicking players again.
    Version 3.16

    • Players are no longer able to speak in a channel after being kicked or banned from it.
    Version 3.15

    • Added configurable option that defines the tag used to prefix all plugin messages - defaults to [HeroChat]
    Version 3.14

    • Added support for {healthbar} tags in prefixes and suffixes
    Version 3.13

    • Added support for GroupManager. Permissions should still work though!
    Version 3.12

    • Minor internal changes
    Version 3.08

    • Updated to meet new Bukkit standards
    • Fixed long constructor spam
    Version 3.07

    • Added support for other plugins to send messages to channels without a Player object
    • Bug Fix: another attempt to work around the local chat location issues
    Version 3.06

    • Bug Fix: other plugin commands should work again
    Version 3.05

    • Bug Fix: accidentally forgot to set loaded channels to saved
    Version 3.04

    • Added checks for cancelled events.
    • Bug Fix: channels are now only saved if the "saved" option is added
    Version 3.03

    • Bug fix: local channels should REALLY save and work correctly - seriously.
    • Bug fix: the /ch reload command no longer crashes the client
    Version 3.02

    • Bug fix: local channels should now save correctly.
    Version 3.01

    • Bug fix: fixed missing permissions check when automatically joining channels the first time a user enters the server
    Version 3.00

    • Added optional join/leave messages.
    • Channel moderators can now delete their own channels.
    • Channel moderators can now ban users preemptively, even if they aren't online.
    • All user settings are now saved across logins.
    • Removed the /ch auto and /ch default commands as they are now obsolete.
    • Configurations are now stored in a different file with a slightly different format. Old data.yml files are converted automatically to assist in this change.
    Version 2.67

    • Bug fix: issue with /ch list
    • Bug fix: issue with /ch mod
    Version 2.66

    • Bug fix: fixed an issue where players couldn't toggle off their personal autojoins
    Version 2.65

    • Bug fix: forgot to include plugin.yml in the jar last build
    Version 2.64

    • Fixed censor color code formatting
    Version 2.63

    • Cleaned up code a bit
    Version 2.62

    • Improved line wrapping so the last color of the first line is reapplied for each subsequent line
    Version 2.61

    • Players can now add channels to auto-join with the /ch auto command
    • Minor bug fixes
    Version 2.53

    • Actually removed channel joining messages when plugin is enabled (silly typos)
    Version 2.52

    • Removed channel joining messages when plugin is enabled (or externally reloaded)
    Version 2.51

    • Fixed rejoining default channels when reloading the plugin via Essentials
    Version 2.50

    • Added health bar support from iChat (iChat required)
    • Bug fixes
    Version 2.42

    • Minor bug fix to improve player nickname support
    Version 2.41

    • The join, leave and ignore commands can now also be accessed using /ch join, /ch leave and /ch ignore, respectively
    Version 2.40

    • Fixed major bug with /ch reload command
    • Message formatting now uses Player.getDisplayName() instead of Player.getName()
    Version 2.33

    • More bug fixes (fixed channels not being checked for join permissions when attempting to autojoin channels at startup)
    Version 2.32

    • Various bug fixes
    Version 2.31

    • Prefixes and suffixes can now be user-specific
    Version 2.30

    • Slight configuration file restructuring (I promise this will be one of the last times this occurs)
    • Channels can now have restricted join and speak privileges based on permission groups
    • Channels can choose to override the default format string
    • Minor bug fixes
    Version 2.20

    • Console logging added.
    Version 2.10

    • Fixed bug so that message formatting works properly
    • Hidden channels are now hidden from the channel list even if you're in them
    Version 2.00

    • Massive restructuring of code
    • Redone config files - make sure to read the new configuration section
    • Channel moderation added (/ch kick, /ch ban, /ch mod)
    • Custom message formatting added
    • Local channel distance is now adjustable
    • More bug fixes
    Version 1.10

    • Added the /ch reload command
    • Improved suffix support
    • Improved multi-line message support
    • Various minor bug fixes
    Version 1.00

    • Initial public release!
  2. Offline


  3. Offline


    Hello. I am having a problem with HeroChat because anytime anyone says anything, it shows up doubled - one is the global Herochat one and the other is the regular one. All of the settings are default, Permissions 2 is installed. Please help!

  4. Offline


    @Samw8888, show me your config file?
  5. Offline


    Here it is: (the config.yml for HeroChat)
        separate-chat-log: false
        incoming-tell-format: '&8From {player}: &d'
        - \bu+\W*m+a+d+(\W*br(a|o)+)?
        - some_other_word;replacement
        plugin-tag: '§e[HeroChat] '
        craftIRC-prefix: '#'
        outgoing-tell-format: '&8To {receiver}: &d'
        default-channel: Global
        default-message-format: '{color}[{nick}] &f{prefix}{player}{suffix}{color}: '
        craftIRC-message-format: '[{nick}] {player}: '
            color: LIGHT_GREEN
            nickname: staff
                speak: []
                - admins
                - mods
            message-format: '{default}'
                game-to-IRC: []
                IRC-to-game: []
            worlds: []
            password: ''
                bans: []
                moderators: []
                hidden: true
                shortcut-allowed: true
                auto-join: true
                local: false
                cross-world-chat: true
                join-messages: true
                forced: false
            local-distance: 100
            color: YELLOW
            nickname: l
                speak: []
                join: []
            message-format: '&f{prefix}{player}{suffix}{color}: '
                game-to-IRC: []
                IRC-to-game: []
            worlds: []
            password: ''
                bans: []
                moderators: []
                hidden: false
                shortcut-allowed: true
                auto-join: true
                local: true
                cross-world-chat: true
                join-messages: false
                forced: false
            color: ROSE
            nickname: alert
                - admins
                - mods
                join: []
            message-format: '&4[ALERT]{color}: '
                game-to-IRC: []
                IRC-to-game: []
            worlds: []
            password: ''
                bans: []
                moderators: []
                hidden: false
                shortcut-allowed: true
                auto-join: true
                local: false
                cross-world-chat: true
                join-messages: false
                forced: true
            color: LIGHT_BLUE
            nickname: h
                speak: []
                join: []
            message-format: '{default}'
                game-to-IRC: []
                IRC-to-game: []
            worlds: []
            password: ''
                bans: []
                moderators: []
                hidden: false
                shortcut-allowed: true
                auto-join: true
                local: false
                cross-world-chat: true
                join-messages: false
                forced: false
            color: GREEN
            nickname: g
                speak: []
                join: []
            message-format: '{default}'
                game-to-IRC: []
                IRC-to-game: []
            worlds: []
            password: ''
                bans: []
                moderators: []
                hidden: false
                shortcut-allowed: true
                auto-join: true
                local: false
                cross-world-chat: true
                join-messages: false
                forced: false
  6. Offline


    Do you use CraftIRC as well?
  7. Offline


    No but it looks like this: except "IRC" is replaced with "g" for global I assume...

    I have narrowed it down to whatever channel is the focus, that's what it does it on.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 18, 2016
  8. Offline


    Is there any possibility to autoswitch the channel if i switch the world?
  9. Offline


  10. Offline


    Is this P2 Compat?
  11. Offline


    What is a P2 Compat plugin? If it supports Permissions 2? Yep it does support Permissions 2.7.4 afaik.

  12. Offline


    I am having issues with this plugin, because whenever someone chats on the channel that is their focus, it shows up twice - once in the formatted way and once in the normal chat way. I have tried all that I know and I can't fix this!

    Please help!
  13. Offline


    Can you help me set up the CraftIRC connection? In my HeroChat config, the game-to-IRC and IRC-to-game fields both have "[]" in them. Nothing else. What "tag" do I put in there? I'm really confused but setting up CraftIRC was, according to people on the server, "the coolest thing I've ever done". Plawks help.
  14. Offline


    On the CraftIRC part of the fence, make sure the "tags" are set to 'global'.

    Also, to prevent double chat, config the events like this:

          # If you use other chat plugins, you probably want to set cancelled-chat: true
          cancelled-chat: false
          all-chat: false
          joins: true
          quits: true
          kicks: false
          bans: false
          all-chat: false
          joins: false
          parts: false
          quits: false
          kicks: false
          nicks: false
          all-chat: false
          joins: false
          parts: false
          quits: false
          kicks: false
          nicks: false
    In herochat's config.yml:
            color: WHITE
            nickname: Global
                speak: []
                join: []
            message-format: '{default}'
                - channel
                - channel
            worlds: []
            password: ''
                bans: []
                - user
                hidden: false
                shortcut-allowed: true
                auto-join: true
                local: false
                cross-world-chat: true
                join-messages: true
                forced: true
  15. Offline


    You probably have another chat plugin.
  16. Offline


    Displays text twice wehn used with Rules 1.1 :(
  17. Offline


    I don't think so but here are my plugins:
    Screen shot 2011-06-20 at 7.11.37 PM.png
  18. Offline


    I do believe Essentials has a chat thing. Go through it's config.
  19. Offline


    EssentialsChat is not installed. Do you know how I would disable the chat thing?
  20. Offline


    Try the essentials thread :)
  21. Offline


    Hi, i've seen some people asking for HeroChat to Hook Prefix from "Prefixer Plugin" (

    So i've add 2 new method in HeroChat 4.10.3 that hook the Prefixer Plugin.

    To use it just add {prefixer} in the channel config like this :

            color: WHITE
            nickname: g
                speak: []
                join: []
            message-format: '{color}[G]{prefixer}&f{prefix}{player}{suffix}{color} : '
    {prefixer} will be replaced by : [<yourprefix>]

    So if you want this version of HeroChat juste download it while this link :

    @DThielke : Can you add this change in HeroChat ?

    Source files :

    To find what i change just search "protocteur" in the source code.


    ps : sry for my english :p
  22. Offline


    If I understand that correctly, it "fixes" HeroChat so it automatically adds the group name as prefix like iChat does, without the need to configure tags to tell groups apart (besides colored name), right?

    (So you wouldn't need to set prefix to '[&fMember] ')
  23. Offline


    Oh sorry, maybe i needed to explain exactly why i have done this "fixe". So :

    On my server i use HeroChat & Permissions plugins to define player prefix. So with those 2 plugins i can define group prefix. This is usefull for exemple to display color of players according to their group (Admin, Member etc ..) when they talk on global channel.

    But this plugins don't let you make custom prefix. So i found one that can let me define for each player a custom prefix (this one : )

    Unfortunatly this plugin don't work with HeroChat, so what i've done is just make them working together.

    So this "fix" is not interessting for all people who use HeroChat, it's just an answer for people who asked it.

    I don't know how iChat work but my solution let me do thing like this :

    <channel nick> <prefix define by the plugin prefixer> <prefix from permissions> <playername> : <what the player says>

    that give you in game :

    [G][Merchant]Protocteur : blablabla

    where : [Merchant] is the custom prefix, and Protocteur is the permissions prefix with the playername.

    The permissions prefix add the color to my name according to my group in permissions plugin and the custom prefix just show to other player i'm playing a Merchant.
  24. Offline


    Everything what here was, is bullshit and wasn't implemented already. I thought so.

  25. Offline


    @Protocteur I am pretty sure Herochat already does that, if you have Permissions set up. Although, from what I am hearing, 3.X isn't working too well.
    It takes the prefix from the player first, and if the player doesn't have one, it takes the group prefix. So to do what you did, it'd be the prefix "[Merchant] &(whatever the symbol for red is)' The suffix would have to be '&f' (I think) to make it black again

    Then in Global, it'd show "[G][Merchant] Protocteur: "

    @xZise ninja'd me. lol
  26. Offline


    Not directly: You couldn't define that HeroChat should use the user prefix. You could say “use prefix” (which means first found beginning by the user) or “use group prefix”. So this is my format at the moment:
    {color}[{nick}] &f{prefix}{groupprefix}{player}{suffix}{color}:
    The problem now: If the user has no userprefix, it will select the groupprefix twice :/ If you have only colors as group prefix, this is okay, but if you have also text, you have them doubled, which isn't very helpful.

    So @DThielke could you please add the userprefix property. Afaik there is no difference at the Permissions versions. So this should be a simple change.


    PS: Hmpf, why is your license by-nc-nd :( and your repository is heavily outdated, so I couldn't even create a pull request for this :(
  27. Offline


    We won't be taking requests or demands to add to HeroChat. Our primary focus is Heroes and HTTP at this point in time. When Dthielke finds time, he will update HeroChat with the features that we see fit.
  28. Offline


    I already know that, but i don't want to add 1 groups for each player. As i says i need the prefix to act as custom title. But a lot of them will be for one or two people (like king, an unkown traveler, a shaman etc ... theses title are used to show the player job, his fighting abilities, etc .. )

    It's why i use a third plugin that give me the best solution.
  29. Offline


    And this is even more bad. So what now? I liked HeroChat and it is working great except this issue. But your license and your outdated repository makes it impossible for me, to implement it on my own, and send a pull request to you, so you have to do not so much (okay actually I (couldn') don't know how complex it is to add an value, maybe it is so easy, that it is faster to add this, as to merge a pull request).


    If your group prefix is only a color code, you could use, my solution.


    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 18, 2016
  30. Offline


    The repository isn't out of date. I'm more than happy to accept reasonable pull requests.
  31. Offline


    Oh sorry sorry :( didn't saw, that there were different branches with the newest branches.


Share This Page