Here is the complete description for DonutDuels, reformatted to remove all tables and display the commands and permissions in a clear, listed format.



DonutDuels


The Ultimate Hardcore Dueling Solution Inspired by DonutSMP | Risk Fights | Automated Arenas





Description


DonutDuels is a feature-rich dueling plugin designed for servers that want high-stakes combat. Whether you want Fair Kit Battles or high-risk Own Inventory fights (where players lose their items on death), this plugin handles it all.

It features a robust Arena Management System that uses WorldEdit schematics to physically regenerate arenas after every match, ensuring a fresh battlefield every time.



✨ Key Features

• ⚔️ Two Combat Modes:
  
  • Kit Duels: Players fight with saved loadouts. Inventory is restored after the fight.
    
    
  • Risk Inventory (Own Inv): Players fight with their current items. If they die, they drop their loot!
    
• ️ Smart Arenas:
  
  • Auto-Regeneration: Arenas reset automatically using schematics (requires WorldEdit/FAWE).
    
    
  • World Borders: Borders shrink over time to force engagement.
    
    
  • Flat-File Storage: Each arena is saved in its own .yml file in the Arenas/ folder for safety.
    
• Combat Log Protection:
  
  • Quitting mid-duel results in an automatic loss.
    
    
  • In Risk Mode, the quitter's items are dropped on the ground.
    
    
  • In Kit Mode, the player's inventory is restored when they rejoin.
    
    
  • Supports auto-banning quitters via AdvancedBan or LiteBans.
    
• Stats & Ranking: Tracks Kills, Deaths, Wins, Losses, KDR, and WLR. Includes a /duel top leaderboard.
  
  
• ️ Interactive GUIs: Modern menus for Queues, Kit Selection, Duel Requests, and viewing incoming challenges.
  
  
• Customization: Fully configurable messages, sounds, timings, and block interaction rules (whitelist/blacklist).
  

Commands




Player Commands


These commands are available to all players by default.

• /duel Opens the Queue menu or the Own Inventory confirmation menu.
  
  
• /duel <player> Opens the Challenge menu to customize Kit, Arena, and Time settings against a specific player.
  
  
• /duel accept <player> Accepts a pending duel request from the specified player.
  
  
• /duel deny [player] Denies a request or leaves the queue.
  
  
• /duel stats [player] View your own or another player's combat statistics.
  
  
• /duel top Displays the Top 10 players by wins.
  
  
• /duel viewrequest <player> Opens a GUI to inspect the details (Kit, Map, Settings) of an incoming request.
  
  
• /spectate <player> Teleports you to spectate a live duel.
  
  
• /spectate leave Exits spectator mode and returns you to spawn.
  
  
• /dueltoggle Toggles whether you can receive duel requests from others.
  

️ Admin Commands


Requires permission: donutduels.admin

General Management

• /dd help Displays the admin help menu.
  
  
• /dd reload Reloads config.yml, messages.yml, kits.yml, and internal caches.
  
  
• /dd status Runs a diagnostic report on arenas, files, and spawn points.
  
  
• /dd setspawn Sets the global lobby spawn (where players go after a match).
  
  
• /dd forcestop <player> Forcefully ends a duel involving the specified player.
  

Kit Management

• /dd createkit <name> Creates a new kit using your current inventory and armor.
  
  
• /dd deletekit <name> Permanently deletes a kit.
  
  
• /dd renamekit <old_name> <new_name> Renames an existing kit.
  
  
• /dd kiticon set <kit> Sets the GUI icon of a kit to the item currently held in your hand.
  
  
• /dd kiticon remove <kit> Resets the kit icon to the default sword.
  

Arena Management

• /dd createarena <name> Creates a new arena from your current WorldEdit selection.
  
  
• /dd deletearena <name> Deletes an arena configuration and its schematic file.
  
  
• /dd setspawn1 <arena> Sets the start position for Player 1.
  
  
• /dd setspawn2 <arena> Sets the start position for Player 2.
  
  
• /dd arenaborder <on|off> <arena> Toggles the World Border feature for a specific arena.
  
  
• /dd arenaregen <on|off> <arena> Toggles block regeneration for a specific arena.
  

Permissions

• donutduels.admin
  
  • Description: Grants full access to all /dd admin commands.
    
    
  • Default: OP.
    
• donutduels.cmd.bypass
  
  • Description: Allows a player to use blocked commands (e.g., /spawn, /warp) while inside an active duel.
    
    
  • Default: OP.
    

⚙️ Installation

1. Download DonutDuels.jar and drop it into your plugins folder.
   
   
2. Dependencies (Highly Recommended):
   
   • FastAsyncWorldEdit (FAWE): Required for arena creation and automatic regeneration.
     
     
   • AdvancedBan or LiteBans: Required if you want to ban players who combat log.
     
3. Restart your server.
   
   
4. Set the main spawn using /dd setspawn.
   
   
5. Create arenas using WorldEdit selections and /dd createarena.
   
   
6. Create kits using /dd createkit.