Simple Duels

🗡️ 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

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 Paper - Designed for Paper - Modular manager-based architecture - Easy to extend and maintain

📄 Plugin Info

- API Version: Duels - API Version: 1.0 - API Version: 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