Groups - kangarko/ChatControl-Pro GitHub Wiki

Groups allow you to set different settings for people with certain permission, for example setting different chat format for your VIP players.

How to Use Groups

To create a new group, set Groups.Enabled to true in you settings.yml, and create new groups in the List key there according to the configuration options below.

In game, give your players "chatcontrol.group.{group}" permission (replace {group} with the name of the group) to put them into a certain group. Players may have multiple groups.

If you are an operator, give yourself the negative permission ("-chatcontrol.group.{group}") for yourself, otherwise you may be automatically applied to all groups.

The following example illustrates three groups: guest, vip and staff with various options.

Groups:
  List:    
    guest: 
      Channel_Limit: 1
      Message_Delay: 4
    vip: 
      Message_Delay: 1
    staff: 
      Message_Delay: 0
      Interactive_Format: Staff_Format

Configuring Groups

When configuring groups, you only need to specify the options you need to use.

The Original Key represents the path to the global option for all players, or the only option when groups are disabled.

Message_Delay

Info: How much time to wait before the player can write another chat message?

Original Key: Anti_Spam.Chat.Message_Delay

Message_Delay: 2

Command_Delay

Info: How much time to wait before the player can run another command?

Original Key: Anti_Spam.Commands.Command_Delay

Command_Delay: 3

Channel_Limit_Write and Channel_Limit_Read

Info: How many channels at once can a player be in? The first option is for the write mode, the second for the read mode.

Original Keys: (in channels.yml) see Channel_Limits option

Channel_Limit: 2

Rejoin_Delay

Info: How many seconds must the player wait to join the game again?

Original Key: Anti_Bot.Cooldown.Rejoin

Rejoin_Delay: 2

Chat_After_Login

Info: How many seconds must the player wait to chat after logging in?

Original Key: Anti_Bot.Cooldown.Chat_After_Login

Chat_After_Login: 2

Command_After_Login

Info: How many seconds must the player wait to run commands after logging in?

Original Key: Anti_Bot.Cooldown.Command_After_Rejoin

Command_After_Login: 2

Chat_Format

Info: Custom chat format for the group (if Chat Channels are disabled, see channels.yml).

Original Key: (in formatting.yml) Default

Chat_Format: Format_Name

Global_Chat_Format

Info: Custom global chat format for the group, if ranged chat is enabled (if chat channels are disabled, see channels.yml).

Original Key: (in formatting.yml) Global

Global_Chat_Format: Format_Name

Sound_Notify_Color

Info: Custom sound notify chat color for the group, if sound notify is enabled.

Original Key: (in settings.yml) Sound_Notify.Color

Sound_Notify_Color: '&c'

Custom Join / Leave / Death messages?

Please see your messages.yml file for that. Here is an example of a custom message for players having the VIP permission:

a