DonutDuels - [BETA] v1.0

[size=2][font="Droid Sans", Arial, sans-serif][size=5][size=5][b]DonutDuels[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][i]ᴀ ᴄᴏᴍᴘʀᴇʜᴇɴsɪᴠᴇ ᴅᴜᴇʟɪɴɢ ᴘʟᴜɢɪɴ ꜰᴏʀ ᴍɪɴᴇᴄʀᴀꜰᴛ[/i][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Version:[/b] 1.0.0 | [b]Author:[/b] GamingHuzai[/font][/size]

[center][size=2][font="Droid Sans", Arial, sans-serif][ATTACH=full]926657[/ATTACH][/font][/size][/center]

[center][size=2][font="Droid Sans", Arial, sans-serif][ATTACH=full]926658[/ATTACH][/font][/size][/center]

[center][size=2][font="Droid Sans", Arial, sans-serif][ATTACH=full]926659[/ATTACH][/font][/size][/center]

[center][size=2][font="Droid Sans", Arial, sans-serif][ATTACH=full]926660[/ATTACH][/font][/size][/center]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]✨ Features[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]⚔️ Dueling System[/b] - Challenge players to intense 1v1 battles with customizable arenas and time limits[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Statistics & Leaderboards[/b] - Track wins, losses, K/D ratios, and win streaks with persistent player data[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Arena Management[/b] - Create unlimited arenas with automatic regeneration and spawn point configuration[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Queue System[/b] - Join casual matchmaking queues for automatic opponent pairing[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Spectator Mode[/b] - Watch ongoing duels from any player's perspective[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]⚙️ Dual Storage[/b] - Choose between lightweight YAML or robust SQLite database storage[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]License System[/b] - Automatic IP-based license key generation for server security[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Interactive Menus[/b] - Beautiful GUI menus for queue management and duel requests[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Commands[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=3][size=3][b]Player Commands[/b][/size][/size][/font][/size]

[table][tr][th][size=2][font="Droid Sans", Arial, sans-serif]Command[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Description[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Permission[/font][/size][/th]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel player;[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Challenge a player to a duel[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel accept <player>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Accept a duel request[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel decline <player>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Decline a duel request[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel toggle[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Toggle duel requests on/off[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel stats [player][/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]View duel statistics[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel top[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Show top 10 leaderboard[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel queue[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Join/leave casual queue[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/duel draw[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Request or accept a draw[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/spec <player>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Spectate a player's duel[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.spectate[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/spec leave[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Stop spectating[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.spectate[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/queue [join|leave][/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Manage queue status[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/leave[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Exit match during loot phase[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[/tr]

[/table]

[size=2][font="Droid Sans", Arial, sans-serif][size=3][size=3][b]Admin Commands[/b][/size][/size][/font][/size]

[table][tr][th][size=2][font="Droid Sans", Arial, sans-serif]Command[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Description[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Permission[/font][/size][/th]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd help[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Show all admin commands[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd reload[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Reload plugin configuration[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd wand[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Get arena selection wand[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd setspawn[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Set global spawn location[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd createarena <name>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Create new arena[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd setspawn <arena> 1|2[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Set arena spawn points[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd delete arena <name>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Delete an arena[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd arenaregen on|off[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Toggle arena regeneration[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]/dd forcestop <player>[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Force-stop a player's duel[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[/tr]

[/table]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Permissions[/b][/size][/size][/font][/size]

[table][tr][th][size=2][font="Droid Sans", Arial, sans-serif]Permission[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Description[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Default[/font][/size][/th]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.admin[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Access to all admin commands[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]op[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.duel[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Use duel commands[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]true[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]donutduels.spectate[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Spectate duels[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]true[/font][/size][/td]

[/tr]

[/table]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Requirements[/b][/size][/size][/font][/size]

[ul]

[li][size=2][font="Droid Sans", Arial, sans-serif]Minecraft Version: 1.16.5 or higher (Spigot/Paper)[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Java Version: Java 8 or higher[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Dependencies: None required (SQLite JDBC optional for database mode)[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Build System: Maven[/font][/size][/li]

[/ul]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Configuration[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=3][size=3][b]config.yml Example[/b][/size][/size][/font][/size]

[code=yaml][/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]SETTINGS:[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  LOOT-TIME: 60 # In seconds[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  MATCH-TIME: 15 # In minutes[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  REGION: "NA East" # Server region name[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  MAX-MATCH-TIME: 15 # Maximum selectable match time[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif][/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]PROTECTED-BLOCKS:[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  - "SHORT_GRASS"[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  - "STONE_BRICKS"[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  - "IRON_BLOCK"[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif][/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]MESSAGES:[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  JOINED-QUEUE: "&7You joined the casual queue."[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  MATCH_WINNER_MESSAGE: "&eYou have won the duel!"[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]  DUEL_REQUEST_SENT: "&aDuel request sent to %target%!"[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif][/code]

[size=2][font="Droid Sans", Arial, sans-serif][size=3][size=3][b]database.yml Example[/b][/size][/size][/font][/size]

[code=yaml][/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]TYPE: "YAML" # Options: YAML or SQLITE[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif][/code]

[size=2][font="Droid Sans", Arial, sans-serif][b]YAML Mode:[/b] Lightweight, human-readable, no dependencies[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]SQLite Mode:[/b] For larger servers (requires sqlite-jdbc driver)[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Installation[/b][/size][/size][/font][/size]

[ul]

[li][size=2][font="Droid Sans", Arial, sans-serif]Download DonutDuels-1.0.0.jar from the target/ directory[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Place in your server's plugins/ folder[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Restart your server[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]License key will be automatically generated[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Configure files in plugins/DonutDuels/[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Use /dd wand to create arenas[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Set spawn points with /dd setspawn <arena> 1|2[/font][/size][/li]

[/ul]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Building from Source[/b][/size][/size][/font][/size]

[code={defaultattr}][/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif]mvn clean package[/font][/size][/color]

[color=#2c2c2c][size=2][font="Droid Sans", Arial, sans-serif][/code]

[size=2][font="Droid Sans", Arial, sans-serif]The compiled JAR will be in target/DonutDuels-1.0.0.jar[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Configuration Files[/b][/size][/size][/font][/size]

[table][tr][th][size=2][font="Droid Sans", Arial, sans-serif]File[/font][/size][/th]

[th][size=2][font="Droid Sans", Arial, sans-serif]Purpose[/font][/size][/th]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]config.yml[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Match settings, messages, sounds, protected blocks[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]menus.yml[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]GUI menu configurations and items[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]database.yml[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Storage type selection (YAML/SQLite)[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]arenas.yml[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Auto-generated arena data and spawn points[/font][/size][/td]

[/tr]

[tr][td][size=2][font="Droid Sans", Arial, sans-serif]license.yml[/font][/size][/td]

[td][size=2][font="Droid Sans", Arial, sans-serif]Auto-generated license key storage[/font][/size][/td]

[/tr]

[/table]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Statistics Tracked[/b][/size][/size][/font][/size]

[ul]

[li][size=2][font="Droid Sans", Arial, sans-serif]Wins & Losses[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Draw matches[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Win Rate percentage[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Current win streak[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Best win streak[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Total kills & deaths[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]K/D ratio[/font][/size][/li]

[li][size=2][font="Droid Sans", Arial, sans-serif]Top 10 leaderboard rankings[/font][/size][/li]

[/ul]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Customization[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Messages:[/b] All plugin messages support Minecraft color codes using & symbol[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif]Example: &aGreen text &cRed text &eYellow text[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Sounds:[/b] Fully customizable sound effects for queue, duel start, and victory[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Menus:[/b] Complete GUI customization through menus.yml[/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][size=4][size=4][b]Support[/b][/size][/size][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][i]Made with ❤️ by GamingHuzai[/i][/font][/size]

[size=2][font="Droid Sans", Arial, sans-serif][b]Enjoy DonutDuels![/b][/font][/size]