Inactive [CHAT] iChat 2.4.4 - Custom Chat Formatting [1337]

Discussion in 'Inactive/Unsupported Plugins' started by Drakia, Feb 24, 2011.

Thread Status:
Not open for further replies.
  1. Offline

    Drakia

    iChat 2.x - Custom Chat Formatting
    Version: 2.4.4
    CraftBukkit: 1337

    Plugin Support:
    PermissionsBukkit
    bPermissions
    Permissions 2.x
    Permissions 3.x

    If you are requesting help, post your entire server log (From the time it opens, until somebody talks), your entire Permission config file (As well as what it's named), and iChat config files. This information is REQUIRED for me to help you.
    http://pastebin.com/ <-- Post configs there when asking for help

    =============
    Description
    =============
    Custom chat formatting.
    Based on the idea of iChat v1.5 by Nijikokun.
    Includes code and concepts from mChat by MiracleM4n <https://github.com/MiracleM4n/mChat/>

    Before downloading: iChat 2.4.x has quite a few changes over the 2.3.x branches. All permissions plugins are handled in one plugin, and they all operate in relatively the same way now. This means you WILL need to redo your configs.
    Download (Direct JAR): http://thedgtl.net/bukkit/iChat.jar
    Source: https://github.com/TheDgtl/iChat

    =============
    Features
    =============
    Supports Permissions (Both 2.0 and 2.1), and SuperPerms handlers (PermissionsBukkit, bPermissions, and PermissionsEx).
    Allows you to specify a prefix/suffix/variable for users and groups on a per-world or global basis.
    A user-specific prefix/suffix/variable will take priority over a group prefix/suffix/variable, a world-based prefix/suffix/variable will take priority over a global prefix/suffix/variable.
    Unlimited amount of custom variables for use in chat format.
    Colors are supported in all parts of the formatting and chat text.
    Usable health bar and health amount in the formatting.
    Support for formatting of /me

    =============
    Formatting
    =============
    Message formatting is defined in the file plugins/iChat/config.yml
    The message formats can contain characters, color codes, and variables.
    To use colors use the standard Minecraft color codes found here: http://www.minecraftwiki.net/wiki/Classic_Server_Protocol#Color_Codes

    Available variables:
    +prefix - The prefix for this user, or this users group if they don't have one defined.
    +suffix - The suffix for this user, or this users group if they don't have one defined.
    +name - The users name
    +displayname - The users display name (Set by plugins such as Towny)
    +iname - The iChat formatted player name (Defined by iname-format)
    +group - The users group
    +healthbar - A visual health bar for this user
    +health - The users current health value (Between 0 and 20)
    +message - The message the player typed
    +world - What world the player is currently in
    +time - Timestamp, configurable in config.yml. Uses the format for SimpleDateFormat - http://bit.ly/dscw40

    Example (Default):
    Code:
    iname-format: '[+prefix+group+suffix&f] +displayname'
    message-format: '+iname: +message'
    me-format: '* +name +message'
    date-format: 'HH:mm:ss'
    handle-me: true
    Example date-format (Default):
    date-format: 'HH:mm:ss'

    As of iChat 2.4.0 there have been a few changes in the way variables and groups are handled.

    ==========
    Groups
    ==========
    As of iChat 2.4.3 native groups are supported in Permissions 2.x/3.x, PermissionsBukkit, bPermissions, and PermissionsEx.

    ==========
    Variables
    ==========
    Variables are now defined in variables.yml in the iChat directory. This includes prefixes, suffixes, and custom variables.
    You can define an unlimited number of custom variables for groups and users, if these variables contain the static variables such as +prefix,
    +suffix, +health, etc then those variables will be replaced with their respective values.
    If a variable does not exist then it will be replaced with a blank string.

    As of iChat 2.4.4 you can now specify world-specific variables. To specify a per-world group or user variable (Prefix, suffix, or variable) you just specify it under the world as shown in the 'world' example in the default variables.yml below. Anything specified in the parent 'users' or 'groups' nodes will be considered global for all worlds.

    Default variables.yml:
    ---------------------
    Code:
    # iChat Variable Config
    # This is now the only method for defining variables
    users:
        Drakia:
            prefix: '&e'
    groups:
        Admin:
            prefix: '&c'
            suffix: ''
        Default:
            prefix: ''
            suffix: ''
    world:
      users:
        Drakia:
          prefix: '&a'
    Default config.yml:
    ---------------------
    Code:
    handle-me: true
    date-format: HH:mm:ss
    message-format: '+iname: +message'
    me-format: '* +name +message'
    iname-format: '[+prefix+group+suffix&f] +displayname'
    =============
    Examples
    =============
    To make a group colored:
    variables.yml:
    Code:
    groups:
        Default:
            prefix: '&4'
            suffix: ''
    config.yml:
    Code:
    message-format: '[+prefix+group&f] +name: +message'
    To make a single username colored:
    variables.yml:
    Code:
    users:
        Drakia:
            prefix: ''
            suffix: '&1'
    Config:
    Code:
    message-format: '[+prefix+group&f] +suffix+name&f: +message'
    As you can see, suffixes and prefixes can be used anywhere, in any combination. In this example we use prefix as a method for coloring group names, while suffix is used to color individual users. On our server we have prefixes such as "&f[&2Mod&f] " so that we can have custom tags per group instead of just the groups name. There is no end to the combination of things you can do, please TRY things before you come asking for someone else to do it for you. There are too many combinations of things for me to answer every question about how to color specific things.
    I will not be offering answers to questions such as "How do I color names?" or really anything else to do with specifics of formatting. It's pretty straightforward what you can do, and if you can't take the time to experiment then I'm not going to take the time to answer your questions.

    =============
    Configuration
    =============
    iname-format - The format used for +iname (Default: '[+prefix+group+suffix&f] +displayname')
    message-format - The format used for basic chat (Default: '+iname: +message')
    date-format - The format used for +date (Default: 'HH:mm:ss')
    me-format - The format used for /me commands (Default: '* +name +message')
    handle-me - Whether to handle /me commands (Default: true)

    =============
    Permissions
    =============
    ichat.color - Allow this group/user to use color in their chat messages.
    ichat.reload - Allow this group/user to use "/ichat reload"

    =============
    Commands
    =============
    /ichat reload - Reload the iChat config file

    =============
    F.A.Q.
    =============
    Q) Why is my custom message format not working? I just get the default output. Or output with no variables filled in.
    A) If you're using Permissions 2.1, make sure your Permissions config file is named "{worldname}.yml" where {worldname} is the name of your world. If you're using Permissions 2.0, make sure your Permissions config is named config.yml

    Q) How do I set the brackets color to the same as the group?
    A) Normally you have the brackets in the message-format variable, but you can just as easily move them into prefix/suffix and that way they can be per-group colored!

    Q) Why is my entire string colored? I just put a color code beside +name!
    A) A color code will persists until another color code is encountered, or the end of the line is reached. To change the line back to white use &f after the variable/string you want colored.

    Q) Why are my OPs names red?
    A) Essentials has this functionality built in. Change "ops-name-color" to 'none' in your Essentials config file.

    Q) Why does {PluginX} not work with iChat?
    A) There's a good chance it does, but you need to use +displayname instead of +name.

    Q) Why does Towny not work with iChat?
    A) iChat no longer uses %1$s for the player name, it uses player.getName() and player.getDisplayName(), until such a time that Towny is updated to use the proper method of setting a players name (Set their displayName) it will not work with iChat.

    =============
    Changes
    =============
    [Version 2.4.4]
    - Updated to new FileConfiguration class
    - Fixed bypass exploit for colors in messages
    - Multi-world support for variables.yml
    - Resolved an issue with /me not reloading player variables
    [Version 2.4.3]
    - Permissions overhaul. No longer require group.{name} node unless not using a permissions handler
    [Version 2.4.2]
    - Fixed issue with inheritance in Permissions
    - Implemented start of online time variable. Need output format.
    [Version 2.4.1]
    - Remove plugin-specific group referencing. All groups are now managed via group.* nodes,
    the exception being pure Permissions 2.x/3.x
    - Fixed /ichat reload not reloading variables.yml
    - Updated /me to use BroadcastMessage
    [Version 2.4.0-final]
    - Took out variable caching, there's no hook for PermissionChange.
    - Updated README to include info on group.* nodes
    [Version 2.4.0-beta]
    - Merged all branches into one
    - Supports Perms 2.x/3.x, SuperPerms, GroupManager
    - Added a more advanded API based on the mChat API
    - Massive thanks to MiracleM4n for code and concepts
    - All variables are now retrieved from variables.yml instead of Permissions
    - Removed censor code
    [Version 2.3.2-p3]
    - Set Permissions as a dependency in plugin.yml
    - Added Permissions 3 support to the -p3 jar
    [Version 2.3.1]
    - Added iChat.ichat.parseChat(Player, String, Format) API
    - Added hook for /me chat formatting using the "me-format" config option
    [Version 2.3.0]
    - Added external iChat.ichat.parseChat(Player, String) API
    [Version 2.2.3]
    - Added +displayname/+d for player.getDisplayName()
    [Version 2.2.2]
    - Updated to latest RB
    [Version 2.2.1]
    - Updated how Permissions is loaded
    [Version 2.2.0]
    - Added the ability to have an unlimited amount of variables in message-format
    - Changed versioning scheme
    [Version 2.11]
    - Now uses per-world permissions information
    [Version 2.10]
    - Allow admins to enable color on a permissions basis
    [Version 2.09]
    - Another small update to Permissions (Returned false when I should have returned true)
    [Version 2.08]
    - Pushes PacketCollisions PermVersion change. Fixes issues with 2.5.2
    [Version 2.07]
    - Added +time tag
    [Version 2.06]
    - Added +world tag
    [Version 2.05]
    - Ignore whether the plugin is GM, just treat everything as Permissions! Means you need FakePermissions.
    [Version 2.04]
    - Added the ability to use variables in the suffix and prefix (More customizeable messages)
    [Version 2.03]
    - Verify that all available variables aren't null before calling parse
    - Fixed crash caused by color code at end of message (Basic fix, added a space)
    [Version 2.02]
    - Fix for possible NPE
    [Version 2.01]
    - There's a bug in Permissions 2.1 in getPermissionString, switched to getUserPermissionString
    [Version 2.00]
    - Initial re-write of Niji's plugin.
    - Added Permissions 2.0/2.1, and GroupManager support.[/b]
     
    FFS2309, Lolmewn, wassilij and 12 others like this.
  2. Why does this *require* permissions ?
     
  3. Offline

    Drakia

    Because I wanted it to? It's based off of the ideas from "iChat 1.5" which is a Permissions addon, therefor this is a Permissions "addon." You need Permissions to be able to do anything per-user or per-group. Prefix/Suffix are supplied by Permissions, and are the main reason to use this plugin.

    TLDR: I did it for the lulz
     
    ZachBora likes this.
  4. It sux to have dependencies but hey, your plugin.
     
  5. Offline

    Drakia

    Sadly my plugin also depends on Bukkit :( But hey, I code for me and my server, I release my plugins because I figure other people may want to use them as well.
    There's currently 4800 unique hits this month on iChat alone (28,000 hits total, damned auto update checkers), so it seems people aren't too concerned with running Bukkit as a dependency.
     
  6. Yes, but bukkit is required for you to even make the plugin, permissions isn't and not all people want to use it. I'm not going to discuss this further because it seems you're offended by opinions. :)
     
  7. Offline

    Drakia

    Not offended, I'm just a sarcastic ass ;)
     
  8. Offline

    Moronmaster

    If this solution did not help, i know exactly what does. I just figured out that if you are using EssentialsChat and iChat, they WILL collide.

    Just wanted to clear things up :)
     
  9. Offline

    angus22397

    Once again please quote this message.
    How can I color peoples usernames then, another plugin????
     
  10. Offline

    kahlilnc

    It does not make a Folder for me or is there a download with the iChat folder in it.
     
  11. Offline

    Drakia

    I just told you, exactly how you're doing it except put &f after the name.

    @kahlilnc The folder is created when you first run the plugin. If it's not then make sure the craftbukkit folder is properly chmod'd
     
  12. Offline

    angus22397

    If I do that it will just add color to the writing, not to the name.
    please quote me again :p
     
  13. Offline

    Drakia

    message-format: '[+prefix+group+suffix&f] &b+name&f: +message'
     
  14. Offline

    xAnder

    @Drakia hi!
    Can you realize local area chat + global channel?
    Example:
    If Player just says:
    * - how many people heard him
    And if Player says with /o (as example)
    All players will hear it.

    I think, it is good idea :)
     
  15. Offline

    Drakia

    @xAnder This is a chat formatting plugin, not a ranged chat/chatroom plugin.
     
  16. Offline

    Jandalf

    use herochat for chatchannels
     
  17. Offline

    xAnder

    No! I did not means chatchannels. I mean local-areas: radius, distance within which players can hear other players. They're different things :)
     
  18. Offline

    Drakia

    And they're both completely outside the realm of chat formatting.
     
  19. Offline

    Maluzis

    Please add the ability to change the text that appears when players disconnecting / connecting to the game. ("John left the game")
     
  20. Offline

    Drakia

    Again, outside the realm of "chat formatting"
     
  21. Offline

    xMasterPiecesx

    It's STILL not working.
     
  22. Offline

    Jandalf

    ok, nice problem, but could u please tell use what is not working? do other plugins work? is there a iChat enabled in ur serverlog? please copy ur config file and permission yml file to pastebin.com
     
  23. Offline

    Drakia

    Post your full Permissions config file, and also tell me what it's named while you're at it.

    I just released v2.2.0 which has quite a big change feature-wise, as well as a new version numbering scheme.
    There is now the ability to have an unlimited number of variables defined in Permissions instead of just prefix/suffix. These new variables can be accessed using +{varname} in your config file. If a variable doesn't exist it will be replaced with an empty string.
    If a variable contains one of the static variables then that variable will be parsed later on to contain its value (See example in the first post).
    This gives users a major increase in the flexibility of their chat formatting, and it's all done using regular expressions so should cause no increase in processing time required for chat messages.

    As this is a rather complicated change, if you run into issues please post them ASAP.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
     
    Last edited by a moderator: May 10, 2016
  24. Offline

    ZachBora

    That sounds awesome Drakia, I'll give it a try.
     
  25. Offline

    An3vilChipmunk

    For some reason iChat refuses to recognize Permissions. Any solutions?
     
  26. Offline

    Drakia

    What permissions version?
     
  27. Offline

    kahlilnc

    No folder comes up after I run the server with the plugin in the plugins folder.
     
  28. Offline

    Cool12309

    Download:

    "Too many redirects"

    :(
     
  29. Offline

    clash

    You could easily take the source code and make your own plugin that doesn't require Permissions. :p

    That said, such a plugin would not support +group, +suffix, +prefix. However, those are generally what people use iChat for, no?

    It could still provide +name, +message, +health, etc. that are not dependent on Permissions.
     
  30. Offline

    fontaine

    For some reason, no matter what I do, the message format is default in game.

    It doesn't add any variables

    Here is my config.yml:
    Code:
    censor-list: []
    censor-color: '&f'
    date-format: HH:mm:ss
    message-format: '[+prefix+group+suffix&f] +name: +message'
    censor-char: '*'
    censor-string-color: '&f'
    censor-colored: false
    
    Reading the FAQ, I also copied the config.yml into a world.yml file, yet still doesn't work.
     
  31. Offline

    Drakia

    @Cool12309 Download is working fine.
    @An3vilChipmunk I need more information from you to fix your problem.
    @kahlilnc The folder is created fine, make sure your folders are chmodded/chowned properly.
    @fontaine That means your users group isn't set, your permissions config is probably wrong. What's your permissions config file named? What permissions system are you running? What craftbukkit version, etc, etc.
     
Thread Status:
Not open for further replies.

Share This Page