Party Extension for Duels Optimized v1.15.2

DuelsFlexParty v1.15.2
Config Migration Hotfix​

---

✦ Bug Fix

• Missing config keys now fill in on upgrade new keys (including the in-duel countdown messages from v1.15.0) weren't being added to existing config files on upgrade, so the countdown ran but showed no text. Fixed, any missing keys now fill in automatically when you update, your existing settings and customizations are kept untouched

---

Update now if you were on v1.15.0 or v1.15.1 and the in-duel countdown showed no messages.
Drop in the new jar and restart, the missing keys are added automatically.​

DuelsFlexParty v1.15.1
In-Duel Freeze Countdown + Sit Plugin Compatibility Fix
Combined 1.15.0 + 1.15.1 drop.​

---

✦ New Feature: In-Duel Freeze Countdown

No more chaotic match starts where players are swinging the instant they spawn in.

• After players are teleported into the arena and kits are equipped, they're now frozen for a short countdown, look around but no movement, no damage, no PvP
• Once the countdown finishes, everyone's released to fight at the same moment, standard duel behavior
• Configurable separately from the lobby start countdown, so you can tune them independently
• Set in-duel-countdown: 0 to disable and keep the old instant-start behavior
• Two new message keys: match-freeze-countdown and match-freeze-go

---

✦ Bug Fix

• Sitting players can now join matches properly if a player was sitting (via GSit or any sit plugin) when their match started, they'd get stuck in the lobby while everyone else fought. Fixed, sitting players are now stood up automatically before being teleported in

---

✦ New Config

YAML:

in-duel-countdown: 3   # seconds players are frozen in the arena before fighting (0 = disabled)

Auto-migrated on reload, your existing settings and comments are preserved.

---

✦ Version Breakdown

Version	Focus
1.15.0	In-duel freeze countdown, fair match starts where no one can move until the countdown ends
1.15.1	Sit plugin compatibility fix (GSit and others)

---

Update now for clean, fair match starts and proper sit plugin compatibility.
Defaults to a 3-second freeze, set in-duel-countdown: 0 to keep the previous instant-start behavior.​

DuelsFlexParty v1.14.0
Mid-Match Leave, Stop Match, Unstuck Guarantees & Duels Stats Crediting​

---

✦ New Features

1. Leave a Match Anytime

• /fp leave now works during a live match, not just in the queue
• Leaving an active match counts as a forfeit, the player is removed, sent back, and their inventory and XP are restored
• If your leaving ends the match (last player standing on the other side), it wraps up normally
• No more "not in queue" message when you're clearly mid-fight

2. Leaders Can End a Match Early

• /fp stopmatch lets the party leader stop a running match midway
• Ends with no winner, all players are teleported back and restored
• Works even if the leader already died or is spectating

3. No More Stuck Players

• Even with command whitelist or blacklist enabled during matches, /fp leave, /fp stopmatch, and /fp spec leave always go through
• Players can never be trapped inside a match by restrictive command lists

4. Optional: Count Results in Duels Stats

• Flip on duels-stats and a finished FlexParty match credits winners a win and everyone else a loss on their Duels profile
• Results now show on your Duels wins/losses leaderboards and in %duels_...% placeholders
• Off by default, opt in via config
• Wins and losses only (Duels has no kills or rating for non-duel matches), and draws, /fp stopmatch, and server shutdowns credit nobody

---

✦ New Config

YAML:

allow-leave-during-match: true
allow-stop-match: true

duels-stats:
  enabled: false
  credit-wins: true
  credit-losses: true

Auto-migrated on reload, your existing settings and comments are preserved.

---

Update now to let players leave mid-match cleanly, give leaders the power to end runaway matches, and optionally tie results into your Duels leaderboards.
Leave/stopmatch default on, Duels stats crediting defaults off, existing setups behave the same until you opt in.​

DuelsFlexParty v1.13.1
Critical Paper 1.21+ Startup Fix​

---

✦ Critical Bug Fix

• Extension no longer fails to load on Paper 1.21+ the stuck kit item cleanup added in v1.11.1 was throwing an error during startup on newer Paper builds because of a stricter naming rule, which killed the entire extension before it could register commands. That's why /fp create and other commands silently did nothing on affected servers
• Use Duels' own toggle instead the redundant cleanup check has been removed, Duels' built-in protect-kit-items: false setting handles the "Kit contents cannot be used when not in a duel" spam properly, so the FlexParty-side workaround was no longer needed

---

✦ How to Update

• Drop the new jar into plugins/Duels/extensions/
• Delete the old DuelsFlexParty-1.12.0.jar (or any earlier version)
• Restart the server
• If you're still seeing the "Kit contents cannot be used" message, set protect-kit-items: false in Duels' own config

---

Update now if you're on Paper 1.21+ and FlexParty commands aren't responding.
No config changes needed, drop in the jar and restart.​

DuelsFlexParty v1.13.0
Smart Config Updates That Preserve Your Customizations​

---

✦ New: Comment-Preserving Config Migration

No more losing your formatting, comments, or custom keys when the plugin updates.

• Comments and formatting preserved every line of your config.yml and gui.yml stays exactly as you wrote it on update, even after new keys are merged in
• Your customizations stick any keys you've added that aren't in the defaults are kept untouched, no more rewriting them after each version
• New defaults merged in cleanly only the keys the plugin added in this release are appended, with their inline documentation
• Version-aware both config files now track a config-version internally so upgrades from older installs are detected and handled automatically

---

✦ Changes

• Plugin tracking on bStats the bStats dashboard now tracks the actual FlexParty version, so you can see exactly which versions are running across servers
• Legacy GUI migration hardened the old gui.* keys-in-config.yml migration path runs earlier in the load sequence so nothing gets stripped during the new config update process
• Jar size up ~120 KB due to the bundled config library, total now around 663 KB

---

Update now for safer config updates that respect everything you've configured.
Fully backwards compatible, legacy installs are auto-detected and migrated, all your values and customizations preserved.​

DuelsFlexParty v1.12.0
Overcrowded Arenas + Stuck Kit Item Fix
Combined 1.11.1 + 1.12.0 drop.​

---

✦ New Feature: Overcrowded Arenas (Stacked Spawns)

Run parties bigger than the arena's spawn point count by stacking players onto shared spawns. Perfect for 30-50 player FFA matches on maps with only 8-15 configured spawns.

How it works

• allow-overcrowded-arenas: false (default off) flip to true to let parties exceed an arena's spawn point count, extra players are stacked onto existing spawns in a round-robin
• min-spawns-per-player: 0.5 caps how heavily spawns can be stacked

Stack ratio reference

Value	Stack ratio	Example (10-spawn arena)
1.0	No stacking	max 10 players
0.5	2 per spawn	max 20 players
0.25	4 per spawn	max 40 players
0.0	Unlimited	only max-players caps

GUI feedback

• Arenas that only fit your party via stacking now show as a yellow warning item in the map picker instead of being blocked
• Lore reads: ⚠ Your party is more than the set locations, there will be overcrowded situation.
• Arenas that exceed even the stack cap still show the barrier block as before

---

✦ Bug Fix: Stuck Kit Item Cleanup

• Stuck kit items finally cleared resolved a long-running issue where Duels' "[Duels] Kit contents cannot be used when not in a duel" message would keep firing on every interaction, surviving server restarts, on every kit, regardless of the save-inventory toggle
• Root cause the previous restore was scheduled to run a tick after shutdown, but the server was already stopping the scheduler by then, so tagged kit items got saved into player files and triggered the message forever
• The fix inventory and XP are now written to disk synchronously on shutdown (no scheduler dependency), so /stop, crashes, and even kill -9 all restore cleanly on the next start
• Retroactive cleanup players already stuck before this patch just need to log out and back in once, a join-time scrub strips any lingering stuck items automatically
• Optional toggle cleanup.scrub-stuck-kit-items: true (default on) controls the retroactive scrub

---

✦ Changes

• Single source of truth for max players every part of the plugin (arena lookup, GUI builder, preferred-arena gate) now computes "max players this arena can hold" from one place, so all paths agree on overcrowding rules
• FFA single-spawn floor relaxed arenas with just one spawn point can now run FFA matches (teams mode still needs at least two spawns for proper team placement)
• Extension manifest version synced extension.yml was stale at 1.9.0, now matches the actual plugin version

---

✦ New Config

YAML:

allow-overcrowded-arenas: false   # let parties exceed spawn count
min-spawns-per-player: 0.5        # cap stacking ratio when overcrowding is on

cleanup:
  scrub-stuck-kit-items: true     # retroactive scrub for stuck players

Auto-migrated on reload, no manual edits required.

---

✦ Version Breakdown

Version	Focus
1.11.1	Stuck kit item fix, synchronous shutdown restore, retroactive join-time scrub
1.12.0	Overcrowded arenas with stacked spawns, yellow warning in map picker, single-source max-players calc, FFA single-spawn allowance

---

Update now for massive 30-50 player FFA on small arenas and a permanent fix to the stuck kit item message.
Overcrowded arenas default to off, existing setups behave exactly as before until you flip allow-overcrowded-arenas: true.​

DuelsFlexParty v1.11.0
Direct Party Invites with Built-In Spam Controls​

---

✦ New Feature: Party Invite System

No more relying on the chat broadcast getting buried in conversation, invite players directly.

Commands

• /fp invite <player> sends a clickable invite to a specific player
• /fp invite all invites every online player at once (off by default, opt-in via config)
• Clicking an invite joins the party through the normal join path, so your whitelist/blacklist still applies

Built-In Spam Controls

• 30-second per-target cooldown, re-inviting the same player tells you how long to wait instead of just "already invited"
• 120-second cooldown between /fp invite all uses on the same party
• Auto-skips players already in a party or match
• Stops sending invites once your party is full
• Configurable title and sound when someone gets invited

---

✦ New Config

YAML:

invites:
  allow-invite-all: false   # flip to true to enable /fp invite all

Plus configurable invite title, sound, and cooldown values, all auto-migrated on first startup.

---

Update now to send invites directly instead of hoping players see the broadcast.
/fp invite all stays off by default, your existing setups behave exactly as before until you opt in.​

DuelsFlexParty v1.10.0
Manual Map Selection with Live Reservation​

---

✦ New Feature: Pick Your Map

• A new map button is added to the party creation GUI, click it to pick a specific arena from a list, or leave it on Any Map for the previous auto-pick behavior
• Live arena reservation the chosen map is locked to your party the moment you create it, no more /duel requests or other parties sniping your arena while you're still filling slots
• See what's taken other players see your reserved map shaded in their picker with your name on it, so they know to wait or pick something else
• Smart player-count adjustment pick a smaller map and the player count automatically scales down to fit

---

✦ New Config

YAML:

manual-map-select: true     # set false to hide the GUI button and stay auto-pick only
reserve-arena: true         # already on by default, now covers both queue and match time

Auto-migrated on reload, no manual edits required.

---

Update now to let your players pick their arena and lock it in the moment they create a party.
Existing setups behave the same out of the box, leave the new GUI button untouched for auto-pick or set manual-map-select: false to hide it.​