Groups
Groups allow players to team up. When integrated with other plugins, group members can be placed on the same team automatically.
Group Types
GroupManager defines group types via the GroupType enum (com.groupmanager.api.GroupType):
Permanent Groups (GroupType.PERMANENT)
- Created manually by a player using
/group invite <player>. - Persist between matches, reconnections, and server restarts.
- Have a designated leader who can invite, kick, and manage the group.
- Can be disbanded with
/group disband.
Temporary Groups (GroupType.TEMPORARY)
- Created programmatically by other plugins via the API.
- They exist in memory and are volatile, they serve to create a temporary coalition of groups.
Creating a Group
To create a group and invite a player:
/group invite <player>
If you aren't in a group yet, this creates a new permanent group with you as the leader and sends an invitation to the specified player.
Accepting / Declining Invitations
When you receive an invitation, you'll see it in chat with a clickable prompt (or a confirmation UI if enabled). You can also use commands:
/group accept [groupId]
/group decline [groupId]
The groupId is optional — if you only have one pending invitation, it's accepted/declined automatically.
Toggling Confirmation UI
By default, invitations show a pop-up confirmation UI. You can toggle this on/off:
/group confirm
When disabled, invitations are shown only in chat.
Group Management
Kicking Members (Leader Only)
/group kick <player>
Removes a member from the group. Only the group leader can kick members.
Transferring Leadership
/group transfer <player>
The current leader transfers leadership to another group member.
Disbanding the Group (Leader Only)
/group disband
Dissolves the group entirely. All members are removed and notified.
Group Information
Use /group info to see:
- Group ID
- Leader name
- All members and their online status
- Group type (permanent or temporary)
Or use /group to open a graphical interface to manage your group.
Group Commands Summary
| Command | Description |
|---|---|
/group invite <player> | Invite a player (creates group if needed) |
/group accept [groupId] | Accept an invitation |
/group decline [groupId] | Decline an invitation |
/group leave | Leave your current group |
/group kick <player> | Remove a member (leader only) |
/group transfer <player> | Transfer leadership (leader only) |
/group disband | Dissolve the group (leader only) |
/group info | View group information |
/group | Open group management UI |
/group help | Show command list |
/group confirm | Toggle confirmation UI preference |
/group can also be written as /g.
Activity Restrictions
When group members are participating in an external activity managed by another plugin, certain group operations are temporarily restricted:
- Cannot invite new members
- Cannot kick members
- Cannot accept invitations
These restrictions are lifted automatically when the activity ends.
Group PvP
By default, members of the same group cannot damage each other. This behavior is controlled by two configuration options that work together:
Global PvP (FriendlyFire)
When FriendlyFire is set to true in the configuration file, all group members can damage each other across all groups. The per-group PvP option has no effect in this case.
Per-Group PvP (CanLeaderEnablePvp)
When CanLeaderEnablePvp is set to true (and FriendlyFire is false), group leaders gain the ability to toggle PvP for their own group from the Settings tab in the group UI (/group).
- Each new group starts with PvP disabled by default.
- Only the group leader can toggle this setting.
- The PvP toggle only appears in the Settings tab when
CanLeaderEnablePvpis enabled by the server. - This setting is saved and persists across server restarts for groups.
FriendlyFire | CanLeaderEnablePvp | Behavior |
|---|---|---|
false | false | Group members cannot damage each other. No PvP option in UI. |
false | true | Leader can toggle PvP per group via the Settings tab. |
true | (any) | All group members can damage each other. No PvP option in UI. |