• Requirements
• Understanding Chat Formatting
• Creating a New Group
• Placeholders

Chat format is a simple yet powerful per-group chat formatting feature where players will automatically be placed in their chat format group, depending on which permission group they are in. A default chat format is added so if the players format group doesn’t exist for their permissions rank, they will be placed in the default format group automatically.

To use the chat format feature it requires the two plugins Vault and a permissions plugin (I.E. LuckPerms, UltraPermissions, PEX, GroupManager) on your server at all times to run properly. The plugin needs these plugins since players are placed in their group automatically, and without vault or a permissions plugin that feature wont work properly and will cause a lot of errors in console. Right now chat manager has some checks to see if you are running vault and a permissions plugin on your server. If you don't have vault on your server when starting up your server chat manager will tell console that vault is required to use chat manager then the plugin will be disabled. Chat Manager also checks for a permissions plugin on startup and will say either "hooked into permissions plugin" or "A permissions plugin is required to use Chat Manager, otherwise errors will occur!" depending if you have one or not.

As of right now chat manager only checks if you have the permissions plugins LuckPerms, UltraPermissions, PEX, or GroupManager. If you are running another permissions plugin that isn't one of those four please let me know and I'll add a check for that plugin so you don't get that message. Chat Manager WILL NOT be disabled if you don't have a permissions plugin.

This area will help you understand the chat formatting feature as simple as possible.

This is the main section of the config, I'm gonna try and break it down so everyone can understand it and know how to use it properly.

Chat_Format:

  Enable: true

  Default_Format: "&8[&7Default&8] &7{player} &9> &7{message}"

  Groups:
    Default: 
      Format: "&8[&7Default&8] &7{player} &9> &7{message}"
    VIP: 
      Format: "&8[&5VIP&8] &7{displayname} &9> &7{message}"
    Moderator: 
      Format: "&b[&6Moderator&b] &a[&b{world}&a] &b{player} &9> &e{message}"

Default_Format: "&8[&7Default&8] &7{player} &9> &7{message}" 

This part is the Default_Format section, what this part of the section does is it puts players in this group if their permissions group doesn't exist in the second part of this section. So lets say you only have a few permission groups in your chat format section, Default, VIP, and Moderator, but you are placed in the owners group from your permissions plugin. What chat manager will do if put you in the Default_Group section since your group doesn't exist in the Groups section.

If you want to create a new chat format group please follow these steps. This is whats currently in your config by default. You can add as many or as little groups as you like and configure them to your liking.

Groups:
    Default: 
      Format: "&8[&7Default&8] &7{player} &9> &7{message}"
    VIP: 
      Format: "&8[&5VIP&8] &7{displayname} &9> &7{message}"
    Moderator: 
      Format: "&b[&6Moderator&b] &a[&b{world}&a] &b{player} &9> &e{message}"

1. To create a new group you first need to create it in your permissions plugin. Lets create the group owner and add our permissions and prefix/ suffix to the group (You can add the permissions and prefix/ suffix after your done setting up the chat format is you want).

This is a default example how a group can look like while using the permissions plugin PermissionsEx.

  Owner:
    permissions:
    - '*'
    options:
      prefix: '&b[&6Owner&b] &b'

These are default examples how two groups can look like while using the permissions plugin LuckPerms.

https://imgur.com/a/h7SXgDl

Important Information when using LuckPerms

If you are using the permissions plugin LuckPerms please make sure all the group names are set to lowercase when adding the groups to the chat format! ALSO, make sure you do NOT add a displayname to the groups or they will not work with the chat format. To see and remove the displayname do /lp editor, click the link, click the group, and remove the permission looking node displayname. and that will remove it.

2. Now to create a new format group you just need to do is add this to the groups section to your config.

    Owner:
      Format: "&b[&6Owner&b] &b{player} &9>> &e{message}"

3. You need to first add the permissions group name in the file. Owner: Make sure you add four spaces then add the name. Make sure the name is exactly whats in the permissions file. It is case sensitive!

4. Then you add Format: right under Owner:. Make sure you add six spaces before you add "Format:".

5. Then you create the format you want to use for the rank, you can add as much as you want to it, but be careful, it can make your chat look a mess.

6. Finally press save, then reload the config (/ChatManager Reload) then you're done.

After all that the section should look like this.

Groups:
    Default: 
      Format: "&8[&7Default&8] &7{player} &9> &7{message}"
    VIP: 
      Format: "&8[&5VIP&8] &7{displayname} &9> &7{message}"
    Moderator: 
      Format: "&b[&6Moderator&b] &a[&b{world}&a] &b{player} &9> &e{message}"
    Owner:
      Format: "&b[&6Owner&b] &b{player} &9>> &e{message}"

You can go all out with the chat format, don't make it bland like the example, have fun with it and make it look something like this: https://imgur.com/a/KdWvhVg

This is how I have the format in that picture formatted.

  Groups:
    owner:
      Format: "{radius} {deluxetag_tag} {vault_prefix}#ff00ff{player}{vault_suffix} #ff00ff» {message}"

As you can see, if you put your mind to it possibilities are endless, with this example you can see all the placeholders added to it and the support for hex codes (1.16+).

If you like to see a list of all the available placeholders you can use for the chat format please go here.

If you wish to use PlaceholderAPI's placeholders, you can find them here.