ConquestDuels FREE v5.6.0

ConquestDuels v5.6.0 is now released, bringing major performance improvements, new PlaceholderAPI support for player stats, and cleaner internal systems.


1. Massive Join-Lag Fix (No More Mojang 429 Spam)
The stats listener has been fully refactored to remove all usage of Bukkit.getOfflinePlayer(String) during player joins.
This eliminates Mojang HTTP 429 lookup spam and prevents the main thread from stalling when players with unknown or new usernames join the server.
Join performance is now significantly smoother, especially on busy servers.


2. New PlaceholderAPI Placeholders for Player Stats
You can now display individual duel stats in scoreboards, TAB lists, holograms, menus, chat, or any PAPI-compatible plugin.


Available placeholders:

• %ConquestDuels_stats.kills%
• %ConquestDuels_stats.deaths%
• %ConquestDuels_stats.wins%
• %ConquestDuels_stats.losses%
• %ConquestDuels_stats.elo%
• %ConquestDuels_stats.kdr%
• %ConquestDuels_stats.winrate%
• %ConquestDuels_stats.totalduels%

Details:
Kills, deaths, wins, losses, and total duels return raw numbers.
ELO returns a formatted rating with 2 decimals.
KDR returns kill/death ratio with 2 decimals.
Winrate returns a percent value (0.00–100.00).


3. Existing Arena & Queue Placeholders (Unchanged but Included for Reference)
Examples:
%ConquestDuels_arena.totalQueueSize%
%ConquestDuels_queue.gamemode.SUMO.total%
%ConquestDuels_arena.Kyoto.queueSize%
%ConquestDuels_arena.Kyoto.BOXING.queueStatus%


These allow deep integration with queue systems, arena status UIs, and dynamic menus.


4. Performance & Stability Improvements

• Stats migration and lookup logic no longer causes Mojang API lookups.
• Reduced risk of lag spikes during peak hours.
• Better internal error handling for placeholder parsing.
• Stats file format remains unchanged; no data loss in the update.

Update v5.5.1 – Duel Return / Spectator Flow Polish


• Fixed double return & restoration
Players were being teleported back and restored twice after a duel. The return system has been corrected so every participant now goes through a single, clean post-duel return sequence.


• Improved deathless-duel spectator behavior
Eliminated players now remain in Spectator mode inside the arena until the intended delayed return, instead of being teleported out early by recovery logic.


• Straggler recovery is now truly “last resort”
The recovery sweep no longer runs instantly after a duel. It now executes after the main return delay and only teleports players who legitimately missed the primary return, preventing duplicates.


• Safer join/quit and boundary handling
Rejoin recovery, arena boundary checks, and forced extractions now avoid triggering additional teleports/restorations for players who have already been handled.


If you encounter any lingering issues with duel returns, spectator flow, or edge-case recoveries, feel free to report them so the system can be further refined.

ConquestDuels v5.5.0

• /duel stats fixed: now resolves player correctly and displays templated stats.
• /duel spectate: prevented late-join stuck bug (added safe return sweep + state restore).
• /duel spectate now checks command-restrictions.allowed-worlds (leave always allowed).

ConquestDuels v5.4.0 — smarter recoveries, cleaner endings, zero-dupe rejoin

What is it?
ConquestDuels is a modern duel framework for Paper/Spigot 1.21+. It handles matchmaking, arena flow, spectator logic, wager payouts, and safe returns, with optional WorldGuard + Vault integration.

Highlights in v5.4.0
• Rejoin Recovery: If a player quits mid-duel, they are restored on join to their pre-duel state and teleported out of the arena. Inventory dupe blocked.
• Boundary-Win Flight Fix: When a duel ends because an opponent leaves the arena bounds, the surviving player is returned with flight forcibly disabled (unless bypass perm).
• Unified End Teleport: Winners, losers, and spectators are teleported together first, then states are restored. No more mixed outcomes.
• Session Persistence: Sessions are not unregistered if any quitter still needs recovery. Arena cleanup proceeds, session stays resident until all quitters rejoin and are restored.
• Safer Spectator Handling: Eliminated players become duel spectators in-place; outsiders are ejected from arenas.
• WorldGuard-Aware PvP: Duel damage and potions cleanly override protected regions while respecting your policy.
• Economy Payout Guard: Wagers are paid after confirming economy is unlocked, with retries and logging.

Core Features
• Team vs Team and 1v1 flow
• Spectators and intruder ejection
• Deathless elimination → SPECTATOR mode
• Arena region awareness, entity purge, optional block snapshot/regen hooks
• Optional wagers with Vault
• Optional WorldGuard overrides for duel PvP and potions

New in v5.4.0 (Technical Notes)
• On PlayerJoinEvent, if the player left mid-duel, plugin wipes duel items, teleports to pre-duel location, then restores the saved DuelPlayerState.
• Session remains registered if anyone quit early; arena can still be cleaned and freed.
• End-of-game path teleports everyone first, then restores states, then forces flight off (admins with bypass are exempt).
• Boundary elimination triggers an immediate end; surviving winners do not regain flight inadvertently.

Commands (typical)
• /duel challenge <player>
• /duel accept
• /duel deny
• /duel spectate <arena>
• /duel leave
• /duel cancel (admin)

Permissions (examples)
• conquestduels.user.* — player commands
• conquestduels.admin.* — administration, force actions, bypass flight restore

Dependencies
• Paper/Spigot 1.21+
• Vault (optional, for wagers/payouts)
• WorldGuard (optional, for region-aware duel overrides)

Upgrade Guide (4.x/5.x → 5.4.0)
• Update the jar.
• If you customized duel end logic or teleport timings, review the new “teleport-all-then-restore” behavior.
• If you rely on admin flight, grant the bypass permission to staff.

Configuration Tips
• Set your duel spawn and arena regions clearly.
• Keep wager amounts reasonable; the payout guard will delay until economy unlock.
• Enable announcements if you want public win/loss messages.

Support
Bug reports with logs and steps to reproduce are appreciated. Include your server version, plugin version, and any custom config snippets related to duels.

ConquestDuels v5.3.0 — Clean lethal flow, smarter boundaries, zero stray sessions

TL;DR

• Lethal hits no longer cause vanilla death.
• Eliminated players are put into Spectator mode and wait until duel end.
• If eliminated players leave the arena region, they are sent back immediately.
• Duel sessions auto-close the instant every player has been safely restored.

Core Changes
- Deathless Lethal Flow (Phase 2)
• On lethal damage, the death is canceled.
• Inventory clears, player switches to Spectator mode.
• Duel continues for remaining teammates.
• At duel end: winners + losers all teleport home together at once.

- Boundary Extraction Upgrade
• Alive players leaving arena = elimination + safe return.
• Eliminated players leaving arena = immediate safe teleport (no delaying until duel end).
• Non-participants inside arena are still automatically removed.

- Session Lifecycle Cleanup
• Duel session unregisters itself the moment all relevant players have been handled.
• Prevents stuck arenas and leftover duel state.

Quality of Life

• Clear elimination chat message when leaving bounds.
• Winner-grace and item pickup locks always cleaned up properly.
• GUI menus refresh reliably after returning players.

Fixes

• Fixed eliminated players being “stuck” inside arenas during team duels.
• Fixed rare race conditions causing partial cleanup.
• Improved restore timing reliability on high-latency environments.

No configuration changes required. Safe drop-in update. Restart recommended.

ConquestDuels v5.1.0 — smarter arenas, smoother starts, sturdier failsafes


TL;DR Highlights

• Duelers who leave the arena are eliminated; spectators outside bounds are returned.
• Freeze phase now lets players eat, drink, and reorganize inventory (including smooth shift-click).
• Countdown & start flow hardened: announcements trigger at the right time and only if the duel is still active.
• New InsuranceManager: every 5s, safely restores any dueler found outside arena regions.
• Intruder logic cleanly distinguishes duelers vs spectators vs outsiders.
• Safer teleports, cleaner winner/loser handling, wager payout after economy unlock, and robust stat saving.

What’s New


Freeze Phase UX

• Players can eat food, drink potions, and freely manage their inventory during the freeze.
• Shift-click, hotbar swaps, and drag moves in the player’s inventory are explicitly allowed and feel native.
• Container interactions, entity interaction, item dropping, block place/break, damage, mounts, vehicles, and gliding are still blocked.

Countdown & Start Messaging

• Countdown ticks only announce when the duel is still active; start message fires precisely once per player at freeze end.
• Rewired game-end announce to mirror the previous release formatting while fixing double/late fires.

New Safety Net

• InsuranceManager runs every 5 seconds: scans active duels and safely completes/returns any participant who somehow ends up outside all arena regions.
• Lightweight iteration over active sessions and online members to avoid unnecessary RAM churn.

Result Handling & Economy

• Winners/losers set once; duplicate handling prevented.
• Wager payouts occur only after duel locks clear, with retries and clear logging on failure.
• Win/loss recorded for all participants; async save to keep tick time smooth.

Teleport & Metadata Guardrails

• Two-step “double teleport” with safe-teleport tokens to avoid interference from other listeners.
• Clear winner-grace and no-drops flags at the right moments to prevent edge-case grief or dupes.

Updated Permissions & Interaction

• Interacting a player to open the Duel Challenge Menu respects blocks and cooldowns while remaining responsive.
• NPCs (Citizens) are ignored for challenge interactions.

ConquestDuels v5.0.1
Released: 2025-10-23 (America/Chicago)
---------------------------------------------

Fixed

• Prevented misleading “earned $X” message when Vault deposit fails; now message only shows on true success.
• Resolved payouts being rejected while players are still duel-locked, leading to $0 balance despite success text.

Changed

• Payouts are now attempted after the duel economy lock lifts, with a retry loop (every 10 ticks, up to ~30s) for consistent cross-server timing.
• Reward calculation now guarded with Math.max(1, winningTeam.size()) to avoid divide-by-zero issues.

Added

• tryDeposit(...) helper that verifies EconomyResponse#transactionSuccess() before marking payout success.
• payWinnersAfterUnlock(...) helper and scheduled task to safely pay winners post-unlock, including success/failure messaging per player.
• Optional Logger.fine(...) trace for blocked deposits during duels, aiding diagnostics when log verbosity is increased.

Notes

• Essentials/Vault balance protections remain intact; deferred payouts ensure compatibility with existing hooks.
• Offline/eliminated winners are skipped as per existing logic; can be customized if needed.

ConquestDuels v5.0.0
Release Date: October 20, 2025




Added

• Added update notify feature to inform admins or players when a new ConquestDuels version is available.

Fixed

• Patched exploit allowing players to sneak extra items into duels by bypassing inventory checks.