✅ ConquestDuels v4.6.7 Released!

This update improves stability for servers that do not run WorldGuard. Previously, if WorldGuard was missing but enabled in config, the plugin could fail to start. We've now safely isolated all WorldGuard integration using reflection — no more startup crashes when optional dependencies are absent!

WorldGuard integration
- Custom flags (duel-force-pvp, duel-force-handle-death) are now registered only if WorldGuard is present.
- Region checks for PvP and death handling are fully reflection-based.
- Works even if WorldGuard is added or removed between restarts.

Tested on:
Paper 1.21.6 (build 34) — everything loads and works great!

Thanks to everyone continuing to support ConquestDuels ❤️
Have feedback or requests? Drop them below or ping us on Discord.

Just A Small Bug Fix

ConquestDuels v4.6.5
Released: 2025-06-09
✦ Summary:
Improves arena initialization after setup — no more plugin reloads required!
✔ Arena Save Improvements

• New arenas now generate and store default icon data immediately when saved.
• Players no longer need to reload the plugin to make newly created arenas appear in menus.
• Internal memory state stays in sync with data.yml after setup.

✔ Quality-of-Life Tweaks

• Slight internal refactor to support consistent icon handling across reloads and GUIs.
• Added fallback validation when custom icon data is missing.

ConquestDuels v4.6.4 - Potion Logic & PvP Handling Fixes
We’ve refined potion behavior and PvP overrides to be smarter and fully aligned with WorldGuard flags and team logic. This update makes sure duels feel clean, fair, and intuitive across all arena settings.
⚔️ PvP Knockback & Behavior
- Fixed excessive vertical knockback stacking during spam hits
- Properly scales knockback with enchantments and sprinting
- Custom knockback is now applied only when PvP is region-denied but duel-override is active
Splash & Lingering Potion Rework
- Fixed splash potions ignoring WorldGuard’s POTION_SPLASH flag when duel-force-pvp was disabled
- Friendly potion effects (e.g. strength, regen, speed) always apply to teammates, even if PvP is blocked
- Throwers no longer bypass splash-deny flags and are correctly affected or blocked based on region rules
- Lingering cloud effects now follow the same rules as splash potions
Death & Respawn Polish
- Fixed duel players sometimes not teleporting back on respawn
- Ensured death messages and teleport logic are synced correctly
- Spectators who die or quit are returned to their original location safely
️ Other Fixes
- Improved double-teleport logic to eliminate false boundary eliminations
- Prevented passive mobs or item drops during duel eliminations
- Cleaned up various metadata and session flags for consistency
Thank you to all testers reporting edge cases. This patch continues improving support for competitive PvP and spectator integrity inside arena regions!
Stay dueling,
- The ConquestDev Team

⚔️ Conquest Duels v4.6.3 - Controlled Death Handling!
A strong update focused on post-duel cleanup control and deeper WorldGuard integration.

• ✔ NEW: Introduced custom WorldGuard flag: duel-force-handle-death
• Suppresses drops, corpses, head plugins, chest placements, and other post-death effects
• Applies only to duel deaths inside regions with the flag set to ALLOW
• Suppression lasts 2 seconds after player death — clean and lightweight
• Prevents plugin-driven item/block/entity spawns near the death zone

• ✔ IMPROVED: duelPlayerDeath() logic now marks elimination and suppression correctly
• Adds safe teleport metadata and prevents premature plugin interference
• Integrated with Paper's fast respawn system

• ✔ API Notes: Use DUEL_NO_DROPS and DUEL_WINNER_GRACE metadata to control item drops or reward behavior
• WorldGuard flag registration happens early — no more conflicts or double registers

Testing Tips:

• Mark a region: /rg flag duel-arena duel-force-handle-death allow
• Run a duel, and watch item drops, death chests, heads, and corpses be fully suppressed
• Works alongside Vault, PlaceholderAPI, and other plugin dependencies

[size=15pt] Update v4.6.2 – Duel Teleport & Knockback Fixes[/size]
Teleport Fixes

• Fixed players who instantly respawn (Paper) being sent to spawn instead of pre-duel location
• Improved teleport safety logic with proper duel metadata tags
• Cleaned up metadata flags after respawn and teleport completion

⚔️ Combat Logic Tweaks

• Sprint attacks now correctly apply extra knockback force
• Knockback is now fully clamped with resistance and enchantment modifiers
• Prevented rare vertical knockback stacking from duels

Other Fixes

• Fixed forfeited/left players being mishandled during end-of-duel cleanup
• Added safeguard for spectators dying mid-duel

Update strongly recommended for any server using Paper or fast-respawn mechanics. Thanks for all the bug reports and feedback — we're getting close to feature-lock!
— ZoneZone Dev Team

Update 4.6.1 - Stability, Bugfixes & Precision Tweaks
What’s New in 4.6.1
We’ve crushed some nasty bugs and smoothed out critical edge cases to make your duels feel tighter, cleaner, and more reliable than ever.
✅ Fixes & Improvements:

• Fixed: Rare issue where players would be eliminated by boundary enforcement even after winning a duel.
• Fixed: Edge case where duel end logic fired twice, causing duplicate end messages and double wager payouts. (Now fully atomic with session flags!)
• Fixed: Missing arena availability reminders — players now get notified properly when waiting on the arena itself, not just for other players.
• Improved: Knockback calculations now respect sprint status, enchantments (Knockback/Punch), and apply more accurate velocity with resistance.
• Improved: Boundary enforcement no longer penalizes players marked as winners or teleporting back.
• Fixed: Forfeit and teleport metadata now cleans up more reliably during respawn and match end.
• Improved: All teleportation uses a double-teleport buffer to ensure safety from anti-cheat and plugin interference.
• Fixed: Queue reminder system no longer ignores overflow queues — reminder messaging is now context-aware and arena-sensitive.
• Improved: Region PVP overrides are more responsive and apply only when valid WorldGuard flags are detected.

Under the hood:

• Sessions now track a duel result processed flag to prevent double-finalization across death/quit/boundary triggers.
• Winner protection metadata ensures clean teleportation and safe exits after match end.
• Spectators and late rejoins get cleaned up more gracefully.

⚙️ Recommended for all servers.
If you’re running any version below 4.6.1, this is a must-upgrade — especially if you use wager duels, custom queues, or arenas with strict boundaries.
Thanks for all the bug reports and feedback — keep it coming!

Command Restriction System Overhaul

• - Added support for tiered whitelists: global, duel, and spectator-specific commands
• - Fully supports subcommands like /duel spectate <player> or /duel spectate leave
  [*]- Now checks spectator state before duel participant state for reliable enforcement
  [*]- New YAML config format: easier to read, better separated
  [*]- Fixed issue where both duelers and spectators could access /duel spectate
  

️ /duel forfeit — Surrender Mechanic

• - New command: /duel forfeit lets you surrender mid-duel
  [*]- Instant defeat with sound, particles, and bossbar feedback
  [*]- Only usable during an active duel (and configurable!)
  [*]- Message support included in generalMessages.yml
  

Improved Help & Permissions

• - Added /duel forfeit to the help menu
  [*]- Added new permission: conquestduels.user.forfeit
  [*]- Full integration into plugin.yml and PermissionModels enum
  [*]- Help menu now uses consistent suggest-command click types

⚔️ ConquestDuels 4.5.0 – WorldGuard + Global Duel Spawn Support!
What's New:

• /duel admin setduelspawn
  Admins can now define a global fallback duel spawn location used when no arena is selected. Great for simplified duels, free-for-alls, or instant matchmaking setups.
  - Saves to config under:
  duel-spawn:
  
  
  world: world
  x: 0.0
  y: 90.0
  z: 0.0
  ​
  
  - Players will be teleported here if no arena is chosen or configured.
  - Works seamlessly with `/duel queue` or direct challenges.
  - Permission required: conquestduels.admin.setduelspawn
• ✅ Command Confirmation
  Beautifully styled response confirms the location with particles, sound, bossbar, and hover info. Admins will know exactly when it's locked in!
• Command Restriction Fixes
  Commands like /duel spectate, /duel spectate leave are now properly allowed inside restricted duels and spectator sessions via flexible command prefix matching.
• ⚙️ New Flag: duel-force-pvp
  WorldGuard region flag to enforce PvP even in no-PvP areas. Controlled via config:
  worldguard.enforce-duel-pvp: true
• Config & Code Cleanup
  Optimized config loading, removed redundant checks, and improved listener setup to ensure snappy performance.

How to Use:

1. Stand at your preferred duel spawn location.
2. Run /duel admin setduelspawn
3. You're done! ConquestDuels will now use that spot when no arena is specified.

Reminder:
Don’t forget to grant conquestduels.admin.setduelspawn to your staff in LuckPerms or permissions.yml!
Thanks for supporting ConquestDuels! More kit queue updates & region-based duel logic coming soon.

ConquestDuels v4.4.0 - Spectator Overhaul! ️
The long-awaited spectator system has arrived, fully integrated and battle-tested!
Players can now watch live duels, teleport between active fights, and gracefully return to their original location after the match.

• NEW: Fully functional /duel spectate system with return handling
• NEW: Spectators who disconnect or relog will be safely restored
• NEW: Support for spectators who stay until the end — automatic teleport & cleanup
• NEW: Spectator command restrictions via configurable whitelist
• NEW: Boundary enforcement for spectators who wander out of the arena
• Improved: Winner cleanup logic is now smarter, safer, and immune to bad teleports
• Improved: Duel rejoin handling is rock solid — even hours later

This update paves the way for future tournaments, live arenas, and streaming integration. Thanks for all the feature requests and bug reports — keep them coming!
⛏️ Test it out, and let us know what you think!

ConquestDuels v4.3.0

Wagered Duels Have Arrived!
Duel Wagering System (NEW!)

Put your money where your sword is — players can now issue wagered duel challenges using in-game currency!
Requires Vault and a compatible economy plugin like EssentialsX or CMI.
✔ Command Support
✔ How It Works

• Both players must have the required funds
• Funds are reserved before the duel begins
• Winner receives the full prize pool
• Duel cancels if funds are missing at any step

⚠ Requirements

• Vault plugin installed
• Economy plugin like EssentialsX or CMI

ConquestDuels V4.2.4 Released!
Updates:
- Fixed Arena GUI seticon command
- Fixed Overflow for team dueling
- Fixed own-inventory (player-head) not showing the player's own head
- Fixed Boundary Check For Instant Respawn
- Fixed Interaction Message On Disabled World During Duel

ConquestDuels v4.2.3
✅ What's New:

• Improved Kit Loading Safety – Kit inventory, armor, and potion effects now deserialize safely with proper type handling. No more console warnings!
• Fixed Immutable Map Crash – Offhand item data is now wrapped in a mutable map to avoid Bukkit serialization issues.
• Config Compatibility – Older `.yml` kit files load gracefully even if they contain unexpected keys like `slot` or `armorSlot`.
• Cleaner Console Logs – Removed unchecked cast warnings and added fallback protections.

Thanks for using ConquestDuels! ⚔️

ConquestDuels 4.2.2
✔️ Improved restriction logic during duels:

• Players who already completed the duel and were teleported back are now exempt from:
  - Arena boundary checks (no more insta-deaths post-match)
  - Teleportation blocks
  - Command restrictions
• All systems now properly recognize the post-duel state using session.hasTeleportedBack(uuid)

These changes make duel cleanup safer and prevent false positives from lingering restrictions.

Update 4.2.1 – Minor Fixes & QoL
- ️ Fixed a bug where clicking players in the Challenge Menu would incorrectly open the Gamemode Selector even when team-dueling was disabled.
- When , 1v1 duels now properly skip gamemode selection and go straight to arena selection as intended.
Thanks to everyone reporting tiny edge cases — your feedback helps polish every detail!

Update 4.2.1 – Minor Fixes & QoL
- ️ Fixed a bug where clicking players in the Challenge Menu would incorrectly open the Gamemode Selector even when team-dueling was disabled.
- When , 1v1 duels now properly skip gamemode selection and go straight to arena selection as intended.
Thanks to everyone reporting tiny edge cases — your feedback helps polish every detail!

New & Improved

• Improved Queue Reminders — Players now reliably receive timed reminders if their queue is waiting on players or if an arena is missing. Messaging is consistent and unaffected by voting phase states.
• Queue Entry Confirmation Overhaul — Confirm menus for team-based gamemodes now properly enqueue players and assign arenas. Prevents silent failures due to missing logic hooks.
• Refactored Kit Voting Behavior — Voting sessions now cleanly separate between solo and team gamemodes, preventing cross-mode inconsistencies.

Fixes

• ✅ Fixed 1v1-exclusive game start issue — Non-1v1 gamemodes can now launch properly through queue joins instead of relying on `DuelRequestManager`.
• ✅ QueueState tracking stability — Queue models now ensure state is `WAITING` by default and transitions are tracked properly across menus and listeners.
• ✅ Arena confirmation menus now reopen reliably after cancel or back navigation, with context-aware routing to SelectGamemode or ArenaSelector menus.
• ✅ Custom Kit filler buttons no longer break GUI handling — KitSelector GUI now treats empty filler slots correctly without interrupting selection logic.

Internal Improvements

• Code (Text):

  DuelBuildingListener
  logic cleaned up to reduce redundant context checks and improve code readability.
• Queue join confirmation and kit voting logic now cleanly separated for future team support.
• Stale GUIs now properly auto-close if left open too long.

[hr]
New in 4.1.0:

• Added full PlaceholderAPI support for queue tracking
• Supports arena-specific and gamemode-specific placeholders
• Works perfectly with DecentHolograms, scoreboard plugins, and tab lists

Available Placeholders:
Example Usage:
Notes:

• Gamemode IDs are based on internal enum names (e.g., PVP_1V1, PVP_2V2)
• Returns `"waiting"` or `"empty"` for queueStatus
• More player-specific placeholders coming soon!

[hr]

✔ Complete Rewrite of All GUI Menus
Menus have been restructured for faster loading and real-time updates. This includes:
- Challenge GUI
- Arena Selector
- Gamemode & Kit Selector
- Confirmation Menu
✔ New Icon Editing Command
Use to customize any icon directly in-game. Supports:
- Live preview from item in hand
- Kit vote/select states
- Arena buttons and more

⚔️ ConquestDuels vX.X.X - Security & Arena Logic Update
This update brings major improvements to duel arena enforcement, teleport security, freeze logic, and GUI restrictions.
New Arena Enforcement Features
• Arena Boundary Protection
Players who escape the duel arena bounds will now be instantly eliminated using proper elimination logic — just like a real in-game death.
No more item dupes or glitch-abuse escapes.
• Internal Boundary Scanner
A new background task checks player positions every 5 seconds during active duels. If you're outside the valid arena zone, you’ll be removed from the match.
Teleport Restrictions (with smart exceptions)
• Teleport Prevention During Duels
All teleportation is now blocked during active duels, unless:

• The player uses an Ender Pearl
• The plugin marks the teleport as DUEL_SAFE_TELEPORT
• The player has the new permission: conquestduels.admin.duel.bypass

❄️ Freeze Logic Improvements
• Movement Lock Now Fully Protected
Previously, frozen players could bypass restrictions via glitchy movement. Now:

• We cancel micro-movements instead of using teleport (no spam)
• If internal movement correction is needed, it's safely marked as DUEL_SAFE_TELEPORT
• TeleportEvent spam is fully resolved

GUI Restrictions
• Ender Chest Access is Blocked During Duels
Players can no longer access Ender Chests — either by right-clicking or GUI commands — during active duels.

• Blocked via PlayerInteractEvent
• Blocked via InventoryOpenEvent
• Admin bypass available: conquestduels.admin.duel.bypass

Admin Bypass Permissions
Admins now have two critical permissions for moderation and test use:

• conquestduels.admin.arena.teleport – bypass teleport blocking
• conquestduels.admin.duel.bypass – bypass GUI and interaction restrictions

Summary

• ✅ Arena escape = proper elimination
• ✅ Teleport blocking with intelligent exceptions
• ✅ Frozen state is truly locked
• ✅ Ender Chest use fully blocked
• ✅ Admins have clean bypass options

Want to suggest a feature or report a bug?
Join our dev Discord or open an issue via GitHub!
Stay deadly,
— The ConquestDuels Dev Team

♻️ ConquestDuels Update – Smarter Reload & Team Protection
✅ Improved /duels reload behavior:

• Dead players are now force-respawned and safely teleported back
• All boss bars (including animated ones) are now cleared on reload
• GUI/editor states and matchmaking queues fully reset
• Recovering duel sessions now handles teleportation, state restore, and clean unregistering

️ Added teammate PvP protection during duels:

• Prevents players from damaging their own team during an active duel
• Supports both melee and projectile (arrow/snowball/etc.) attacks
• Optional message when damage is blocked

This update ensures cleaner mid-game reloads, safer state restoration, and fairer fights — no more accidental friendly fire!
Thanks as always for testing, reporting, and playing!

⚔️ ConquestDuels – Command Restrictions Update
We're excited to introduce a powerful new feature for server owners who want more control over player actions during duels!
️ Command Whitelist System
Prevent abuse, cheating, or unfair advantages by blocking all non-whitelisted commands for players who are actively in a duel.
✅ Configuration Example
Add this to your :
Permission Node
Give players the following permission to bypass the command restriction:
Customizable Message
If a command is blocked, players will see the message:
Make it shine with sounds, particles, and MiniMessage formatting in your generalMessages.yml.
Need More Power?
Combine this feature with world restrictions for full control over where and how duels operate.

We've patched a key issue where duel interactions were triggering on NPCs created by the Citizens plugin. This led to unintended duel menu openings when right-clicking or attacking NPCs.
What’s Fixed:

• All duel-triggering interactions now properly ignore Citizens NPCs.
• PlayerInteractEntityEvent, EntityDamageByEntityEvent, and ray-trace triggers are all filtered.
• Added a helper method isNPC(Player) for centralized Citizens checks.
• Updated pom.xml to include the Citizens API as a provided dependency.

Update 3.1.0

• ♻️ Improved Queue Management for Duels: Players now automatically leave any existing queues when accepting or auto-accepting a duel request.
• Fixed Persistent Queue Ghosting: Resolved a critical bug where players remained marked as "queued" internally, blocking duels and menus even after leaving queues.
• Internal queue counts (arena.incrementQueue()/decrementQueue()) now sync properly when joining or leaving queues.
• Fully clears both the QueueModel and GUI state when duels are accepted or plugin is reloaded.
• ✅ Applies to manual accept and reverse-match scenarios.
• GUI now accurately reflects queue status — no more false “already queued” errors.