Whack Me | [1.21.11 - 26.3]

What's Changed · Unreadable stored arena options and statistics now log a clear warning naming the value and fall back to the default instead of printing a raw stack trace. · Added the plugin icon and a centered header to the README. · Refreshed the marketplace descriptions with cleaner section headings and centered spoilers. · Updated the supported Minecraft badge to 26.3. · bump gradle-wrapper from 9.8.0 to 9.8.1 by @dependabot in #14 · Bump gradle-wrapper from 9.8.1 to 9.8.2 by @dependabot in #15 · Bump gradle/actions from 6.4.0 to 6.4.1 by @dependabot in #16 Full Changelog: 2.0.2...2.0.3

What's Changed · Fixed outside chat reaching players inside Whack Me arenas when chat isolation is enabled. · Fixed games remaining active for an extra second after the countdown reaches zero. · Fixed the leave-command blocking option being overridden by command allowlists, including wildcard entries. · Fixed scoreboard visibility changes not taking effect immediately after /wm reload. · Improved leaderboard updates to avoid scanning and sorting the entire player database after every game, while preserving correct rankings and stable ties. · Refreshed the plugin description with clearer sections, setup guidance, commands, and placeholder references. · Updated Gradle, build actions, and Lombok dependencies. Full Changelog: 2.0.1...2.0.2

What's Changed · Fixed inactive point blocks being able to award scores after a game state transition. · Fixed reward commands being dispatched outside their intended game lifecycle states. Full Changelog: 2.0.0...2.0.1

What's Changed · Added a configurable reward system for game joins, early departures, completed games, and green, red, or gray block interactions. · Added a dedicated rewards.yml with a global toggle, documented placeholders, hex colors, and commented command examples. · Added console command execution by default and the p: prefix for player-executed reward commands. · Added main-thread reward dispatch and /whackme reload support for reward configuration changes. Full Changelog: 1.9.9...2.0.0

What's Changed · Improved the /whackme debug component command with optional config message paths via --path. · Updated PlaceholderAPI version reporting to use Paper's modern plugin metadata. · Added small code style and editor configuration improvements. · Bump gradle-wrapper from 9.6.1 to 9.7.0 by @dependabot[bot] in #9 Full Changelog: 1.9.8...1.9.9

What's Changed · Fixed admin help permissions incorrectly referencing TNTRun. · Added console support for the /whackme kick <player> command. · Bump gradle/actions from 6 to 6.2.0 by @dependabot[bot] in #7 · Bump gradle/actions from 6.2.0 to 6.3.0 by @dependabot[bot] in #8 Full Changelog: 1.9.7...1.9.8

Improvements · Added the new leaderboard-size configuration option. · Leaderboard placeholders can now display positions beyond the previous top 10 limit. · The default leaderboard size remains 10 to preserve existing behavior. Full Changelog: 1.9.6...1.9.7

Fixes · Fixed point blocks failing to apply score changes when Paper delivered an already-cancelled armor stand hit event. · Fixed arena leaderboards not appending the viewed player when ranked fourth through tenth. · Fixed flat-file leaderboards skipping stored players missing from Paper's local name cache. · Removed Bukkit player lookups from asynchronous flat-file leaderboard loading. Improvements · Added persistent personal-best scores for each arena. · Added independent top-ten leaderboards for every arena. · Updated arena stats cards to show the player's score and ranking for the selected arena instead of their overall record. · Expanded public API and event documentation with lifecycle, cancellation, ownership, and nullability details. · Simplified arena data saver initialization. Notes · Existing overall personal records are preserved. · Arena-specific personal bests begin recording after updating because historical scores cannot be assigned to a specific arena. Full Changelog: 1.9.5...1.9.6

Fixes · Prevented invalid portal locations from being treated as valid arena data. · Improved autosave and arena data persistence reliability. Improvements · Fixed player inventory loss after quitting and rejoining an active game. · Added durable inventory recovery across server restarts. · Prevented inventory clearing when snapshot creation fails. · Moved inventory snapshot handling into PlayerInventoryManager. · Fixed plugin startup crashes caused by signs saved in unloaded worlds. · Invalid arena locations now mark arenas as not ready. · Unresolved sign locations are preserved for later recovery. · Fixed async autosave access to sign block entities. · Protected point-block armor stands from manipulation and damage by all players. · Only the active arena player can score from point blocks. Full Changelog: 1.9.4...1.9.5

Fixed · Fixed command feedback so configured messages and placeholders are used consistently. · Fixed console command usage and sender handling. · Fixed help command registration and command system improvements. · Fixed player cooldowns being reset unexpectedly. · Fixed command-settings.disable-commands-while-playing not controlling command blocking. · Fixed arena IDs containing dots or conflicting case-insensitively with existing IDs. · Fixed periodic autosave not writing flat-file scores and arena changes to disk. · Fixed mutable arena defaults being shared between arenas, including point-block lists and item stacks. · Fixed arena option defaults when loading missing or invalid values. Improvements · Added arena ID validation for YAML-safe persistence. · Added generated defaults for mutable arena options. · Updated editor configuration consistency. Full Changelog: 1.9.3...1.9.4

Whack Me 1.9.3 Fixes · Fixed wrong plugin ID in update checker. Full Changelog: 1.9.2...1.9.3

Fixes · Zero-score games no longer count as arena records. · Cooldown feedback now shows the remaining wait time. Improvements · The action bar now displays formatted time and live accuracy. · The game start message now reflects the configured gameplay duration.

Whack Me v1.9.1 Changes · Updated the Arena Boss Bar toggle accent color to match its orange theme. · Improved Arena Scoreboard and Boss Bar description formatting. · Centralized dependency repository management in settings.gradle. · Removed project-level and local Maven repository declarations. Full Changelog: 1.9.0...1.9.1

Whack Me v1.9.0: Complete Rewrite​ Whack Me is back with its biggest update yet. This is not a small patch or routine maintenance release. The plugin has been completely rewritten from the ground up. The gameplay engine, arena runtime, setup system, statistics, storage, commands, configuration, integrations, and developer API have all been rebuilt for a faster, safer, and more polished experience. Whack Me Is Now Open Source Originally released on August 29, 2022, Whack Me is becoming open source for the first time today. Starting with v1.9.0, Whack Me is completely free and open source under the GPL-3.0 license. Developers can now explore the source code, build custom integrations, report issues, suggest improvements, and contribute directly to the project through GitHub. Important Upgrade Notes Whack Me v1.9.0 is a complete rewrite and should be treated as a major upgrade. · Java 25 or newer is required. · Back up the entire /plugins/WhackMe/ folder before updating. · Test the update on a staging server before using it in production. · The configuration structure has changed substantially. Regenerating the default configuration files and manually reapplying custom settings is strongly recommended. · Storage changes and backend switches do not perform automatic data migration. · Plugins using the legacy Whack Me API must be updated to the new typed event API. Resources · Documentation: https://docs.despical.dev/whack-me/ · Javadocs: https://javadoc.despical.dev/whack-me/ · GitHub: https://github.com/Despical/WhackMe · SpigotMC: https://www.spigotmc.org/resources/whack-me.104912/ · BuiltByBit: https://builtbybit.com/resources/whack-me.50294/ Thank you to everyone who has used, supported, and provided feedback for Whack Me since its original release.

Whack Me v1.8.9 Improvements · Optimized arena sign lookup performance by replacing repeated linear scans with direct location-based indexing in the sign manager. · Reduced arena sign event overhead by registering join and break listeners only when active arena signs actually exist. · Disabled runtime arena sign listeners automatically when no arena signs are available, lowering unnecessary event processing on idle servers. · Re-enabled runtime arena sign listeners dynamically as soon as a new arena sign is created, keeping the optimization seamless during setup and gameplay. Bug Fixes · Fixed arena sign removal persistence flow so saved sign locations are cleaned up more reliably when a registered sign is broken. · Fixed arena sign path handling to use the arena identifier consistently while saving and removing sign data. · Fixed listener state after reload and sign loading so runtime sign handlers now correctly match whether valid arena signs are present.

· Updated CommandFramework to v1.5.9. · Fixed aliases for tab completers not working.

· Updated CommandFramework to v1.5.8. · Huge performance improvements on the command system.

· Updated Command Framework to v1.5.7. · General performance improvements. · Excluded some of the unnecessary folders from the plugin JAR.

· Added support for Minecraft 1.21.11.

· Added support for Minecraft 1.21.9/1.21.10. · Fixed point block listeners get leaked. · Fixed statistics of an online player do not load if a server reload is called. · Fixed MySQL related issues. · The project has been migrated to Gradle.

· MC 1.21.8 support.

· MC 1.21.6 & 1.21.7 support.

· Migrated project from Java 8 to Java 21, updated codebase and dependencies accordingly. · Updated Inventory Framework to the latest available version.

· Updated libraries. · Commons · Inventory Framework · Small, code based changes/improvements.

· Use ExecutorService for async MySQL operations. · Replaced Bukkit's async scheduler with a dedicated ExecutorService to handle MySQL operations. This improves control over threading and ensures proper shutting down of tasks during plugin termination. Adjusted SQL queries for consistent formatting.

· Fixed leaderboard is not working efficiently on flat file statistics and consuming too much memory if there are lots of user data.

· Performance improvements on the MySQL statements. · Other code based small improvements.

· Support for different World Manager plugins such as: · Multiverse-Core · SlimeWorldManager · SlimeWorldPlugin · MultiWorld · My_Worlds

· Support for MC 1.21.5. · Updated Commons library · Updated Inventory Framework library.

· Improvements on the reward system. · Updated Commons library.

· Fixed an exception occurring on plugin start.

· Fixed sounds not playing on Minecraft 1.21+. · Updated Commons library.

· Code refactoring and cleaning. · Updated Commons library.

· Fixed some of the command messages not reloading by using the reload command.

· Updated Command Framework library.

· Support for Minecraft 1.21.4. · Fixed an issue with loading statistics from the MySQL database during server reload, especially when players are online. · Fixed auto data saving works instantly on server reload/start. · Fixed potion effect issues in Minecraft 1.8.X.

· Fixed update checker throws an exception if it is disabled.

· Fixed a potential bug related to MySQL database. · Updated Commons to v1.8.82. · Now /wm time command can be executed by players. · Removed unused permissions from plugin.yml file. · Better update checking.

· Added leaderboard placeholders. · Added option to save user data periodically. · Separated StatisticType class from StatsStorage class. · Better Whack Me API event calling. · Updated Command Framework to v1.5.12. · Other code based changes/improvements. Changes in the config.yml Code (YAML): # The statistics saving rate, in seconds. (0 = save the stats on server shutdown/reload) Statistic-Saving-Period : 300 Changes in the messages.yml Code (YAML): Placeholders: Empty-Position : "No Player" Empty-Value : "NaN" # %wm_{arena}_player_name% -> This placeholder returns the text below if arena player is null. Unknown-Player : "Unknown"

· Added "/wm version" command that displays detailed information about the plugin and server environment.

· Fixed user manager not working properly.

· Support for Minecraft 1.21.2 & 1.21.3. · Fixed players stay in the arena if they quit the game and rejoin to server, now they'll be teleported to end location. · Lots of improvements on the commands, database system and user system.

· Added option to customize the timer format in the action bar. · Fixed stats command not showing the target player's name. · Improvements on the MySQL database. · Updated Commons library. Changes in the messages.yml Code (YAML): In-Game: Timer-Format : "%02d:%02d"

· Fixed plugin not enabling due to invalid configuration.

· Added arena based custom point blocks. Changes in the config.yml Code (YAML): # The point block settings. Point-Blocks : # Entity removal is still going to be executed in main thread. # This option may decrease the amount of lag if there are multiple # instances running at the same time. Run-Async : false # Period of point handler thread. If you decrease that value the blocks # will move faster and if you increase the period then they'll move slower. # This option should be edited considering Y multiplier. # Best way to make blocks move faster is increasing multiplier below. Ticks : 8 # Point blocks are maximum raised by total of 0.65 in Y axis. Y-Multiplier : 0.05 # How many milliseconds should any point block wait in the air? Wait-Ms : 12 # Point blocks can be rotated around the vertical axis. Rotations : # Values below are represented to yaw of point blocks in the game. Punch-Me : "0:0:0:0:0:0:0:0" Dont-Punch-Me : "0:0:0:0:0:0:0:0" Ouch : "0:0:0:0:0:0:0:0" # The default point block materials. Default : # For custom skulls: "skull:VALUE" Punch-Me : GREEN_TERRACOTTA Dont-Punch-Me : RED_TERRACOTTA Ouch : CYAN_TERRACOTTA Custom : # The ID of the arena. default : # For custom skulls: "skull:VALUE" Punch-Me : GREEN_TERRACOTTA Dont-Punch-Me : RED_TERRACOTTA Ouch : CYAN_TERRACOTTA

· Now the action bar message can be disabled if it is set to a empty string. · Now using the ActionBar class from Despical's Commons library. · Updated libraries for better performance and compatibility: · Despical's Commons. · Despical's Command Framework. · bStats.

· Fixed no permission message not working. · Leave 'Commands.No-Permission' empty if you don't want to send a message.

· Added 2 new placeholders: · %wm_all_arenas% - The total number of arenas. · %wm_ready_arenas% - The number of arenas that are ready to be played in.

· Updated Commons license.

· Updated help command content. ​

· Fixed command matcher not working.

· Support for Minecraft 1.21.1.

· Updated Command Framework to v1.4.9. · Fixed some of the commands sending command usage instead of sending the error message. · Some improvements on the command system.

· Now minimum and maximum point block amounts can be customizable for different arenas. · Removed the 'Point-Blocks.Points.Min and Max' paths from config file. · The amounts can be edited via arena editor menu (/wm edit). · Updated Command Framework to the latest available version. · Fixed custom portal editor not working in legacy versions of Minecraft. This update may break your arenas because point block amounts will now be held individually for each arena. Don't forget to check the arena editor to adjust the minimum and maximum point block amounts.

· Fixed sounds can not be played in higher versions of Minecraft that causes to break plugin.

· Added cooldown feature to play again. · Updated Commons to latest version. · Support for new added items in MC 1.20+ · Support for new added sounds in MC 1.17+ Changes in config.yml Code (YAML): # Should players wait a certain amount of time before playing again Whack Me? (in seconds) Game-Cooldown : 0 Changes in messages.yml Code (YAML): Commands: Wait-For-Cooldown : "&cPlease wait a bit before playing again!"

· Added reward that will be performed when a player beats their highest score. · Fixed command matcher system not working properly. · Fixed kick command's usage description. · Removed confirmation from delete command. · Changes and improvements on arena setup menu. Changes in rewards.yml Code (YAML): rewards : # The rewards performed when player beats their highest score. new-record : - p:say I beat my highest score!

· Added support for Minecraft 1.21.

· Full support for Minecraft 1.20.5+ (Paper and forks).

Discord: mrdespical 1.4.4 · Fixed Paper breaks the arena signs in Minecraft 1.20.4+. · Fixed players can get damage from a cause outside the arena.

Discord: mrdespical 1.4.3 · Fixed MySQL throws exception due to new statistics haven't been added to stats table yet. · Fixed including 'toursplayed' statistic twice in the update string for MySQL. · Fixed 'longest streak' statistic not updating due to resetting stats before updating the current. · Updated Command Framework.

Discord: mrdespical 1.4.3 · Fixed MySQL throws exception due to new statistics haven't been added to stats table yet. · Fixed including 'toursplayed' statistic twice in the update string for MySQL. · Fixed 'longest streak' statistic not updating due to resetting stats before updating the current. · Updated Command Framework.

Discord: mrdespical 1.4.1 · Now point blocks can be rotated around the vertical axis. Config Changes Code (YAML): Point-Blocks : # Point blocks can be rotated around the vertical axis. Rotations : # Values below are represented to yaw of point blocks in the game. Punch-Me : "0:0:0:0:0:0:0:0" Dont-Punch-Me : "0:0:0:0:0:0:0:0" Ouch : "0:0:0:0:0:0:0:0"

Discord: mrdespical 1.4.0 · Added option to change yaw and pit values of the game blocks. · Now after the game, cooldowns will be restored to their previous value before the game.

Discord: mrdespical 1.3.9 · Support for Minecraft 1.20.5.

Discord: mrdespical 1.3.8 · Renamed %longest_streak% -> %longest_point_streak%. · Now reload command will reload config options, messages, arenas, rewards, sounds and arena signs. · Now sounds can be disabled by typing 'NONE'. Config Changes Code (YAML): # Set NONE to disable. Sounds : # The sound plays when player clicks the correct point block. Point : "ORB_PICKUP" # The sound plays when player clicks the incorrect point block. Minus-Point : "NOTE_BASS" Messages File Changes Code (YAML): Commands: Reload-Command: Initialized : "&aPlugin reload initialized by {0}." Finished : "&aPlugin reload finished successfully." Error-Occurred : "&cException occurred during the plugin reload!"

Discord: mrdespical 1.3.7 · Added command to manipulate timer of an arena. · /wm time <arena> <add | remove | set> <value> · Added 3 new PAPI placeholder. · %longest_streak% - Shows player's longest point streak. · %local_point_streak% - Shows player's current streak, if they are in-game. · %local_longest_point_streak% - Shows player's current longest streak in the game, if they are playing. · Added 2 new placeholders that can be used in rewards.yml. · %point_streak% - Point streak of player in current game. · %longest_point_streak% - Longest point streak of player in current game. · Updated help command messages. · Fixed leaderboard command not using the table value from MySQL config, if MySQL is enabled. Messages File Changes Code (YAML): Commands: Stats-Command: Messages : - "%header%" - "&8 * &aRecord Score : &e%record_score%" - "&8 * &aTours Played : &e%tours_played%" - "&8 * &aWhacked Plus Points : &e%whacked_point_blocks%" - "&8 * &aWhacked Minus Points : &e%whacked_minus_point_blocks%" - "&8 * &aWhacked Block Rate : &e%whacked_block_rate%%" - "&8 * &aLongest Point Streak : &e%longest_point_streak%" Code (YAML): Commands: Time-Command: Usage : "&cCorrect usage: /wm time <arena> <add | remove | set> <value>" Arena-Is-Empty : "&cNo one is playing in this arena at the moment!" Special thanks to @iKilledEveryone for their contributions! <3

Discord: mrdespical 1.3.6 · Added new points condition to rewards. · Can be merged with chance conditions. · Example usages: · points(10):chance(99):say Hello! · points(5):say Hey everyone! · Updated Commons to v1.7.3. · New unrestorable attributes for inventory manager option. 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"

· Updated CommandFramework. · More detailed argument length check failed messages. · Removed unnecessary comments from rewards.yml. · Code based improvements.

Discord: mrdespical 1.3.3 · Added a new placeholder to show local score of player, %wm_local_score%. · Reduced the delay to close inventory after clicking the close item. · Now point blocks won't make noise and they are not persistent. · Improvements on command, setup and reward system.

Discord: Despical 1.3.2: · Updated libraries. · Improved the command matcher system. · Improved the tab completer system. · Added message to '/wm kick <player>' command. · Fixed some system messages do not have prefix. · Fixed shift click bugs in menus. · Other minor changes in code base.

1.3.1 · Updated Commons and Command Framework APIs. · Fixed showing arena names for arena create command. · Fixed some of the commands can not be executed, especially with optional arguments. · Removed extra statistic saving on disable stage. · Removed unnecessary messages.yml comments and messages. · Now on sign loading we'll automatically delete non-sign blocks instead of sending a warning message every time.

1.3.0 Release Notes · Added arena signs. · Fixed tab completer permissions. (wm.admin) · Fixed User#getStats method throws exception. · Fixed arenas were joinable even they are not ready to play. .SpoilerTarget">Spoiler: Arena Sign

1.2.9 Release Note: · Fixed update message is visible to un-permed players.

1.2.8-1 Release Notes · Fixed statistic placeholders returns null.

1.2.8 Release Notes: · Fixed some of the placeholders throws NPE in some cases.

1.2.7 Release Notes · Switched back to Java 8 to support Minecraft 1.8.x. · Updated stats command messages. · Added 4 new placeholders: · Added %wm_online_players% placeholder to see how many active players playing Whack Me in the current server. · Added %whacked_point_blocks% to see how many plus point blocks player hit. · Added %whacked_minus_point_blocks% to see how many minus point blocks player hit. · Added %whacked_block_rate% to see rate of hit plus blocks / hit minus blocks. · Added ability to override CommandFramework's permission message. · Fixed tab completer sends all admin commands associated with WM to non-admin players. · Other code based improvements and changes.

1.2.6 Release Notes · Updated Paper API to 1.20.2-SNAPSHOT. · No more caching player object in User class to prevent NPE when player goes offline.

1.2.5 Release Notes: · Fixed plugin not working on non-Paper forks. · Lots of additional bug fixes.

1.2.4 Release Notes: · Custom shaped arenas added. · Help command header will be sent as centered to console and players. · Updated libraries. · Added support for 1.20+ items and sounds. · Some improvements on commands.

1.2.3 Release Notes: · Updated InventoryFramework. · Reduced JAR size. · Fixed main command increases stats (was debug line). · Some message updates.

1.2.2 Release Notes: · Code based improvements and clean ups.

1.2.1 Release Notes: · Added customizable table name for MySQL users. · Fixed all of the bugs and erros about MySQL database. · Updated setup item names and centered their title. · Removed unused options from config.yml file. ​

1.2.0 Release Notes: · Updated CommandFramework. · Removed some unnecessary log messages. · Fixed if arena name contains 'default' then it won't be registered. · General performance improvements.

1.1.9 Release Notes: · Now working compatible with Murder Mystery plugin. · Added new API events. · WMJoinEvent · WMLeaveEvent

1.1.8 Release Notes: · Now if you shift click set start location item it'll automatically create game area around the player without having to place blocks manually. · Now if you accidentally remove a block from game arena and reload the server and place it back then it'll register itself without resetting the start location after a new server reload. · Fixed unready arenas are also in the sorted list that used for random join command. · Removed ScriptEngine from reward execution due to it's been removed in JDK 15. · Some general improvements.

1.1.7 Release Notes: · Added option to disable restoring health elements. · Some improvements on help command messages and now they're sorted.

1.1.6 Release Notes: · Recoded MySQL database. · Removed 'table' value from mysql.yml file.

1.1.5 Release Notes: · Added 'Ticks' value to change point handler thread's period. · Fixed skull URLs not working. · Fixed MySQL database throws NPE. · Changed default reward commands.

1.1.4 Release Notes: · Added support to run multiple commands in rewards. · Fixed some permissions. · Moved to Java 17. · General code improvements.

1.1.3 Release Notes · Added MC 1.20.1 support.

1.1.2 Release Notes​ · Fixed command bugs. · General improvements.

1.1.1 Release notes: ​ · Fixed some of the messages don't have prefix. · Removed unnecessary debugger.

1.1.0 Release notes: · Updated libraries. · Some quality improvements.

1.0.9 Release notes: · Added async support, now point block threads can run asynchronous which may reduce the lag if there are multiple instances running at the same time. (some of the operations like entity removal is still going to be executed in main thread which can not be done asynchronously) · Now point block items will be updated with reload command. · Fixed the game can not define point block types if they are all skull items. · Fixed the point blocks spawning as one type.

1.0.8 Release notes: · Added support for using item stacks and skull items at the same time. · Recoded command system with Command Framework. · Changed schematic of skull usage in config. (add 'skull:' before URL) · Fixed arena can not detect custom skulls if there are more than one.

1.0.7 Release notes: · Added custom skull blocks. · Added MC 1.19.4 support.

1.0.6 Release notes: · Fixed scoreboard flickering in MC 1.19+