Whack Me | [1.8 - 1.21.4]

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.

----------, Dec 23, 2024

v1.6.7

Fixed update checker throws an exception if it is disabled.

----------, Nov 10, 2024

v1.6.6

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.

----------, Nov 9, 2024

v1.6.5

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"

----------, Nov 8, 2024

v1.6.4

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

----------, Nov 2, 2024

v1.6.3

Fixed user manager not working properly.

----------, Nov 1, 2024

v1.6.2

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.

----------, Oct 28, 2024

v1.6.1

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"

----------, Oct 19, 2024

v1.6.0

Fixed plugin not enabling due to invalid configuration.

----------, Oct 13, 2024

v1.5.9

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

----------, Oct 11, 2024

v1.5.8

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.

----------, Oct 5, 2024

v1.5.7

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

----------, Sep 2, 2024

v1.5.6

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.

----------, Aug 29, 2024

v1.5.5

Updated Commons license.

----------, Aug 22, 2024

v1.5.4

Updated help command content.

----------, Aug 20, 2024

v1.5.3

Fixed command matcher not working.

----------, Aug 12, 2024

v1.5.2

Support for Minecraft 1.21.1.

----------, Aug 11, 2024

v1.5.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.

----------, Jul 28, 2024

1.5.0

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.

----------, Jul 21, 2024

Fixed sounds can not be played in higher versions of Minecraft

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

----------, Jul 9, 2024

Added cooldown feature to play again and updated Commons

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!"

----------, Jul 9, 2024

Added new record reward, some changes and bug fixes

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!

----------, Jul 3, 2024

Support for Minecraft 1.21

Added support for Minecraft 1.21.

----------, Jun 20, 2024

Full support for Minecraft 1.20.5+ (Paper and forks)

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

----------, Jun 1, 2024

Fixed Paper breaks the arena signs

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.

----------, May 15, 2024

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.

----------, May 7, 2024

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.

----------, May 7, 2024

Fixed point block rotations

Discord: mrdespical

1.4.2

Fixed point block rotations.

----------, May 1, 2024

Now point blocks can be rotated around the vertical axis

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"

----------, May 1, 2024

Added option to rotate game blocks and fixed attack cooldown not restoring

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.

----------, Apr 29, 2024

Support for Minecraft 1.20.5

Discord: mrdespical

1.3.9

Support for Minecraft 1.20.5.

----------, Apr 29, 2024

Updated reload command and renamed a placeholder

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!"

----------, Apr 20, 2024

Added new command, placeholders and messages

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

----------, Apr 19, 2024

Added new condition to rewards and updated libraries

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"

----------, Apr 16, 2024

Fixed players can place eye of ender into arena portal frames and some improvements

Discord: mrdespical

1.3.5

Fixed players can place eye of ender into the end portal frames.
Fixed signs not updating after registering an arena.
Updated CommandFramework and some improvements on command system.

----------, Apr 6, 2024

Updated CommandFramework and some performance improvements

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

----------, Mar 27, 2024

Added a new placeholder and QoL 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.

----------, Mar 24, 2024

Some fixes and updated libraries

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.

----------, Mar 17, 2024

Some fixes and improvements

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.

----------, Feb 6, 2024

Added arena signs

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.

----------, Jan 31, 2024

Fixed update message is visible to un-permed players

1.2.9 Release Note:

Fixed update message is visible to un-permed players.

----------, Dec 29, 2023

Fixed statistic placeholders returns null

1.2.8-1 Release Notes

Fixed statistic placeholders returns null.

----------, Dec 11, 2023

Fixed some of the placeholders throws NPE in some cases

1.2.8 Release Notes:

Fixed some of the placeholders throws NPE in some cases.

----------, Dec 5, 2023

Switched to Java 8, lots of fixes and new features

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.

----------, Dec 3, 2023

Updated Paper API and no more caching player object in User class to prevent exceptions

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.

----------, Nov 16, 2023

Lots of bug fixes

1.2.5 Release Notes:

Fixed plugin not working on non-Paper forks.
Lots of additional bug fixes.

----------, Oct 16, 2023

Custom shaped arenas added!

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.

----------, Oct 5, 2023

Updated libraries and reduced jar files + some fixes

1.2.3 Release Notes:

Updated InventoryFramework.
- Reduced JAR size.
Fixed main command increases stats (was debug line).
Some message updates.

----------, Sep 25, 2023

Code based improvements and clean ups

1.2.2 Release Notes:

Code based improvements and clean ups.

----------, Sep 6, 2023

Fixed MySQL bugs and some other changes

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.

----------, Aug 17, 2023

Updated libraries and general peformance improvements

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.

----------, Aug 11, 2023

Added new API events

1.1.9 Release Notes:

Now working compatible with Murder Mystery plugin.
Added new API events.
- WMJoinEvent
- WMLeaveEvent

----------, Jul 18, 2023

Some fixes, changes and improvements

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.

----------, Jul 17, 2023

Added option to disable restoring health elements.

1.1.7 Release Notes:

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

----------, Jul 10, 2023

Recoded MySQL database

1.1.6 Release Notes:

Recoded MySQL database.
Removed 'table' value from mysql.yml file.

----------, Jul 8, 2023

Fixed MySQL database throws NPE and added new config values

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.

----------, Jul 7, 2023

Moved to JDK 17 and added multiple reward execution

1.1.4 Release Notes:

Added support to run multiple commands in rewards.
Fixed some permissions.
Moved to Java 17.
General code improvements.

----------, Jun 27, 2023

Added MC 1.20.1 support

1.1.3 Release Notes

Added MC 1.20.1 support.

----------, Jun 19, 2023

Lots of bug fixes and improvements

1.1.2 Release Notes

Fixed command bugs.
General improvements.

----------, May 23, 2023

Removed unnecessary debugger and some message fixes

1.1.1 Release notes:

Fixed some of the messages don't have prefix.
Removed unnecessary debugger.

----------, May 5, 2023

Updated libraries and some quality improvements

1.1.0 Release notes:

Updated libraries.
Some quality improvements.

----------, Apr 13, 2023

Async support and lots of bug fixes

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.

----------, Apr 1, 2023

Fixed skulls and support for using both blocks and skulls at the same time

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.

----------, Mar 31, 2023

Added custom skull blocks and MC 1.19.4 support

1.0.7 Release notes:

Added custom skull blocks.
Added MC 1.19.4 support.

----------, Mar 30, 2023

Fixed scoreboard flickering in MC 1.19+

1.0.6 Release notes:

Fixed scoreboard flickering in MC 1.19+

----------, Mar 2, 2023

Added Minecraft 1.8.x support and more

Added randomjoin command.
Added leave command.
Added option to block leave command.
Added Minecraft 1.8.x support.
Changed point block's Y axis multiplier to higher value and increased maximum height point block can reach.

----------, Feb 14, 2023

Fixed action bar not working on servers that runs Spigot

1.0.4 Change logs: