Party System

How to establish parties, coordinate teammates, and use the four match modes: Queue, vs Party, Split, and FFA.

Creating a Party

/party create

This command designates you as the party leader, updates your hotbar inventory with quick party hotkeys, and configures the privacy setting to PRIVATE (invite-only) by default.

Inviting Players

/party invite Steve

Invited players receive a chat prompt with click-to-accept choices. Party invites remain active for party.invite-expiration seconds (default 60s) before timing out. Only the active leader can dispatch invites.

Joining a Party

Joining via invitation: Execute /party accept or click the accepting chat button prompt.

Joining open parties: If a party is set to PUBLIC or FRIENDS_ONLY, qualified players can join immediately using:

/party join <player>

Replace <player> with any online member of that party (not just the leader) - the plugin resolves their party and joins you into it.

Party Privacy Modes

Privacy Level	Setting Command	Join Behavior Rules
`PRIVATE`	`/party private`	Default. Players must be manually invited by the leader.
`PUBLIC`	`/party public`	Allows any server player to join immediately. Broadcasts a join notification link in chat.
`FRIENDS_ONLY`	`/party friends`	Only players present on the leader's friend list are authorized to join directly.

Party Member Sizes

The base capacity is the config value party.default-max-size (default 8 members) and requires no permission. The party leader's permissions can raise the limit:

Default Base Limit: up to 8 members (from party.default-max-size, no permission required).
VIP Limit Upgrade: up to 16 members (granted by shyamduels.vip via the party.size-permissions alias map, or a numeric node such as shyamduels.party.size.16).
VIP+ Limit Upgrade: up to 32 members (granted by shyamduels.vipplus, or a numeric node such as shyamduels.party.size.32).

The highest applicable limit wins.

Leaders can impose a custom member capacity limit using /party limit (launches sign text input) or return to max limits using /party resetlimit.

Play Modes

Leaders configure the active mode via /party mode <mode>. These modes dictate matchmaking behaviors:

Mode Style	Command Options	Matchmaking & Spawn Rules
Matchmaking Queue	`queue`, `q`	Queue the party into ranked/unranked team matchmaking. Party member counts must align with the target queue size.
vs Party Duels	`duel`, `vparty`, `vsparty`, `vs`, `pvp`	Directly challenge another active party to a team duel. Challenged leaders accept via `/party duel accept`.
Team Splitting	`split`, `team`, `teams`	Splits the party into two teams (uneven allowed, minimum 1 per team for battle-ready; equal-teams check is a separate validity gate). Requires at least 2 members. Cycle with `/party mode` with no args.
Free For All (FFA)	`ffa`, `freeforall`	Launches a chaotic match where all party members fight each other. Spawns members in a circle pattern.

Team Split Controls

In the party split screen, the party owner can pick up a member head and drop it on either team, or right-click/shift-click a member head to move that player directly to the other team. Members who are offline still remain manageable in the split layout.

Party Chat Channels

Activate party-only chat redirects using:

/partychat
# or:
/party chat

While toggled on, your message inputs are only displayed to party members. Leaders can mute and unmute specific members from the chat channel:

/party mute Steve
/party unmute Steve

Leadership Promotions

Leaders can hand over ownership permissions to another member using /party promote <player>. If the leader disconnects or leaves, leadership is automatically passed to the next eligible member (this transfer always happens; the party.transfer-ownership-on-leave config key exists but is not currently read by the plugin).

Disbanding Parties

/party disband

Disbanding kicks all members and restores their lobby hotbar items and game mode (members are not teleported). Parties also auto-disband if all players disconnect.

Exhaustive Party System Command Reference

Below is a complete command reference list for the party system:

Command	Syntax / Parameters	Functional Behavior
`/party create`	-	Creates a new private party with you as the leader.
`/party invite`	`/party invite <player>`	Dispatches a party invitation challenge to the target player.
`/party accept`	-	Accepts a pending party invitation.
`/party deny`	-	Declines a pending party invitation.
`/party join`	`/party join <player>`	Joins the public or friends-only party that the named player belongs to (any member works, not just the leader).
`/party leave`	-	Leaves your current party. If you are the leader, triggers leadership transfer.
`/party disband`	-	Disbands the party, returning all members to the lobby (requires leader confirmation).
`/party mode`	`/party mode <queue/duel/split/ffa>`	Sets the matchmaking mode style for the party matches.
`/party limit`	`/party limit`	Sets a custom maximum capacity limit for the party members.
`/party resetlimit`	-	Resets custom party limits back to your default permissions maximum.
`/party promote`	`/party promote <player>`	Promotes a party member to be the new party leader.
`/party mute`	`/party mute <player>`	Mutes a party member, blocking them from sending messages to the party channel.
`/party unmute`	`/party unmute <player>`	Unmutes a previously muted party member.
`/party private`	-	Sets party privacy mode to private (invite-only).
`/party public`	-	Sets party privacy mode to public (open to all).
`/party friends`	-	Sets party privacy mode to friends-only.
`/partychat`	-	Toggles your default chat output to party channel only. Alias: `/party chat`.
`/party kick`	`/party kick <player>`	Kicks a member from the party (owner only).
`/party announce`	`/party announce <message>`	Broadcasts an announcement message to all party members (owner only, subject to the announce cooldown).
`/party list`	-	Lists all party members in chat.
`/party uninvite`	`/party uninvite <player>`	Revokes a pending invitation (owner only).
`/party inviteall`	-	Invites all of your online friends to the party (owner only).
`/party refresh`	-	Refreshes party hotbar items for every member (owner only).
`/party info`	-	Shows party owner, member list, and current mode in chat.
`/party member` / `/party play`	-	Opens the party member/play GUI.
`/party manage`	-	Opens the party management GUI.
`/party settings`	-	Opens the party settings GUI (owner only).
`/party split`	-	Opens the team split screen (owner only, requires 2+ members).
`/party ffa`	-	Opens the Party FFA arena selection GUI (owner only).
`/party duel`	-	Opens the party-vs-party challenge GUI (owner only).
`/party duel accept`	-	Accepts an incoming party-vs-party duel challenge (owner only).

Admin Override Commands

/party forceowner          # Overrides party leadership, making you the owner.
/party forcejoin Steve Jim # Forces Steve into Jim's party, ignoring permissions.

Both commands require admin permissions (shyamduels.admin).