justDuel | Duel System v4.0.6

[1] Kit creation works the way you'd actually type it now. Do /duel kit create <name> and it starts building your kit. Before this it just said "Player not found", because the command had no idea "kit" was a keyword and thought you were trying to duel a player named kit. Now /duel kit create, /duel kit save and /duel kit cancel all work and tab-complete as you type. The old /duel createkit, savekit and cancelkit still work too, nothing got removed, you've just got the obvious version on top of them.

[2] The admin menus aren't spitting out raw code anymore. A big chunk of /dueladmin was printing things like <yellow> and <gray> as literal text instead of the actual colors, the kit approval list, the world commands, validate, audit, the help pages, all of it. Every one of those lines runs through the proper formatter now, so the whole /dueladmin (or /da) interface reads clean instead of looking half broken.

[3] Players stop spawning inside blocks. People were landing stuck in terrain when they joined or respawned at the hub. Two separate things were wrong: the saved spawn wasn't centered on the block, so you could clip into the one next to it, and the join teleport never checked whether the spot was even open. Both are sorted. The spawn now saves dead-center on the block, and the join, respawn and back-to-hub teleports all look for a clear spot and lift you up out of any solid blocks before they drop you in.

[4] One thing worth doing after you update: stand where you want the hub and run /da system setspawn once. Your current saved spawn could still be a bad point from before the fix, and re-running it writes a clean centered one. If you forget, the new safety check still pulls players out of blocks on join, but setting it fresh gets you the exact spot you picked.

[5] Fixed the disconnects on 1.21.11. Players were getting booted with an "Internal Exception" the second the plugin tried to show an action bar, the queue timer, the idle hub bar, that kind of thing. The text library the plugin used to ship didn't know about the new Minecraft version and was quietly building broken packets, and the server kicked the player rather than send a bad one. That library is gone. The plugin uses Paper's own built-in text now, so action bars and titles show up and nobody gets dropped.

[6] Tidied up the Folia and reload side of things. Spawning a second queue NPC could throw an error, and the NPC bobbing animation could keep running after a reload and pile up. A scheduler fallback could also call itself in a loop and take the server down with it. All fixed. A few teleports that could error out on Folia now go through the safe async teleport that handles crossing regions and worlds.

[7] Keeping it off your survival worlds is just config. JustDuel only applies its arena rules inside arena worlds, so survival is already left alone there. The one thing that reaches everywhere is the hub pulling players in on join, so if you run duels next to a survival world, set hub.teleport-on-join and hub.hub-on-join to false and force-spawn-on-join to false, then put your duel hub and arenas in their own world. Players stay where they log out and only come to the hub when you send them.

[8] Runs on Paper 1.21.11, 26.1.x, Folia and Spigot, single server or cross-server over Redis, same as before.

### NEW

- Party menu. Open it with /duel party (or click the new Party item in /duel). You see your members, who the leader is, your pending invites, and shortcuts to queue the whole party for 2v2, 4v4 or FFA. Leader gets the kick / transfer / disband buttons. Everyone else gets a Leave button

### FIXED

• Items from the previous match used to sit in the arena if a player didn't pick them up. They are cleaned out every time a new duel starts now
• /queue jumped your mouse cursor to the middle of the screen when you clicked a kit.
• Settings menu blinked when you set a default kit. It now updates in place
• The Kit Editor and the Settings menu also stopped flickering when you click Back or the default-kit slot

### COMPATIBILITY

- Same single jar still works on Paper 1.21.1, 1.21.11, 26.1+, Folia 1.21.x and Folia 26.1+

### NEW

[1] Circular arenas. Use /dueladmin arena circle <name> and the tool walks you through center, edge, and the two spawn points. The fight is contained inside the actual circle, no more diagonal escapes. Particle preview during setup. No FAWE required
[2] 2v2, 4v4 and Free-For-All groundwork. The match types, the party commands, and the new config blocks are in this build. The team match itself goes live in the next build. 1v1 is unchanged

### FIXED

[3] When your opponent disconnected mid-duel, you used to get stuck in the arena with a frozen "Returning to Hub" bar. You now ride the countdown out and get sent home cleanly
[4] The plugin crashed when opening any GUI on Paper 1.21.4 and newer (and on Folia). Fixed
[5] Players sometimes lost the duel the instant they spawned with a "boundary violation" message. Fixed
[6] If the server crashed during a duel and the arena was in the same world as your spawn, you used to be left holding the kit inventory. The plugin now restores you correctly
[7] Spectators could send and accept duel requests while watching someone else fight. They can't anymore
[8] Cross-server matchmaking could occasionally start the same duel on two servers at the same time. Fixed
[9] The cross-server queue could freeze if a backend crashed at the wrong moment. The lock now expires on its own
[10] Startup banner used to say WorldEdit/FAWE was missing on installs that ship FAWE under its short name. Fixed
[11] Fixed a "Cannot open inventory" error in the kit-selection GUI
[12] Smooth teleport now reliably completes both hops on Folia
[13] The void-rescue safety net works on Folia again
[14] SMP-HARD loser restoration after the winner left works on Folia
[15] Servers like Leaf, Purpur, and Pufferfish are no longer mis-detected as Folia

### GUI POLISH

[16] Pages, sorts, filter changes and live opponent-inventory updates now refresh in place. Your cursor stays where it was instead of snapping to the centre on every page flip
[17] Menu transitions are smoother on Folia (no more 1-tick flicker between menus)

### TAB COMPLETION

[18] /duel and /dueladmin now suggest every subcommand the plugin actually accepts. Press Tab and you see the full menu instead of an empty list
[19] /queue suggests 1v1, 2v2, 4v4, ffa instead of returning nothing
[20] /duel party is fully tab-completable: invite, accept, deny, leave, kick, disband, transfer, list, queue
[21] Multi-mode arena setup commands (arena setup, arena addmode, arena removemode) now suggest the mode names too

### SMALL THINGS

[22] Pending party invites now expire on their own instead of piling up until you log out
[23] When a translation key is missing in messages.yml, players no longer see the raw key in chat. The admin gets a single warning in the console instead
[24] Permissions list in plugin.yml updated

### CONFIG

[25] New match-modes block: which modes are enabled, the default mode, FFA min/max players, team auto-balance toggle, glow colours, and win-condition rules
[26] New party block: enabled toggle, max party size, invite timeout, cross-server flag (reserved), disband-on-leader-quit, and leader transfer toggle
[27] Nothing in your existing config breaks. 1v1 servers can ignore both new blocks

### DOCUMENTATION

[28] New pages: Match Modes and Party System.
[29] Cleaned up an old broken section in the placeholders page

### COMPATIBILITY

[30] Verified on Paper 1.21.1, Paper 1.21.11, Paper 26.1+, Folia 1.21.x. The same single jar works on all of them

### FOR SERVER ADMINS

If your survivor was getting stuck on a frozen "Returning to Hub" bar after their opponent quit, this fixes it
If your console was full of Sound errors on Paper 1.21.4+ or 1.21.11, this fixes it
If your startup banner said WorldEdit was missing even with FAWE installed, this fixes it
Tab completion is fixed everywhere. Press Tab in /duel, /dueladmin, or /queue and you'll see the real menu
2v2 / 4v4 / FFA / parties land in stages. Data and commands are ready in this version, the actual team match flow ships in the next one. 1v1 stays exactly as it was
Just drop the new jar in. Your database upgrades itself on first start

---

### Fixed

• SMP-HARD: items duplicated when a loser typed /duel leave. Inventory is now cleared safely on every code path
• SMP-HARD: players sometimes got stuck on the "You Died" screen and couldn't respawn. They now respawn correctly
• Servers like Leaf, Purpur and Pufferfish were being mistaken for Folia. They are now correctly identified
• Plugin crashed at startup if WorldEdit wasn't installed. WorldEdit is now fully optional
• WorldEdit, FAWE, and PlaceholderAPI sometimes weren't detected on startup. Detection now waits until the server is ready
• Clickable chat messages and some text-formatting tags were being stripped. They render correctly now
• Various startup compile/build issues fixed

### Improved

• Internal database setup unified between the two storage paths (no more drift)
• WorldEdit-related code restructured so the plugin loads safely with or without WorldEdit
• Arena world initialization now waits for the server to finish booting
• Startup console output cleaned up

### Added

- New plugin-integration manager that handles WorldEdit, FAWE and PlaceholderAPI detection in one place

---

## Earlier development

Earlier development changes (before structured release notes):

• /duel leave now works correctly
• Match-timeout teleport now sends you to the right place after the match expires
• SMP-HARD restoration no longer leaves placeholder values showing N/A
• Various item-restoration race conditions fixed

[1] Full Folia support
[2] Fixed duplicate config
[3] Fixed match summary display
[4] Fixed platform detection
[5] Fixed world creation errors
[6] Fixed chunk loading spam
[7] Fixed entity removal errors
[8] Fixed scoreboard errors
[9] Improved player state restoration
[10] Enhanced arena system
[11] Reduced console spam
[12] Performance optimizations

• Fixed Random teleporting and double match starting
• Some other fixes

• Fixed Bug where Player could not break/place in arena world
• Added Placeholders
• Made Database more stable
• more fixes
• github updated (docs)

• MySQL & Redis added
• Cross Server Support (Experimental)
• Folia Support (Experimental)
• More Customization
• More Optimization
• AND MORE