Party Extension for Duels Optimized 1.16.2

✦ 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

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

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