🗡️ Duels Plugin

_{by Ryhox and Nexor}

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

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

⚙️ Configuration

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

🧩 Commands

Player Commands

/duel - Challenge a player to a duel
/accept - Accept a duel request
/queue <join|leave|gui> - Queue for duels
/kits - View available kits
/previewkit - 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 - Create & manage arenas
/kit <add|remove> - Manage duel kits
/setspawn - Set server spawn
/setkills - Set player kills
/setdeaths - Set player deaths
/setwins - Set player wins
/setlosses - 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

Simple Duels