🗡️ Duels Plugin (FOR PAPER ONLY)

A complete and modern duels plugin for Paper servers.
Includes queues, kits, arenas, stats, and clean GUIs for competitive PvP.

✨ Features

• Player vs Player duels
• Queue system with kit selection
• Direct duel requests
• Kit system with previews
• Arena creation & management
• Player statistics (kills, deaths, wins, losses)
• Best-of duel system
• GUI-based menus
• Lobby utilities (fly, spawn, settings)
• Paper-optimized and lightweight

📦 Requirements

• Java 17+
• PaperMC 1.21+

🚀 Installation

1. Download the latest .jar from Releases
2. Put it into your server’s plugins/ folder
3. Start or restart the server
4. Configure the plugin files
5. Done ✨

⚙️ Configuration

• config.yml – main settings
• arenas.yml – arena definitions
• kits.yml – kit configuration
• players.yml – player stats & data

🧩 Commands

Player Commands

• /duel <player> - Challenge a player to a duel
• /accept - Accept a duel request
• /queue <join|leave|gui> - Queue for duels
• /kits - View available kits
• /previewkit <kit> - Preview a kit
• /stats [player] - View stats
• /ping [player] - Check ping
• /fly - Toggle lobby flight
• /spawn - Teleport to spawn
• /settings - Open settings menu

Admin Commands

• /duels - Main admin command
• /arena <subcommand> - Create & manage arenas
• /kit <add|remove> - Manage duel kits
• /setspawn - Set server spawn
• /setkills <player> <n> - Set player kills
• /setdeaths <player> <n> - Set player deaths
• /setwins <player> <n> - Set player wins
• /setlosses <player> <n> - Set player losses

🔐 Permissions

• duels.* - Access to all duels permissions
• duels.admin - Admin commands
• duels.fly - Allow flight in lobby
• duels.reload - Reload plugin configuration
• duels.setspawn - Set spawn location

🛠️ Development

• Built with Gradle
• Designed for Paper
• Modular manager-based architecture
• Easy to extend and maintain

📄 Plugin Info

• Name: Duels
• Version: 1.0
• Author: Ryhox
• API Version: 1.21

📄 License

This project is open for personal and private server use, learning, and modification.

You may

• Use this plugin on your own servers
• Modify the source code for personal or educational purposes
• Learn from and build upon the code

You may not

• Sell this plugin or any modified versions
• Claim this project as your own work
• Redistribute the plugin or its source code without proper credit
• Publish modified versions without clearly crediting the original author

If you share this project or any derivative work, clear attribution to the original author is required.

Made with ♡ by Ryhox and Nexor