Message group

This feature allows players to message in private groups, just like Skype and other chat platforms!

Command

msggroup is the base command that gets registered, with the alias mg, it is associated with the permission node gssentials.gmessage. In order to create message groups, the player must have the gssentials.gmessage.create permission. On installation/update, there is an alias under aliases in the config that redirects /mga to /msggroup admin. The arguments are:

• /msggroup <group> <message> Send a message to a message group
• /msggroup <create|join|leave> <group> Create, join, or leave a message group
• /msggroup <invite|kick> <username> <group> invite or kick a player to/from a group
• /msggroup rename <oldname> <newname> rename a group

Admin commands (all require the gssentials.admin.gmessage.[name of command] permission, in addition to the base gssentials.admin.gmessage permission to use any admin command.):

• /msggroup admin listgroups List all the groups
• /msggroup admin <disband> <group> Disband a group
• /msggroup admin <makeowner> <group> <username> Set a user as the owner of a group
• /msggroup admin <join|kick> [username] <group> Remove or add a user to a group

Configuration

When you first install BungeeEssentials the command will be enabled, though if you wish you can disable it by removing msggroup from the enable section of the config file. All messages can be configured in the messages file.

Key	Default
msggroup.format	&9{{ NAME }} - {{ SENDER }} » &7{{ MESSAGE }}
msggroup.create	&aMessage group &f{{ NAME }} &asuccessfuly created! Invite players with /msggroup invite <username> {{ NAME }}!{{ HOVER: Click to prepare command. }}{{ CLICK: SUG: /msggroup invite <username> {{ NAME }} }}
msggroup.join	&aSuccessfully joined the &f{{ NAME }} &amessage group.
msggroup.leave	&aSuccessfully left the &f{{ NAME }} &amessage group.
msggroup.rename	&aMessage group &f{{ OLDNAME }} &arenamed to &f{{ NAME }}&a.
msggroup.invite.send	&aSuccessfully invited &f{{ PLAYER }} &ato the &f{{ NAME }} &amessage group.
msggroup.invite.receive	&aYou've been invited to join the &f{{ NAME }} &amessage group. Click to accept!{{ CLICK: /msggroup join {{ NAME }} }}
msggroup.kick.send	&aSuccessfully kicked &f{{ PLAYER }} &afrom the &f{{ NAME }} &amessage group.
msggroup.kick.receive	&cYou've been kicked from the &f{{ NAME }} &cmessage group.
msggroup.disband	&aSuccessfully disbanded the &f{{ NAME }} &amessage group.
msggroup.error.invalidname	&cMessage group names must contain lowercase letters only, and must be at least 3 letters long.
msggroup.error.nametaken	&cSorry, that name has already been taken.
msggroup.error.notinvited	&cSorry, you can only join message groups with an invite.
msggroup.error.notingroup	&cSorry, you're not in that message group.
msggroup.error.notexist	&cSorry, that message group doesn't exist.
msggroup.error.alreadyingroup	&cWhoops, I think you're already in that group!
msggroup.admin.listgroups.header	&6Message Groups:
msggroup.admin.listgroups.body	&f- {{ NAME }}: {{ MEMBERS }}
msggroup.admin.owner	&a{{ PLAYER }} is now the owner of the {{ NAME }} message group.

When adjusting the message format you may include any global variables as well as those listed below.

Variable	Replacement
{{ SIZE }}	The number of matching players found
{{ PLAYER }}	The name of a matching player
{{ TYPE }}	The type of info (e.g. uuid, ip, etc)
{{ INFO }}	The info as denoted by the above