Devoxy Practice

Devoxy is an all-in-one, ultra-optimized PvP Practice Core engineered for Minecraft 1.21 Paper and Spigot servers. Built for maximum performance, clean architecture, and total configuration flexibility, it provides a seamless, lag-free experience for competitive practice networks, duel servers, and FFA arenas. OPTIMIZED

Explore the Visual Showcase: Check out the official Devoxy Gallery Page to preview screenshots of the in-game menus, arenas, and layout designs.

---

⚡ Core Highlights & Architecture

• ⏱ Instant 1-Tick Schematic Resets: Dual-layer RAM schematic caching system (byte[] cachedSchematicData) ensuring zero disk read delays during arena rollbacks.
• ◫ Dynamic Menu Engine: Fully customizable YML menus (menus/*.yml) supporting versatile layout types (NORMAL, TRIANGLE_DOWNSIDE, TRIANGLE_UPSIDE) and comprehensive click modifiers.
• 🛡 3x3 Anti-Spawn-Trap Protection: Secures designated regions around spawn points (spawn1, spawn2, center) against block placement, liquid flow, and unauthorized breaking.
• ☌ PlaceholderAPI Integration: Native expansion support for tracking queue sizes, active matches, FFA players, and personal statistics.

---

📂 Feature Systems Breakdown

⚔ 1. Queue Fights & Matchmaking Engine

• Dynamic Queue GUI (/queue): Displays active kits dynamically based on server configurations.
• Smart Allocation: Automatically pairs players in unranked or ranked queues, loads cached schematic block snapshots, and starts the match countdown.
• Hotbar Integration: Joining a queue auto-closes the menu and grants a redstone leave item in slot 8 (/queue leave).

⚔ 2. Duel System

• Direct Challenges: Send and manage 1v1 challenges using /duel <player>.
• Request Management: Toggle incoming duel requests instantly via /dueltoggle.
• Custom Settings: Fully integrated with personal player settings for streamlined match organization.

👥 3. Party System

• Management Tools: Create, invite, accept, and disband parties seamlessly using /party commands.
• Dedicated Channel: Use private party chat channels to coordinate strategies with your teammates.
• Party Settings: Interactive menus to configure group permissions and privacy.

⚔ 4. Party Fight System

• Party vs Party: Challenge rival parties to coordinated group skirmishes.
• Party Split: Automatically divide your party members into two balanced teams for practice duels.
• Party FFA: Last-man-standing free-for-all battles exclusively among party members.

🎒 5. Kit System & Kit Editing System

• Interactive Editor (/kiteditor): Allows players to rearrange items, preview layouts, and save custom hotbars per kit.
• GUI Icon Customization: Set any item held in hand as the official menu display icon (/kit setitem <name>).
• Advanced Administration: Configure custom damage multipliers (/kit damageset) and toggle hunger loss per kit.

⚑ 6. Arena System

• Instant Join FFA (/joinffa): Free-For-All arenas featuring instant respawns and stat tracking.
• Killstreak Refills: Option to automatically refill a player's kit and health upon slaying an opponent (kit_reset_on_kill: true).
• Clean Exits: Safe teleportation back to spawn with status effect clearing via /leaveffa or /spawn.

⚙ 7. AutoGG & Misc Settings

• Interactive Menu (/settings): Accessible configuration hub for player preferences.
• Auto-GG Toggle (/autoggtoggle): Automatically broadcasts a "gg" message upon match completion.
• Teleport Preferences: Quick utilities for returning to global spawn or dedicated editing zones.

---

📊 PlaceholderAPI Expansion Reference

Devoxy registers placeholders under %devoxy_%:

Placeholder	Description
%devoxy_inqueue_<kit>%	Players currently queued for a specific kit
%devoxy_infight_<kit>%	Players active in matches for a specific kit
%devoxy_inffa_<arena>%	Players inside a specific FFA arena
%devoxy_duels_wins%	Total duel wins for the player
%devoxy_duels_loses%	Total duel losses for the player

---

📜 Commands & Permissions Reference

Command	Permission	Description
/devoxy reload	devoxy.admin	Reload all configuration files and menus
/devoxy setspawn	devoxy.admin	Set the global server spawn location
/queue	None	Open the matchmaking queue menu
/joinffa [arena]	None	Open the FFA menu or join an arena
/leaveffa	None	Exit the active FFA arena session
/kiteditor	None	Open the interactive kit editing menu
/duel <player>	devoxy.duel	Challenge another player to a duel
/dueltoggle	devoxy.duel	Toggle incoming duel requests
/autoggtoggle	devoxy.autogg	Toggle automatic "gg" messages
/settings	None	Open player settings customization menu
/party	None	Manage party creation and settings

---

☍ Links & Community

• Gallery Showcase: Modrinth Gallery Page
• GitHub Repository: SwarajDev5/Devoxy
• Community Discord: Join the Discord Server
• Developer Profile: SwarajDev5