DonutSMP - DonutDuels icon

DonutSMP - DonutDuels -----

Mechanics




Version 1.3 - The Gameplay & Stability Update


This update brings a massive overhaul to the gameplay experience and server administration, introducing dynamic new features and crucial stability improvements.



Combat Logging & Fair Play


  • Combat Log Penalties: To ensure fair play, players who quit during an "Own Inventory" duel will now have their entire inventory dropped on the ground. Their character's inventory is cleared to prevent item duplication, and they receive a configurable temporary ban.

  • Countdown Protection: Quitting during the pre-duel countdown is now also treated as combat logging, preventing players from dodging a match. The remaining player is declared the winner, and the quitter is penalized.


Dynamic Arena Borders


  • Shrinking Borders: Bring a battle-royale feel to your duels! Arenas can now have a WorldBorder that shrinks after a configurable amount of time, forcing action and preventing camping.

  • Fully Configurable: You have full control. Set the initial static duration, the final size of the border (e.g., 5x5), the shrink duration, the damage multiplier, and a "damage buffer" distance for progressive damage.

  • Per-Arena Control: Easily enable or disable the border for specific arenas using the /dd arenaborder <on|off> <arena> command.


Enhanced Player Experience


  • Queue Music: Keep players engaged with configurable waiting music (e.g., C418 - Cat) while they are in a duel queue.

  • Winning Music: Celebrate victories with a configurable sound effect that plays for the winner at the end of a match.

  • Duel Toggle: Players can now use /dueltoggle to disable incoming duel requests, giving them more control over their gameplay.

  • Command Restrictions: Players in a queue or active duel are prevented from using conflicting commands (like /home or /spawn), ensuring they cannot accidentally bug out of a match. The only exception is /duel deny to safely leave a queue.


Server Automation & Customization


  • Automated Actions: Execute custom console commands at different stages of a duel: on-queue-join, on-match-found, and on-duel-end. Use placeholders like %player%, %winner%, and %loser% to create rewards, announcements, and more!

  • Queue Broadcasts: Announce to the entire server when a player joins a specific duel queue, configurable in config.yml.

  • Default "Own Inventory" Mode: Configure the server so the /duel command instantly queues players for an "Own Inventory" match, streamlining the process and bypassing the GUI.


Admin & Maintenance


  • Automatic Update Checker: Admins with permission will be automatically notified upon joining if a new version of the plugin is available on SpigotMC, complete with a clickable download link in chat.


Major Bug Fixes & Stability


  • Reliable Teleportation: The teleportation system at the end of duels has been completely overhauled to be robust and bypass conflicts with other plugins, ensuring players are never left stuck in an arena.

  • Guaranteed Item Drops: The "Own Inventory" death and quit mechanics have been rebuilt to be extremely reliable, ensuring items are always dropped correctly.
----------, Oct 9, 2025

Update: v1.2 - Admin & UI Update Type: Major Update

This update introduces powerful new administrative tools, enhances the user interface with live information, and includes critical bug fixes for server stability and arena protection.

Added:

  • Full Message Configuration (messages.yml): All user-facing messages have been moved to a new messages.yml file, allowing for complete translation and customization.

  • Live Player Counts in GUI: The kit selection menus now display live "In Queue" and "Fighting" counters for each game mode.
    [​IMG]
  • New Admin Commands:
    • /dd reload: Allows reloading all plugin configurations without a server restart.

    • /dd forcestop <player>: Allows admins to forcefully and safely end an ongoing duel.
      /dd deletearena ArenaName; Allows admins to delete an arena.
      /dd deletekit KitName; Allows admins to delete a kit.
      [​IMG]
Fixed:

  • Server Crash on Arena Cleanup: Fixed a critical Asynchronous Chunk getEntities call error that would crash the cleanup task. This also resolves the "No arenas are available" bug.

  • Explosion Containment: Fixed a bug that allowed explosions (TNT, Respawn Anchors, etc.) to damage blocks outside of the arena's boundaries.

  • External Block Interaction: Fixed a loophole that allowed players inside a duel to break or place blocks outside their arena.

  • "Plugin is Disabled" Error: Resolved the main startup failure by changing the plugin's core dependency model.
Changed:

  • Thread Safety & Performance: The entire arena cleanup process (clearEntities and regenerateArena) was re-written to be fully thread-safe, significantly improving server stability.

  • Dependency Model: The plugin now treats WorldEdit as a softdepend. This allows the server to start and the plugin to enable even if WorldEdit is missing, disabling only arena-specific features.

  • Message System: The entire plugin was refactored to use the new, centralized MessageManager for all player communication.
----------, Oct 5, 2025

Update: v1.2 - Admin & UI Update Type: Major Update

This update introduces powerful new administrative tools, enhances the user interface with live information, and includes critical bug fixes for server stability and arena protection.

Added:

  • Full Message Configuration (messages.yml): All user-facing messages have been moved to a new messages.yml file, allowing for complete translation and customization.

  • Live Player Counts in GUI: The kit selection menus now display live "In Queue" and "Fighting" counters for each game mode.
    image.png
  • New Admin Commands:
    • /dd reload: Allows reloading all plugin configurations without a server restart.

    • /dd forcestop <player>: Allows admins to forcefully and safely end an ongoing duel.
      /dd deletearena ArenaName; Allows admins to delete an arena.
      /dd deletekit KitName; Allows admins to delete a kit.
      ima3ge.png
Fixed:

  • Server Crash on Arena Cleanup: Fixed a critical Asynchronous Chunk getEntities call error that would crash the cleanup task. This also resolves the "No arenas are available" bug.

  • Explosion Containment: Fixed a bug that allowed explosions (TNT, Respawn Anchors, etc.) to damage blocks outside of the arena's boundaries.

  • External Block Interaction: Fixed a loophole that allowed players inside a duel to break or place blocks outside their arena.

  • "Plugin is Disabled" Error: Resolved the main startup failure by changing the plugin's core dependency model.
Changed:

  • Thread Safety & Performance: The entire arena cleanup process (clearEntities and regenerateArena) was re-written to be fully thread-safe, significantly improving server stability.

  • Dependency Model: The plugin now treats WorldEdit as a softdepend. This allows the server to start and the plugin to enable even if WorldEdit is missing, disabling only arena-specific features.

  • Message System: The entire plugin was refactored to use the new, centralized MessageManager for all player communication.
----------, Oct 5, 2025

Whats new:

Added Own inventory option and fixed some bugs
----------, Sep 30, 2025

Resource Information
Author:
----------
Total Downloads: 109
First Release: Sep 27, 2025
Last Update: Oct 9, 2025
Category: ---------------
All-Time Rating:
2 ratings
Find more info at discord.gg...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings