AsDuels

<div align="center"> # ⚔️ AsDuels ### The Ultimate 1v1 Duel Plugin for Competitive Servers **by ItzAzeem | AsDevelopment** (https://img.shields.io/badge/Discord-Join%20Support-5865F2?style=for-the-badge&logo=discord)](https://discord.gg/xRW5rdAvs5) (https://img.shields.io/badge/Website-asdevs.netlify.app-FF6B35?style=for-the-badge)](https://asdevs.netlify.app/) (https://img.shields.io/badge/Minecraft-1.21+-62B547?style=for-the-badge)](https://modrinth.com) (https://img.shields.io/badge/Java-21+-ED8B00?style=for-the-badge&logo=java)](https://modrinth.com) --- *Challenge. Queue. Fight. Repeat.* </div> --- ## 🎯 What is AsDuels? **AsDuels** is a high-performance, feature-packed **1v1 duel plugin** designed for competitive PvP and FFA servers. Players challenge each other, pick their kit from a beautiful live-updated GUI, and battle it out in custom-built arenas — all working out of the box with zero external dependencies. Admins set up everything **100% in-game** — no YAML editing, no restarts, no headaches. > No lag. No nonsense. Just pure competitive dueling. --- ## ✨ Feature Breakdown ### ⚔️ Duel System - Challenge any player with `/duel <player>` or open the queue GUI with `/duel` - Clickable **** and **** buttons directly in chat - Duel requests auto-expire after a configurable timeout - Prevents self-dueling, dueling players already in matches, and dueling while in queue ### 🎮 Kit Selection GUI - Beautiful chest GUI showing **all available kits** as icons - Each kit displays **live Fighting count** and **live Queue count** - GUI auto-refreshes when any player joins or leaves a queue or match - Click any kit icon to instantly join that kit's queue or send a challenge with it ### 📊 Queue System - Separate matchmaking queue **per kit** — players are matched fairly - If an opponent is already waiting → **instant match start** - Live **actionbar timer** showing how long you've been queued - `/duel leave` to exit queue at any time - Players auto-removed from queue on disconnect ### 🏟️ Arena System - Create arenas **entirely in-game** with the wand tool — no coordinates needed - **Iron Hoe wand** — Left Click = Pos1, Right Click = Pos2 - Set two individual player spawns per arena - Run **multiple arenas simultaneously** — no bottleneck - System automatically assigns the best available arena on match start ### 🛡️ Smart Arena Protection This is where AsDuels stands out from other duel plugins: - ❌ Original arena blocks **can never be broken** — protected forever - ✅ Players **can place** new blocks during a match freely - ✅ Players **can break** blocks they personally placed during the match - 🧹 All player-placed blocks are **automatically removed** when the match ends - Arena resets itself perfectly after every single match — no manual cleanup needed! ### 🎒 Kit System - Create kits **in-game** without touching any config file - Saves your **complete inventory**: 36 main slots + armor slots + offhand slot - Set a **custom GUI icon** per kit so players instantly recognize it - Bind any kit to any arena — kit is automatically given when match starts - Kit is automatically removed and inventory restored when match ends ### 👁️ Spectator Mode - `/duel spectate <arena>` — watch any live match in real time - Full vanilla spectator gamemode — fly freely around the arena - Cannot interact with or damage players - Automatically teleported back to lobby when the match ends - Can leave early using `/spawn` ### ⚙️ Deep Configuration - **25+ configurable messages** — every single player-facing string - Full **hex color support** `&#RRGGBB` in all messages and titles - Configurable GUI title, row count, and filler material - Toggle hunger, fall damage, and natural mob damage per match - Configurable countdown duration and request timeout --- ## 🏟️ Arena Setup — Step by Step ``` 1. /ad wand → Get the Iron Hoe wand 2. Left click a block → Set Pos1 (corner 1) 3. Right click a block → Set Pos2 (corner 2) 4. /ad create arena <name> → Arena created! 5. Stand on spawn point 1 6. /ad arena <name> setspawn1 → Spawn 1 saved 7. Stand on spawn point 2 8. /ad arena <name> setspawn2 → Spawn 2 saved — Arena READY! 9. Fill your inventory with items 10. /ad kit save <name> → Kit saved! 11. Hold the icon item in hand 12. /ad kit icon <name> → Icon set! 13. /ad kit bind <kit> <arena> → Kit bound to arena! ``` **Done! Your arena is fully ready for matches.** --- ## 📜 Commands ### Player Commands | Command | Description | |---------|-------------| | `/duel` | Open kit queue GUI | | `/duel <player>` | Challenge a specific player | | `/duel accept` | Accept incoming duel request | | `/duel deny` | Deny incoming duel request | | `/duel cancel` | Cancel your outgoing request | | `/duel leave` | Leave the matchmaking queue | | `/duel spectate <arena>` | Specta