Skip to main content

Frequently Asked Questions

General​

What happens when a group leader disconnects?​

Leadership is not automatically transferred on disconnect. The leader retains their position. If the leader leaves the group with /group leave, leadership transfers to the next member.

Do groups persist across server restarts?​

Yes. Permanent groups are saved to disk and restored when the server starts. Temporary groups (created by external plugins) are not persisted.

Can a player be in multiple groups?​

No. A player can only belong to one group at a time. They must leave their current group before joining another.

What is the maximum group size?​

The default maximum is 16 players, configurable via MaxGroupSize in config.json.

Can group members damage each other?​

By default, friendly fire is disabled. This can be changed via the FriendlyFire setting in config.json.

Commands​

Why can't I use group commands?​

Check that you have the appropriate permission. Each command requires a specific permission node (e.g., groupmanager.group.invite). See the Permissions page for the full list.

What do the aliases /g do?​

They are shortcuts for /group. All subcommands work the same way: /g invite Steve is identical to /group invite Steve.

I received an invitation but /group accept says "no pending invitations"​

Invitations expire after 30 seconds. If you waited too long, ask the sender to invite you again.

Teleport​

How do I teleport to a group member?​

Open the Group UI (/group) and click the TP button next to the member you want to teleport to. This feature must be enabled by the server admin (EnableTP: true in config.json).

My teleport was cancelled, why?​

If TpDelay is greater than 0, a countdown starts when you request a teleport. Moving more than 0.5 blocks during the countdown cancels it automatically.

Can I teleport instantly?​

Yes — the server admin can set TpDelay: 0 in config.json for instant teleport.

Chat​

How do I use group chat?​

Either use /group msg <message> or open the Group UI (/group) and go to the Chat tab.

How long are chat messages stored?​

Messages are stored for 24 hours (up to 200 messages per group). They persist across server restarts.

Public Groups​

How do I make my group public?​

Open the Group UI (/group), go to the Settings tab, and toggle the group to "Public". Only the group leader can change this setting. Only permanent groups can be made public.

How do I join a public group?​

Open the Group UI (/group) and go to the Public tab. You'll see a list of available public groups you can join.

Integration​

How do external plugins create temporary groups?​

Through the GroupService API:

GroupService api = GroupManagerProvider.get();
GroupResult result = api.createTemporaryGroup(leader, memberList);

Can I use GroupManager with other plugins?​

Yes — GroupManager exposes a full API that other plugins can use to manage teams during matches, minigames, or any group-based activity. See the Integration Guide for details.

The HUD isn't showing, what should I check?​

The HUD works out of the box with GroupManager's built-in InternalMultiHud — no external plugins are required. If the HUD isn't showing:

  1. Check server logs at startup for any errors.
  2. Verify the player is in a group — the HUD only appears for grouped players.
  3. If using an external HUD plugin, ensure it's installed and detected at startup.