GroupChat [Reborn]

GroupChat 3.3 is out! This is major update which brings crucial changes related to chats organisation.

1. Chat owners can now set group helpers, moderators and trusted moderators - each rank has defined set of features they have access to
2. It's now possible to mute members in chats and also to lock chat for all members.
3. Messages sent in chats are formatted differently depending on sender's rank.

Helper rank
Can invite and kick players (all regular members).

To make player a group helper, type /groupchat helpers add [member].
To remove group helper, type /groupchat helpers remove [member].

Moderator rank
Can invite, mute and kick players (all with rank Helper and lower) and can send messages when chat is locked.

To make player a group moderator, type /groupchat moderators add [member].
To remove group moderator, type /groupchat moderators remove [member].

Trusted Moderator rank
Can invite, ban, mute and kick players (all with rank Moderator and lower), has access to chat locking and can send messages when chat is locked.

How to make player a trusted moderator:
For existing „regular” moderator: /groupchat moderators trust [member].
For player who’s not moderator: /groupchat moderators add [member] trust.
To untrust a group moderator, type /groupchat moderators untrust [member].

Chat locking
Chat locking lets you prevent players from sending messages in a groupchat.
Only members with Moderator rank and higher can send messages when chat is locked.
Players with groupchat.say.locked permission can bypass chat-locking in all groupchats.

To lock/unlock your current groupchat, type /groupchat lock/unlock.

Other changes

• Added /groupchat muted, /groupchat banned, /groupchat moderators, /groupchat helpers commands to show list of banned/muted players and moderators/helpers in current chat.
• Improved /groupchat join tab-completing - it now suggests all public chats player has access to
• Added new permissions for features mentioned above. It's quite a lot of strings, you can find them all at https://maciejnierzwicki.pl/minecraft-plugins/groupchat/commands-and-permissions/

This update contains changes to configuration files. It's recommended to copy-paste following code to existing configurations (you don't have to do it only if you rely on default values and don't intend to edit message strings etc.)

Lines added (config.yml):

MaxEntriesPerPageHelpersSubCommand: 10
MaxEntriesPerPageModeratorsSubCommand: 10
MaxEntriesPerPageMutedSubCommand: 10
MaxEntriesPerPageBannedSubCommand: 10

Lines added (lang.yml, MiniMessage format)

MESSAGE_FORMAT_HELPER: "<green><player> <gray>> <blue><message>"
MESSAGE_FORMAT_MODERATOR: "<yellow><player> <gray>> <blue><message>"
MESSAGE_FORMAT_TRUSTED_MODERATOR: "<gold><player> <gray>> <blue><message>"
MESSAGE_FORMAT_OWNER: "<red><player> <gray>> <blue><message>"
INFO_GROUP_MODERATORS_NONE: "<white>There are no moderators on this groupchat."
INFO_PLAYER_ALREADY_MODERATOR: "<white>This player is already moderator of this groupchat!"
INFO_PLAYER_ALREADY_TRUSTED_MODERATOR: "<white>This player is already trusted moderator of this groupchat!"
INFO_PLAYER_NOT_MODERATOR: "<white>This player is not moderator of this groupchat!"
INFO_PLAYER_NOT_TRUSTED_MODERATOR: "<white>This player is not trusted moderator of this groupchat!"
INFO_PLAYER_NOW_MODERATOR: "<white>Player <green><player> <white>is now moderator of this groupchat."
INFO_PLAYER_NOW_TRUSTED_MODERATOR: "<white>Player <green><player> <white>is now trusted moderator of this groupchat."
INFO_PLAYER_NOW_NOT_MODERATOR: "<white>Player <green><player> <white>is no longer moderator of this groupchat."
INFO_PLAYER_NOW_NOT_TRUSTED_MODERATOR: "<white>Player <green><player> <white>is no longer trusted moderator of this groupchat."
INFO_GROUP_HELPERS_NONE: "<white>There are no helpers on this groupchat."
INFO_PLAYER_ALREADY_HELPER: "<white>This player is already helper of this groupchat!"
INFO_PLAYER_NOT_HELPER: "<white>This player is not helper of this groupchat!"
INFO_PLAYER_NOW_HELPER: "<white>Player <green><player> <white>is now helper of this groupchat."
INFO_PLAYER_NOW_NOT_HELPER: "<white>Player <green><player> <white>is no longer helper of this groupchat."
INFO_PLAYER_ALREADY_MUTED: "<white>This player is already muted on this groupchat!"
INFO_CANNOT_MUTE_YOURSELF: "<white>You can't mute yourself."
INFO_CANNOT_UNMUTE_YOURSELF: "<white>You can't unmute yourself."
INFO_PLAYER_NOW_MUTED: "<white>Player <green><player> <white> has been muted on this groupchat by <green><executor>."
INFO_YOU_NOW_MUTED: "<white>You have been muted on groupchat <green><group><white> by <green><executor><white>."
INFO_CANNOT_MUTE_HIGHER_RANK: "<white>You can't mute player <green><player> <white>because they have equal or higher rank."
INFO_CANNOT_KICK_HIGHER_RANK: "<white>You can't kick player <green><player> <white>because they have equal or higher rank."
INFO_CANNOT_BAN_HIGHER_RANK: "<white>You can't ban player <green><player> <white>because they have equal or higher rank."
INFO_PLAYER_NOT_MUTED: "<white>This player isn't muted on this groupchat!"
INFO_YOU_NOW_UNMUTED: "<white>You have been unmuted on groupchat <green><group><white> by <green><executor><white>."
INFO_YOU_MUTED_CANNOT_SEND: "<white>You are muted on this groupchat. You can't send messages."
INFO_PLAYER_NOW_UNMUTED: "<white>Player <green><player> <white> has been unmuted on this groupchat by <green><executor>."
HELP_COMMAND_BANNED: "<green>/groupchat banned <white>- show banned players on your current groupchat"
INFO_BANNED_NONE: "<white>There are no banned players on this groupchat."
INFO_GROUP_CHAT_NOW_LOCKED: "<white>Chat has been locked by <green><executor> <white>on this groupchat."
INFO_GROUP_CHAT_ALREADY_LOCKED: "<white>Chat is already locked on this groupchat."
INFO_GROUP_CHAT_NOW_UNLOCKED: "<white>Chat has been unlocked by <green><executor> <white>on this groupchat."
INFO_GROUP_CHAT_NOT_LOCKED: "<white>Chat is not locked on this groupchat."
INFO_GROUP_CHAT_LOCKED_CANNOT_SEND: "<white>Chat is locked on this groupchat. You can't send messages."
INFO_GROUP_MODERATORS_HEADER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<aqua><bold>▸ <white><bold>Moderators of <green><group>"
- "<gray>  Page <page>/<lastpage>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_MODERATORS_ENTRY: "<white><number>. <green><player>"
INFO_GROUP_MODERATORS_TRUSTED_ENTRY: "<white><number>. <green><player> <gray><italic>(trusted)"
INFO_GROUP_MODERATORS_FOOTER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<white>Switch Page: <green>/groupchat moderators <gray><page>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_HELPERS_HEADER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<aqua><bold>▸ <white><bold>Helpers of <green><group>"
- "<gray>  Page <page>/<lastpage>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_HELPERS_ENTRY: "<white><number>. <green><player>"
INFO_GROUP_HELPERS_FOOTER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<white>Switch Page: <green>/groupchat helpers <gray><page>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_MUTED_HEADER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<aqua><bold>▸ <white><bold>Muted players on <green><group>"
- "<gray>  Page <page>/<lastpage>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_MUTED_ENTRY: "<white><number>. <green><player>"
INFO_GROUP_MUTED_FOOTER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<white>Switch Page: <green>/groupchat muted <gray><page>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_MUTED_NONE: "<white>There are no muted players on this groupchat."
INFO_GROUP_BANNED_HEADER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<aqua><bold>▸ <white><bold>Banned playerss on <green><group>"
- "<gray>  Page <page>/<lastpage>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_BANNED_ENTRY: "<white><number>. <green><player>"
INFO_GROUP_BANNED_FOOTER:
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "<white>Switch Page: <green>/groupchat banned <gray><page>"
- "<dark_gray><strikethrough>━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
HELP_COMMAND_CHATLOCK: "<green>/groupchat chatlock <white>- lock chat of your current groupchat"
HELP_COMMAND_CHATUNLOCK: "<green>/groupchat chatunlock <white>- unlock chat of your current groupchat"
HELP_COMMAND_MODERATORS: "<green>/groupchat moderators <white>- show moderators of your current groupchat"
HELP_COMMAND_MODERATORS_ADD: "<green>/groupchat moderators add <gray>[player] <white>- add moderator to your current groupchat"
HELP_COMMAND_MODERATORS_REMOVE: "<green>/groupchat moderators remove <gray>[player] <white>- remove moderator from your current groupchat"
HELP_COMMAND_MODERATORS_TRUST: "<green>/groupchat moderators trust <gray>[player] <white>- trust a moderator in your current groupchat"
HELP_COMMAND_MODERATORS_UNTRUST: "<green>/groupchat moderators untrust <gray>[player] <white>- untrust a moderator in your current groupchat"
HELP_COMMAND_HELPERS: "<green>/groupchat helpers <white>- show helpers of your current groupchat"
HELP_COMMAND_HELPERS_ADD: "<green>/groupchat helpers add <gray>[player] <white>- add helper to your current groupchat"
HELP_COMMAND_HELPERS_REMOVE: "<green>/groupchat helpers remove <gray>[player] <white>- remove helper from your current groupchat"
HELP_COMMAND_MUTE: "<green>/groupchat mute <gray>[member] <white>- mute player on your current groupchat"
HELP_COMMAND_UNMUTE: "<green>/groupchat unmute <gray>[member] <white>- unmute player on your current groupchat"
HELP_COMMAND_MUTED: "<green>/groupchat muted <white>- show muted players on your current groupchat"

Lines added (lang.yml, legacy format)

MESSAGE_FORMAT_HELPER: "&a<player> &7> &9<message>"
MESSAGE_FORMAT_MODERATOR: "&e<player> &7> &9<message>"
MESSAGE_FORMAT_TRUSTED_MODERATOR: "&6<player> &7> &9<message>"
MESSAGE_FORMAT_OWNER: "&c<player> &7> &9<message>"
INFO_GROUP_MODERATORS_HEADER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&b&l▸ &f&lModerators of &a<group>"
- "&7  Page <page>/<lastpage>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_MODERATORS_ENTRY: "&f<number>. &a<player>"
INFO_GROUP_MODERATORS_TRUSTED_ENTRY: "&f<number>. &a<player> &7&l(trusted)"
INFO_GROUP_MODERATORS_FOOTER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&fSwitch Page: &a/groupchat moderators &7<page>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_PLAYER_ALREADY_MODERATOR: "&fThis player is already moderator of this groupchat!"
INFO_PLAYER_ALREADY_TRUSTED_MODERATOR: "&fThis player is already trusted moderator of this groupchat!"
INFO_PLAYER_NOT_MODERATOR: "&fThis player is not moderator of this groupchat!"
INFO_PLAYER_NOT_TRUSTED_MODERATOR: "&fThis player is not trusted moderator of this groupchat!"
INFO_PLAYER_NOW_MODERATOR: "&fPlayer &a<player> &fis now moderator of this groupchat."
INFO_PLAYER_NOW_TRUSTED_MODERATOR: "&fPlayer &a<player> &fis now trusted moderator of this groupchat."
INFO_PLAYER_NOW_NOT_MODERATOR: "&fPlayer &a<player> &fis no longer moderator of this groupchat."
INFO_PLAYER_NOW_NOT_TRUSTED_MODERATOR: "&fPlayer &a<player> &fis no longer trusted moderator of this groupchat."
HELP_COMMAND_MODERATORS: "&a/groupchat moderators &f- show moderators of your current groupchat"
HELP_COMMAND_MODERATORS_ADD: "&a/groupchat moderators add &7[player] &f- add moderator to your current groupchat"
HELP_COMMAND_MODERATORS_REMOVE: "&a/groupchat moderators remove &7[player] &f- remove moderator from your current groupchat"
HELP_COMMAND_MODERATORS_TRUST: "&a/groupchat moderators trust &7[player] &f- trust a moderator in your current groupchat"
HELP_COMMAND_MODERATORS_UNTRUST: "&a/groupchat moderators untrust &7[player] &f- untrust a moderator in your current groupchat"
INFO_GROUP_MODERATORS_NONE: "&fThere are no moderators on this groupchat."
INFO_GROUP_HELPERS_HEADER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&b&l▸ &f&lHelpers of &a<group>"
- "&7  Page <page>/<lastpage>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_HELPERS_ENTRY: "&f<number>. &a<player>"
INFO_GROUP_HELPERS_FOOTER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&fSwitch Page: &a/groupchat helpers &7<page>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_HELPERS_NONE: "&fThere are no helpers on this groupchat."
INFO_PLAYER_ALREADY_HELPER: "&fThis player is already helper of this groupchat!"
INFO_PLAYER_NOT_HELPER: "&fThis player is not helper of this groupchat!"
INFO_PLAYER_NOW_HELPER: "&fPlayer &a<player> &fis now helper of this groupchat."
INFO_PLAYER_NOW_NOT_HELPER: "&fPlayer &a<player> &fis no longer helper of this groupchat."
HELP_COMMAND_HELPERS: "&a/groupchat helpers &f- show helpers of your current groupchat"
HELP_COMMAND_HELPERS_ADD: "&a/groupchat helpers add &7[player] &f- add helper to your current groupchat"
HELP_COMMAND_HELPERS_REMOVE: "&a/groupchat helpers remove &7[player] &f- remove helper from your current groupchat"
INFO_PLAYER_ALREADY_MUTED: "&fThis player is already muted on this groupchat!"
INFO_CANNOT_MUTE_YOURSELF: "&fYou can't mute yourself."
INFO_CANNOT_UNMUTE_YOURSELF: "&fYou can't unmute yourself."
INFO_PLAYER_NOW_MUTED: "&fPlayer &a<player> &fhas been muted on this groupchat by &a<executor>."
INFO_YOU_NOW_MUTED: "&fYou have been muted on groupchat &a<group>&f."
INFO_CANNOT_MUTE_HIGHER_RANK: "&fYou can't mute player &a<player> &fbecause they have equal or higher rank."
INFO_CANNOT_KICK_HIGHER_RANK: "&fYou can't kick player &a<player> &fbecause they have equal or higher rank."
INFO_CANNOT_BAN_HIGHER_RANK: "&fYou can't ban player &a<player> &fbecause they have equal or higher rank."
INFO_PLAYER_NOT_MUTED: "&fThis player isn't muted on this groupchat!"
INFO_YOU_NOW_UNMUTED: "&fYou have been unmuted on groupchat &a<group> &fby &a<executor>."
INFO_YOU_MUTED_CANNOT_SEND: "&fYou are muted on this groupchat. You can't send messages."
INFO_PLAYER_NOW_UNMUTED: "&fPlayer &a<player> &fhas been unmuted on this groupchat by &a<executor>."
HELP_COMMAND_MUTE: "&a/groupchat mute &7[member] &f- mute player on your current groupchat"
HELP_COMMAND_UNMUTE: "&a/groupchat unmute &7[member] &f- unmute player on your current groupchat"
HELP_COMMAND_MUTED: "&a/groupchat muted &f- show muted players on your current groupchat"
INFO_GROUP_MUTED_HEADER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&b&l▸ &f&lMuted players on &a<group>"
- "&7  Page <page>/<lastpage>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_MUTED_ENTRY: "&f<number>. &a<player>"
INFO_GROUP_MUTED_FOOTER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&fSwitch Page: &a/groupchat muted &7<page>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_MUTED_NONE: "&fThere are no muted players on this groupchat."
INFO_GROUP_BANNED_HEADER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&b&l▸ &f&lBanned players on &a<group>"
- "&7  Page <page>/<lastpage>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
INFO_GROUP_BANNED_ENTRY: "&f<number>. &a<player>"
INFO_GROUP_BANNED_FOOTER:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&fSwitch Page: &a/groupchat banned &7<page>"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
HELP_COMMAND_BANNED: "&a/groupchat banned &f- show banned players on your current groupchat"
INFO_BANNED_NONE: "&fThere are no banned players on this groupchat."
INFO_GROUP_CHAT_NOW_LOCKED: "&fChat has been locked by &a<executor> &fon this groupchat."
INFO_GROUP_CHAT_ALREADY_LOCKED: "&fChat is already locked on this groupchat."
INFO_GROUP_CHAT_NOW_UNLOCKED: "&fChat has been unlocked by &a<executor> &fon this groupchat."
INFO_GROUP_CHAT_NOT_LOCKED: "&fChat is not locked on this groupchat."
INFO_GROUP_CHAT_LOCKED_CANNOT_SEND: "&fChat is locked on this groupchat. You can't send messages."
HELP_COMMAND_CHATLOCK: "&a/groupchat lock &f- lock chat of your current groupchat"
HELP_COMMAND_CHATUNLOCK: "&a/groupchat unlock &f- unlock chat of your current groupchat"

This is the last release of plugin to keep support for very old Minecraft server implementations and beginning from next release, plugin will target Minecraft 1.20 and newer. By looking at bStats, this will have no impact on servers currently using GroupChat as >90% are running it on 1.21.x servers and the rest use 1.20.x builds.