King of the Ladder | [1.21.11 - 26.3]

What's Changed · Prevented players from joining another arena from a stale location during arena transitions. · Respected combat cancellations made by other plugins inside KOTL arenas. · Guarded arena lookups when a player user is unavailable during lifecycle handling. · Bump org.projectlombok:lombok from 1.18.46 to 1.18.48 by @dependabot in #33 Full Changelog: 3.2.5...3.2.6

What's Changed · Added arena-only reward broadcasts with the broadcast: action. · Added server-wide component broadcasts through broadcast_server:, preserving placeholders, hex colors, and MiniMessage formatting. · Expanded rewards.yml examples and documentation for configurable reward broadcasts. · Updated the Gradle version badge. · Bump gradle-wrapper from 9.7.0 to 9.7.1 by @dependabot in #32 Full Changelog: 3.2.4...3.2.5

What's Changed · Added configurable reward commands for arena joins, arena quits, king claims, player kills, and player deaths. · Added placeholders for player, arena, king, combat, and statistics data, with console and player command execution support. · Added reward configuration reload support to /kotl reload. · Updated project documentation and the GitHub Actions build workflow. · Bump gradle-wrapper from 9.6.1 to 9.7.0 by @dependabot in #31 Full Changelog: 3.2.3...3.2.4

What's Changed · Fixed Game Area boundary detection so every block in the selected region is included. · Improved compatibility with other plugins by respecting cancelled item and arrow pickup events. · Improved internal game flow formatting and consistency. · Changed Dependabot update checks from weekly to daily. · Improved the pull request template. · Bump actions/setup-java from 5.6.0 to 5.7.0 by @dependabot in #30 Full Changelog: 3.2.2...3.2.3

What's Changed · Fixed /kotl help failing when executed from the console. · Restricted arena creation commands to player senders to prevent console errors. · Added safe arena ID validation for YAML persistence. · Arena IDs must contain 1 to 64 characters. · Spaces and periods are no longer accepted. · Arena lookup and duplicate detection are now case-insensitive. · Fixed arena changes not being persisted during automatic saves. · Improved player inventory protection and recovery. · Players are no longer added to an arena if their inventory cannot be backed up. · Inventory snapshots now survive disconnects and server restarts. · Saved inventories are restored only once after a successful recovery. · Fixed original potion effects being removed after restoring player data. · Arenas with missing or invalid saved locations are now automatically marked as not ready. · Bump actions/setup-java from 5 to 5.6.0 by @dependabot[bot] in #29 Full Changelog: 3.2.1...3.2.2

After more than seven months, King of the Ladder is finally back with its biggest update yet. KOTL has been completely rewritten from scratch with cleaner architecture, improved performance, modern systems, and a stronger foundation for future updates. What's New · Completely rewritten arena and game lifecycle systems. · Redesigned in-game arena setup menu. · Improved Game Area selection, validation, and particle visualization. · More reliable king detection, cooldowns, and celebration effects. · Reworked player statistics, arena records, and leaderboards. · Added flat-file storage with optional MySQL support. · Improved automatic saving and shutdown handling. · Expanded PlaceholderAPI support. · Improved arena chat, combat, item drop, and pickup isolation. · Added arena enable and disable controls. · Added support for popular world-management plugins. · Introduced a public API with cancellable gameplay and statistic events. · Published updated documentation and Javadocs. · Modernized the project for Java 25. Important Update Notice Because the plugin has been completely rewritten, existing configuration files may not be fully compatible with this release. Before updating: · Back up your current KOTL folder. · Let the plugin generate fresh configuration files. · Review and manually transfer your existing settings. · Test every arena before opening it to players. Requirements · Java 25 · A Paper-compatible Minecraft server View the full release notes on GitHub

Release Notes · Updated Command Framework to v1.5.7. · General performance improvements. · Excluded some of the unnecessary folders from the plugin JAR. · Fixed the wrong relocation patterns and paths. Full Changelog: 3.1.9...3.2.0

· Added support for Minecraft 1.21.11. · Updated FileItems and InventoryFramework libraries. · Fixed user data not loaded on join. · Deleted libs.versions.toml file. Full Changelog: 3.1.8...3.1.9

What's Changed · Migrated to Gradle. · Added FileItems library to the project. · Moved to a new namespace: dev.despical (Developer alert). We have renamed our packages. · Fixed a potential memory leak and other bugs about the cuboid selector. · Removed the 2nd arena scheduler option. · Some changes in the config.yml and mysql.yml files. · Improvements on the command system, tab completers, arena registry and other systems. · Bug Fix: SQL Syntax Error in saveStatistics by @heyxmirko in #24 New Contributors · @heyxmirko made their first contribution in #24 Full Changelog: 3.1.7...3.1.8

· Support for Minecraft 1.21.5+

· Updated Inventory Framework library. · Updated Maven Jar plugin. Full Changelog: 3.1.5...3.1.6

· Added jitpack.yml and LICENSE_HEADER.txt files. · Now kit armors support enchantments. · Improvements on the MySQL database. · Renamed MysqlManager class to MySQLDatabase. · Moved StatisticType class to a different class. · Updated Commons and Inventory Framework libraries. · Fixed wrong GitHub actions Java version. Full Changelog: 3.1.4...3.1.5

· Support for Minecraft 1.21.5. Now the plugin requires at least Java 21 to run properly.

· Removed ActionBar class, now using it from the Commons library. · Updated Commons library. · Removed PlayerKickEvent handling. · Code based small changes. Full Changelog: 3.1.2...3.1.3

· Updated Commons library. Full Changelog: 3.1.1...3.1.2

· Support for Hex/RGB in the scoreboard. · Lots of code changes/improvements. · Lots of code refactoring and cleaning. · Updated .editorconfig file. · Updated license headers. · Fixed a small bug in the arena editor menu. · Fixed broken language files. Full Changelog: 3.1.0...3.1.1

· Added support for Minecraft 1.21.4. · Added fallback prefix to commands ("kingoftheladder:kotl"). · Fixed some of the statistics not existing in the MySQL table. · Lots of code based improvements and changes. · Updated Commons, Command Framework and Inventory Framework libraries. What's Changed · Fixed MySQL initialization by @WaterArchery in #23 New Contributors · @WaterArchery made their first contribution in #23 Full Changelog: 3.0.9...3.1.0

· Fixed a bug about players that quit while in-game.

· Fixed when players quit the game their inventory is not restored properly. · Fixed when players quit and rejoin they are still in the game. · Fixed arena setup bugs. · Fixed some of the item tooltips not hidden in higher versions of the game. · Better KOTL API event calls, fixed potential issues. · Updated Commons library. Full Changelog: 3.0.7...3.0.8

· Added option to set the amount of kit items. · slot:item:amount · Now hiding the tooltip of kit items. · Updated Command Framework to v1.5.12. Full Changelog: 3.0.6...3.0.7

· Support for Minecraft 1.21.2 & 1.21.3. · Updated Commons, Command Framework, Inventory Framework and bStats libraries. · Improvements on the database and user systems. Full Changelog: 3.0.5...3.0.6

· Updated Command Framework to v1.5.0. · Improvements on the commands. · Fixed help command does not have a description. Full Changelog: 3.0.4...3.0.5

· Updated help command messages. ​

· Fixed command matcher not working. Full Changelog: 3.0.2...3.0.3

· Support for Minecraft 1.21.1. · Updated Command Framework to v1.4.9. · Code based improvements. Full Changelog: 3.0.1...3.0.2

· Added 2 new stats: KILLS and DEATHS. · Added 2 new rewards for killing players and for death. · Now kit items will be unbreakable in MC 1.8.9 and lower. · Fixed command matcher system does not work properly in some cases. · Updated Commons to the latest available version. · Code based performance improvements. Changes in messages.yml Code (YAML): Commands: Stats-Command: Header : "&l[-----YOUR STATS-----]" Header-Other : "&l[-----STATS FOR %player%-----]" Messages : - "%header%" - "&8 * &fScore &a%score%" - "&8 * &fTours Played &a%tours_played%" - "&8 * &fKills &a%kills%" - "&8 * &fDeaths &a%deaths%" - "&l[--------------------]" Changes in rewards.yml Code (YAML): Rewards : # This reward will be executed when player gets a kill. Kill : [ ] # This reward will be executed if player dies. Death : [ ] Full Changelog: 3.0.0...3.0.1

· Added option to allow players to pick up items in-game. · Updated Commons to latest. · Support for new added items in Minecraft 1.20+. · Support for new added sounds in Minecraft 1.17+. · Improvements on arena setup menu. Changes in config.yml Code (YAML): # Should players can be able to pick up items in-game? Pick-Up-Items : false Full Changelog: 2.9.9...3.0.0

· Support for new added items in MC 1.20 & 1.21. · Removed confirmation from delete command. Full Changelog: 2.9.8...2.9.9

· Added support for Minecraft 1.21.

· Updated libraries: · Commons · InventoryFramework · CommandFramework · PlaceholderAPI Full Changelog: 2.9.6...2.9.7

Discord: mrdespical 2.9.5 · Added option to separate cooldowns based on different arenas. · Now cooldowns won't reset if players leave the server. Config Changes Code (YAML): King-Settings : # Should players have different cooldowns for each arena they join? Separate-Cooldowns : true Full Changelog: 2.9.4...2.9.5

Discord: mrdespical 2.9.6 · Fixed some bugs related to cooldown system. Full Changelog: 2.9.5...2.9.6

Discord: mrdespical 2.9.4 · Support for Minecraft 1.20.5. Full Changelog: 2.9.3...2.9.4

Discord: mrdespical 2.9.3 · Added option to count the cooldown outside the game, in case the cooldown bar option is enabled. · Fixed hunger not updating if "hunger" is added to unrestorable elements list in config. · Fixed "Cooldown-Bar" option can not be disabled due to option path is incorrect in the code. Config Changes Code (YAML): King-Settings : # Should we count the cooldown if player is not in an arena and the option above is true? Count-Cooldown-Bar-Outside : false Full Changelog: 2.9.2...2.9.3

Discord: mrdespical 2.9.2 · Added 2 new options for king cooldowns. · Fixed some options' paths are wrong. · Fixed some bugs related to king cooldown. Config Changes Code (YAML): King-Settings : # Should we allow players to become king in a row? Become-King-In-A-Row : false # Should we prevent players to become king again without a delay? Cooldown : 5 # The permission to override king cooldown. Cooldown-Override-Perm : "" # Should we apply an action bar message that displays current cooldown of player? Cooldown-Bar : true # Should we apply the cooldown to the king when there is only one player in the arena? Cooldown-When-Alone : false # Should we show the cooldown bar if player has cooldown and rejoins the arena again? Show-Cooldown-If-Rejoin : true # Should we reset players' cooldown, other than new king, when someone becomes king? Reset-Cooldowns-On-New-King : true Remove-Cooldown-On : # Should we remove player's becoming king cooldown when they join an arena, if they have? Join : false # Should we remove player's becoming king cooldown when they leave an arena, if they have? Leave : false Full Changelog: 2.9.1...2.9.2

Discord: mrdespical 2.9.0 · Added new options to customize king settings. · Fixed fireworks damage players if they explode in a block. · Fixed some of the config options not updating properly. · Fixed rewards throw exception in some cases. · Fixed arena plate menu not centered in MC 1.20+. · Now reward executions are going to be in the main thread, in case async option is enabled. · Now async option is disabled by default. Config Changes Code (YAML): King-Settings : # Should we allow players to become king in a row? Become-King-In-A-Row : false # Should we prevent players to become king again without a delay? Cooldown : 5 # The permission to override king cooldown. Cooldown-Override-Perm : "" # Should we apply an action bar message that displays current cooldown of player? Cooldown-Bar : true # Should we apply the cooldown to the king when there is only one player in the arena? Cooldown-When-Alone : false Remove-Cooldown-On : # Should we remove player's becoming king cooldown when they join an arena, if they have? Join : false # Should we remove player's becoming king cooldown when they leave an arena, if they have? Leave : false Message File Changes Code (YAML): In-Game: Cooldown-Format : "&6COOLDOWN &8&l[%progress%&8&l] &6%time%s" Special thanks to @homerek111 for their contributions. Full Changelog: 2.9.0...2.9.1

Discord: mrdespical 2.9.0 · Added an option to change player's game mode to a custom game mode other than survival, when they enter an arena. · Added new attributes to not restore for inventory manager. · Fixed multiple instances breaks the plugin. Resolved #18 and #19 Config File Changes Code (YAML): Inventory-Manager: Enabled : true # Usable attributes: # game-mode, hunger, exp, level # health, max-health, health-scale # saturation, allow flight, fire-ticks Do-Not-Restore : - "max-health" - "health-scale" # Which game mode should we set for players when they enter the arena? Game-Mode : SURVIVAL Full Changelog: 2.8.9...2.9.0

Discord: mrdespical 2.8.9 · Now empty messages won't be broadcasted to in-game players such as kill messages in case they are empty (not blank messages will still be sent as an empty message). · Updated CommandFramework, ParticleLib and Commons libraries. Full Changelog: 2.8.8...2.8.9

Discord: mrdespical 2.8.8 · Fixed particle effects not working on Minecraft 1.20 and higher versions. Full Changelog: 2.8.7...2.8.8

Discord: mrdespical 2.8.7 · Fixed particle effects not working on Minecraft 1.20 and higher versions. Full Changelog: 2.8.6...2.8.7

Discord: mrdespical 2.8.6 · Fixed wrong calculation of reward delay. (Resolved #15) Full Changelog: 2.8.5...2.8.6 Special thanks to @capubara ​

· Updated CommandFramework. · Updated some content in config file. Full Changelog: 2.8.4...2.8.5

Discord: mrdespical 2.8.4 · Fixed arena plate menu is not filled properly in MC 1.13+. · Fixed some features of inventory saving/loading is not working properly if async is enabled. · Updated CommandFramework and fixed some of the command messages. · Decreased the delay before the menu closing, after clicking the close item in setup menu. · Other QoL improvements and changes. Full Changelog: 2.8.3...2.8.4

Discord: mrdespical 2.8.3 · Added missing pressure plates for Minecraft 1.8. · Fixed exception occurs while trying to open additional arena options menu in older versions of Minecraft. · Fixed glass names are showing the wrong menu's information in additional arena options menu. · Fixed arena plate names are not foramtted. · Fixed strange behaviour of plate menu. · Fixed shift click bugs for all menus. · Fixed help command not working in legacy versions. · Fixed kits not loading in legacy versions. · New command matcher system. · Improvements on the tab completer system. · Now older arena plate will be destroyed if it is present when new one is set. · Now arena plates will be placed under player's current location. · General Quality of Life improvements and some additional changes in background. Full Changelog: 2.8.2...2.8.3

2.8.2 · Updated Commons, Command Framework and Inventory Framework APIs. · Now rewards are disabled by default and updated rewards.yml messages. · Improvements on command system using the new features of Command Framework. · Improvements on arena setup system and arena editor. Full Changelog: 2.8.1...2.8.2

2.8.1 Release Notes · Added KOTLNewKingEvent event. · Fixed some commands not working properly. · Updated Command Framework and Commons libraries. · General code improvements. Full Changelog: 2.8.0...2.8.1

2.8.0 Release Notes · Recoded arena scheduler system with a more efficient and readable way. · Fixed reload command not reloads config options. · General code improvements using higher JDK features. What's Changed · feat: KOTLPlayerEnterArenaEvent and KOTLPlayerLeaveArenaEvent by @HappyAreaBean in #13 New Contributors · @HappyAreaBean made their first contribution in #13 Full Changelog: 2.7.9...2.8.0

2.7.9 Release Notes · Fixed scheduler type 1 makes join every player. · Fixed players not respawning in the right location when they die while playing KOTL. Full Changelog: 2.7.8...2.7.9

2.7.8 Release Notes: · Added 3 new option to check for players if they are inside any arenas which can work asynchronously. · These options may extremely be useful for large networks. Full Changelog: 2.7.7...2.7.8 Re-create the config.yml or copy the new added lines and add them into your file. ​

2.7.7 Release Notes · Added %player_arena% placeholder. · Changed "In-Game.There-Is-No-King" path with "Placeholders.There-Is-No-King". Full Changelog: 2.7.6...2.7.7 ​

2.7.6 Release Notes · No more caching player object in User class due to possibility of being null when player goes offline. Full Changelog: 2.7.5...2.7.6

2.7.5 Release Notes: · Fixed throwing exception when kill command executed for an in-game player. · Updated libraries: · Commons (Added support for new blocks and sounds) · CommandFramework Full Changelog: 2.7.4...2.7.5

2.7.4 Release Notes: · Added new page for arena options to setup menu. · Removed light and heavy pressure plates (fixes #12). · Fixed arenas not registering after creating. · Code based improvements. Full Changelog: 2.7.3...2.7.4

2.7.3 Release Notes: · Updated InventoryFramework. (JAR size reduced by 180 kbs). Full Changelog: 2.7.2...2.7.3

2.7.2 Release Notes: · Added enchantment support for kit items. · Fixed outline particle not updating when setting a new min or max area location. · Fixed outline particles not disappearing when the arena got deleted. · Fixed when the player leaves arena clear effect option not working. · Removed unused permissions from plugin.yml file. · Removed TabCompleter class and moved it into AdminCommands class. · General code improvements. Full Changelog: 2.7.1...2.7.2

2.7.1 Release Notes: · Added kit system. · Can be configured via kits.yml file. · Added custom kill message. · Added option to enable/disable damage. · Removed Main#getConfigPreferences method which is deprecated for future removal. · Fixed some of the items remain on player's inventory when the server reload command used. · General code changes and improvements. Full Changelog: 2.7.0...2.7.1

2.7.0 Release Notes: · General performance improvements. · Stated deprecated Main#getConfigPreferences method. · Moved async chat event to general event class and removed ChatEvents class. Full Changelog: 2.6.9...2.7.0

2.6.9 Release Notes: · Added arena outline particle effect to show game area. · This feature is optional and by default it is enabled, you can disable it via setup menu (/kotl edit ). · Your server must support particles so must have org.bukkit.Particle class. · Particle effect and particle density can be customized via config.yml file. · Some improvements on tab completer. New added lines to the config.yml file: Code (Text): # Your server must support particles to use that feature. Arena-Outlines: Step: .4 Particle: FLAME Full Changelog: 2.6.8...2.6.9 ​

2.6.8 Release Notes: · Added customizable table name for MySQL database. · Fixed all of the MySQL bugs and errors. · Updated CommandFramework. Full Changelog: 2.6.7...2.6.8

2.6.7 Release Notes: · Fixed MySQL database can not initialize properly. · Libraries updated to latest versions. · General code improvements. Full Changelog: 2.6.6...2.6.7

2.6.6 Release Notes: · Removed table name for MySQL database. · Code based changes and improvements. Full Changelog: 2.6.4...2.6.6

2.6.5 Release Notes: · Improved the help command. · Removed ScriptEngine from reward execution.

2.6.4 Release Notes: · Added 2 new rewards. · These will be executed Join and leave. · Fixed tab list changes after the game if scoreboard is enabled.

2.6.3 Release Notes: · Added option to disable restoring health elements.

2.6.2 Release Notes: · Fixed players can becom king if they rejoin.

2.6.1 Release Notes: · Switched to JDK 17. · Added support for multiple reward execution. · General code improvements based on new Java features.

2.6.0 Release notes: · Added MC 1.20.1 support. · Added new bamboo plate. · Centered menu titles. · Removed server version and Java version checkers.

2.5.9 Release notes:​ · Updated McRankings. · Removed unnecessary debugger.

2.5.8 Release notes:​ · Added McRankings support. · Added leaderboard command to update entries instantly (60 seconds delay for command).

2.5.7 Release notes · Now empty game bar messages won't be visible until the next message. · Updated some of the logging methods. · Some changes in pom.xml file.

2.5.6 Release notes: · Added description and usage for main command to Bukkit's help command. · Fixed non-op players can not be able to execute non-permission commands without prefix.

· Added MC 1.19.4 support.

2.5.4 Release notes: · Added kick command. · Fixed leaderboard is not sorting by values.

2.5.3 Release notes: · Added option to not let players become king in a row. · Fixed fireworks can sometimes damage king. · Fixed arena selector can sometimes could not be able to set second position. · Removed unnecessary 'PlayerEnterBed' event.

2.5.2 Release notes: · Now arena plate gui dynamically changes plate if location is set.

2.5.1 Release notes: · Added delay between rewards. · Fixed command delays. · Now arenas cache minimum and maximum location values.

2.5.0 Release notes: · Fixed scoreboards not removing after any player leaves the arena.

2.4.9 Release notes: · Added reloading config options and plugin prefix to reload command. · Fixed Hex colors on scoreboard. · Fixed scoreboard flickering for Minecraft 1.19 and higher versions.

KOTL 2.4.8 · Changed setup menu design. · Removed built-in hologram support. · Removed unnecessary debug lines. · Updated libraries.

2.4.7 Change logs: · Added support for Minecraft 1.19.3

2.4.6 Release notes: · Added log message if any other plugin not letting KOTL to remove arena holograms. · Now arena holograms can be deleted by shift clicking on setup menu. · Fixed non-op players can be able to see admin commands on tab complete. · Fixed non-op players can not be able to use default KOTL commands.

2.4.5 Release notes: · Removed debugger command. (Debugger can be enabled via config file)

Release notes: · Updated copyrights.

2.4.3 Release notes: · New command and event registering system and, added debug command

2.4.2 Release Notes: · Fixed NPE on arena registering. · Updated CommandFramework.

2.4.1 Change logs · Now OP players can place and break blocks in game.

2.4.0 Change logs · Now game bar can have different messages based on interval. · Now language manager won't override the default config until it changes. · Now hologram creation is optional (working on different hologram libraries to add support). · Added menu to change arena plate material to other type of pressure plates. · Added FIREWORKS_ON_NEW_KING option to spawn some fireworks if any player become king. · Added SHOW_TIPS option to disable pro tips for arena editor menu. · Added DEBUG_MESSAGES option to show log messages and timings. · Fixed tab completer shows main command. · Fixed reload command's description. · Removed some messages from admin commands.

I'm currently working on support for popular hologram plugins. · Added warning message to hologram item about holograms may be buggy with some servers. · Setup GUI improvements.

· Performance improvements.

· Fixed placeholders not working.

· Fixed potential NPE on Java 8. · Improvements for general command system.

· Updated bStats and PlaceholderAPI.

· Added missing plugin prefixe to some messages. · Added command matcher again (framework is updated and fixed remaining bugs). · Now top command can be executed by console too. · Removed help command showing in admin commands. · Removed some setup tips. Click here to go release notes.

· Fixed an issue related multiple world support. Click here to go release notes.

· Remade the command system using Command Framework (command matching is disabled for this update).

Hello everyone! In this update we have some serious improvements on our command system and general events. Also updated messages in-game and for console. · Lots of improvements on command system. · Lots of improvements on general events. · Updated some messages. · General code optimization.

In this update we added a console message that logs the initiaziltion is finished and new message to help command that adds a link of our Discord server for support. Optimized all of the events. Fixed update notifier option in config and some other refactorings. Also the JAR size reduced around 10-15 kb. · Added message that logs the initiazilation is finished. · Added message to help command that adds a link of our Discord server. · Fixed default update notifier option was blank in config file. · Optimized all of the events. · Some code based refactorings.

In this update we have updated our libraries for better support. Fixed some typos in configuration files and added some information about the premium version of KOTL. Click here to see features of the premium version. · Added some lines to config file. · Fixed some typos in configuration files. · Fixed titles and subtitles in 1.19 · Disabled bStats checking for Inventory Framework.