AsDuels

---

🎯 What is AsDuels?

1v1 duel plugin 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 [Deny] 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 live Queue count as icons - Each kit displays live Queue 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 actionbar timer — players are matched fairly - If an opponent is already waiting → actionbar timer - 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 multiple arenas simultaneously with the wand tool — no coordinates needed - multiple arenas simultaneously — 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 automatically removed — protected forever - ✅ Players automatically removed new blocks during a match freely - ✅ Players automatically removed 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 custom GUI icon without touching any config file - Saves your custom GUI icon: 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

- hex color support — 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

| | | |-|-| | Database | Paper 1.21.4, Spigot 1.21.4 | | Database | Java 21 or higher | | Database | 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

AsDevs 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: > 👉 Join the AsDevs Discord server for fast, friendly support:

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 |

---