---

🎯 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 [Accept] and [Deny] 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>	Spectate an active match
/spawn	Return to lobby spawn

Admin Commands (/ad or /adminduel)

Command	Description
/ad wand	Get selection wand
/ad create arena <name>	Create new arena from selection
/ad create kit <name>	Create new kit entry
/ad arena <name> setspawn1	Set arena spawn point 1
/ad arena <name> setspawn2	Set arena spawn point 2
/ad kit save <name>	Save current inventory as kit
/ad kit bind <kit> <arena>	Bind kit to arena
/ad kit icon <name>	Set kit icon from main hand
/ad setspawn	Set global lobby spawn
/ad list arenas	List all arenas and their status
/ad list kits	List all kits
/ad delete arena <name>	Delete an arena
/ad delete kit <name>	Delete a kit
/ad reload	Reload config and data

---

🔑 Permissions

Permission	Description	Default
asduels.use	Access all player commands	true
asduels.admin	Access all admin commands	op

---

🖥️ Compatibility

Server Software	Paper 1.21.4, Spigot 1.21.4
Java Version	Java 21 or higher
Dependencies	None — completely standalone
Database	None — flat file YAML storage

---

📁 Plugin Files

plugins/AsDuels/
├── config.yml    ← All settings, GUI config & 25+ messages
├── arenas.yml    ← Arena regions, spawns, kit bindings (auto-managed)
└── kits.yml      ← Kit items in Base64 format (auto-managed)

---

👨‍💻 About the Developer

ItzAzeem.As is the founder of AsDevs — a Minecraft plugin development brand focused on creating unique, polished, and performance-first plugins for competitive servers.

🌐 Website	asdevs.netlify.app
💬 Discord	discord.gg/xRW5rdAvs5

---

🆘 Support & Bug Reports

Having issues? Need help with setup? Want to suggest a feature?

Join the AsDevs Discord server for fast, friendly support: 👉 discord.gg/xRW5rdAvs5

Please do not use Modrinth comments for bug reports — Discord is much faster and easier!

---

🗺️ Roadmap

Feature	Status
Core duel system	✅ Released
Kit GUI with live stats	✅ Released
Arena block protection + auto cleanup	✅ Released
Queue system	✅ Released
Spectator mode	✅ Released
Player stats (W/L/Streak)	🔜 v1.1.0
Queue timeout	🔜 v1.1.0
Win/Loss result titles	🔜 v1.1.0
ELO / Rating system	🔮 Future
Tournament system	🔮 Future

---