THE PLUGIN MIGHT WORK ON 1.19 AND 1.20 BECAUSE THE PLUGIN NATIVE IS 1.19.4 AND I TESTED IT ON 1.21.4.

----------------------------------------------------------------------

You will need 2 plugins for this plugin to work:
https://modrinth.com/plugin/luckperms
https://modrinth.com/plugin/fastasyncworldedit

Note:FastAsyncWorldEdit is needed not WorldEdit


DonutDuels – The All-in-One 1v1 Duels System

Bring the ultimate competitive 1v1 experience to your server with DonutDuels. Forget laggy arenas, incomplete features, and complicated setups; DonutDuels is a complete, performance-optimized system designed to replicate the seamless and professional feel of top-tier PvP networks.The Plugin has auto regeneration arena integrated.

What makes DonutDuels different? It’s a ground-up solution built for server owners who refuse to compromise. It combines a smooth matchmaking queue (/duel) with a robust direct challenge system (/duel <player>), ensuring every player can fight how they want. Every feature, from the lag-free asynchronous arena regeneration to the detailed player stats, is built for performance and deep customization.

⚔️ Features

• Hybrid Dueling System: Players can choose their path to battle.
  • Matchmaking Queue (/duel): A GUI-based system where players select a kit and are automatically matched against an opponent.
    
    
  • Direct Challenges (/duel <player>): A complete player-to-player challenge flow with kit selection and interactive accept/deny messages.
• Advanced Arena Management:
  • Instant Arena Creation (/dd createarena): Create flawless arenas in seconds from any WorldEdit selection. The plugin saves both the block schematic and the precise region boundaries.
    
    
  • Truly Lag-Free Regeneration: Arenas are regenerated asynchronously after every duel, causing zero server lag. (Requires FAWE for best results).
    
    
  • Automatic Cleanup: All dropped items, projectiles, and entities like End Crystals are automatically cleared after each match, leaving the arena perfectly clean.
• Fully Customizable Kits:
  • In-Game Kit Editor (/dd createkit): Admins can create unlimited kits on the fly by setting up an inventory and running a single command.
    
    
  • Per-Kit Game Rules: Use the kits.yml config to enable building and breaking for specific kits (like BuildUHC) while keeping it disabled for others.
• Complete Spectator Mode (/spectate <player>):
  • Allow your community to watch ongoing duels in a seamless spectator mode. Spectators are automatically returned to their original location when the duel ends.
• Built-in Stats & Leaderboards:
  • Detailed Player Statistics (/duel stats): Automatically tracks wins, losses, kills, deaths, K/D, and W/L ratios.
    
    
  • Top 10 Leaderboard (/duel top): Fuel competition by displaying the best duelists on your server.
• Professional Match Experience:
  • Duel Countdown: Every match starts with a configurable countdown with titles and sounds, freezing players in place for a fair start.
    
    
  • Total Arena Protection: An "invisible wall" prevents players from walking or ender-pearling out of bounds, and all non-essential commands are blocked during a fight.
    
    
  • Custom Death Messages: A clean, custom broadcast message announces the winner and loser of every duel.

⚡ Built for Performance

DonutDuels is designed to run on servers of any size without causing lag. The most resource-intensive tasks—clearing entities and regenerating arenas—are handled asynchronously. By offloading this work to a separate thread, the main server thread remains free to handle player movement and interactions, guaranteeing a smooth TPS and a superior gameplay experience. For this reason, FastAsyncWorldEdit (FAWE) is highly recommended over standard WorldEdit.

Commands & Permissions

• donutduels.admin - Grants access to all /dd commands. default: op.
  
  
• donutduels.duelusecmd - Allows a player to use commands during a duel. default: false.

Player Commands (/duel, /spectate)

• /duel – Opens the kit selection GUI to join the queue.
  
  
• /duel <player> – Opens the kit GUI to send a direct challenge.
  
  
• /duel accept <player> – Accepts a duel request.
  
  
• /duel deny <player> – Denies a duel request.
  
  
• /duel leave – Leaves the matchmaking queue.
  
  
• /duel stats [player] – Shows your stats or another player's stats.
  
  
• /duel top – Displays the top 10 players.
  
  
• /spectate <player> – Spectate an ongoing duel.
  
  
• /spectate leave – Exit spectator mode.

Admin Commands (/dd)

• /dd help – Displays all admin commands.
  
  
• /dd setspawn – Sets the global post-duel spawn location.
  
  
• /dd createkit <name> – Creates a kit from your inventory.
  
  
• /dd createarena <name> – Creates an arena from your WorldEdit selection.
  
  
• /dd setspawn1 <arena_name> – Sets the first spawn point.
  
  
• /dd setspawn2 <arena_name> – Sets the second spawn point.