🚀 Devoxy v2.0 - Official Release Changelog

Release Date: August 2026
Developer: SwarajDev
Target Platform: Minecraft Paper / Spigot 1.21 (JDK 21)
Repository: https://github.com/SwarajDev5/Devoxy
Discord: https://discord.gg/VbCg54EEY

---

🌟 Executive Summary

Devoxy v2.0 represents a complete major overhaul of the PvP Practice Core engine. This version introduces near-instant RAM-cached schematic arena resets, a fully customizable YML menu engine with 3 layout algorithms, an interactive kit editor, 1v1 queues with hotbar action items, party split duels, FFA arenas with 1st-death fix, 3x3 anti-spawn-trap protection, an interactive settings GUI, and native PlaceholderAPI integration.

---

🛠️ Detailed List of Changes & Features in v2.0

⚡ 1. Core Arena Reset Engine

• RAM Schematic Caching: Added in-memory byte array caching (byte[] cachedSchematicData) to eliminate disk IO during match resets.
• Instant 1-Tick Restoration: Arena blocks restore in a single server tick or via configurable phased tick speeds in config.yml.
• Unbreaking Blocks Protection: Added unbreakingb parameter support to protect specific block materials from damage.
• Block Drop Toggling: Arenas can toggle item drops (drops false) during duels.

🎨 2. Dynamic GUI & Menu Engine (menus/*)

• Customizable YML Menus: All menus are loaded dynamically from plugins/Devoxy/menus/ (queue.yml, ffa.yml, kiteditor.yml, settings.yml, duel_setup.yml).
• Layout Algorithms:
  • NORMAL: Leaves outer border rows clean (AIR) and fills inner slots (10-16, 19-25, 28-34).
  • TRIANGLE_DOWNSIDE: Arranges items in an inverted triangle pattern (slot 4, slots 10-16, slots 19-25, slots 30-32).
  • TRIANGLE_UPSIDE: Arranges items in an upright triangle pattern (slots 12-14, 19-25, 28-34, slot 40).
• Dynamic Kit Population: Menus automatically scan kits.yml and render only kits that currently exist on the server.
• Command Runner Engine: Supports [player], [console], [close], [message], and <delay=X> execution.

🎒 3. Kit System & Custom Kit Editor

• Interactive Kit Editor: /kiteditor edit <kit> allows players to customize personal item hotbar layouts in a dedicated arena session.
• GUI Display Item Command: /kit setitem <kitName> saves the held main-hand item as the GUI icon for that kit.
• Default Kit Generation: Automatically generates Test Kit (Iron Armor, Iron Tools, Water/Lava bucket, Planks, Cobblestone, Steak) if missing.
• Kit Controls: Per-kit damage multipliers (/kit damageset), hunger toggles (/kit hunger), and gamemodes (/kit gm).

🗡️ 4. Matchmaking & Queue Engine

• Auto-Closing GUI: Joining a queue automatically closes the GUI menu instantly.
• Hotbar Leave Item: Grants a &cLeave Queue &7[Right Click] Redstone item at slot 8 in hotbar when queued. Right-clicking leaves queue and restores spawn items.
• Dynamic Placeholders: Shows %devoxy_inqueue_<kit>% and %devoxy_infight_<kit>% in queue item lores.

👥 5. Party System & Party Battles

• Party Management: /party create, /party invite, /party accept, /party disband, /party kick, /party chat.
• Party Fight Modes: Support for Party vs Party duels, 2v2/3v3 Party Split duels, and Party FFA.

🏟️ 6. Free-For-All (FFA) Arenas

• First-Death Fix: Resolved Paper event cancellation issue on 1st death by scheduling clean next-tick spawn teleportation, resetting stats, and delivering kill/death messages.
• Spawn Teleport Healing: /spawn and /leaveffa restore health to 20, food to 20, extinguish fire (setFireTicks(0)), and clear potion debuffs.
• Killstreak Refills: Option kit_reset_on_kill automatically refills killer's kit and health upon slaying an opponent.

🛡️ 7. 3x3 Anti-Spawn-Trap Protection Region

• Protected Locations: 3x3 region around spawn1, spawn2, and center of all arenas, as well as global spawn and editor locations.
• Enforced Rules:
  • Prevents block placement inside the 3x3 region.
  • Prevents bucket liquids (water/lava) from being placed in the 3x3 region.
  • Prevents water/lava from flowing into the 3x3 region.
  • Prevents non-admins from breaking blocks inside the protection zone.

⚙️ 8. Interactive Player Settings GUI (/settings)

• Settings Menu: /settings or /options opens an interactive GUI for toggling Duel Requests (/dueltoggle), Auto GG (/autoggtoggle), and Spawn Teleportation.

📊 9. PlaceholderAPI & Messages Engine

• Native Placeholders: Implemented %devoxy_inqueue_<kit>%, %devoxy_infight_<kit>%, %devoxy_inffa_<arena>%, %devoxy_duels_wins%, and %devoxy_duels_loses%.
• Modern Message Colors: Complete revamp of messages.yml with modern Hex/MiniMessage color palette (&#FF9900, &#38BDF8, &#34D399, &#FB7185).

---