Skip to main content

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

CommandDescription
/group invite <player>Invite a player (creates group if needed)
/group accept [groupId]Accept an invitation
/group decline [groupId]Decline an invitation
/group leaveLeave your current group
/group kick <player>Remove a member (leader only)
/group transfer <player>Transfer leadership (leader only)
/group disbandDissolve the group (leader only)
/group infoView group information
/groupOpen group management UI
/group helpShow command list
/group confirmToggle confirmation UI preference
Aliases

/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 CanLeaderEnablePvp is enabled by the server.
  • This setting is saved and persists across server restarts for groups.
Summary
FriendlyFireCanLeaderEnablePvpBehavior
falsefalseGroup members cannot damage each other. No PvP option in UI.
falsetrueLeader can toggle PvP per group via the Settings tab.
true(any)All group members can damage each other. No PvP option in UI.