![Whack Me | [1.21.11 - 26.2]](https://www.spigotmc.org/data/resource_icons/104/104912.jpg?1784195861){kind=icon}
Minimum Java Version: Java 25
WHACK ME
Whack Me is a fast-paced, single-player whack-a-block minigame for Minecraft servers.
The player enters a configured arena and tries to hit as many green point blocks as possible before the timer expires while avoiding red blocks. Correct hits increase the score and streak; incorrect hits reduce the score and reset the current streak. At the end of a run, Whack Me reports the final score, personal best, longest streak, success rate, and correct and incorrect hits.
![[IMG]](//proxy.spigotmc.org/ff5302062fc867ff0430fb76f227c05455ae1a8e/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f313239313031313232353436373232343134383f6c6162656c3d446973636f7264266c6f676f3d646973636f7264267374796c653d666f722d7468652d6261646765)
![[IMG]](//proxy.spigotmc.org/008c18c12c47d86c8cfefb7a9eabd260bf568f4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f63756d656e746174696f6e2d57696b692d626c75653f7374796c653d666f722d7468652d6261646765266c6f676f3d676974626f6f6b)
![[IMG]](//proxy.spigotmc.org/37ee17426efc1c63251c129bcce0eb2ab51f8b46/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a617661646f63732d4150492d6f72616e67653f7374796c653d666f722d7468652d6261646765266c6f676f3d6f70656e6a646b)
![[IMG]](//proxy.spigotmc.org/ea5f64429fe263a5bb09f0ba1e23d4caaa0f1341/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f536f757263652d4769744875622d626c61636b3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)
GAMEPLAY SHOWCASE
Watch Whack Me in action, from joining an arena and hitting rising point blocks to streak building, result summaries, personal bests, and arena records.
![[IMG]](//proxy.spigotmc.org/2056c9d39531c29501a41074e457400422ee69b8/68747470733a2f2f692e696d6775722e636f6d2f54306a7a684f302e6a706567)
FEATURES
ARENA SETUP GUIDE
Whack Me arenas are configured through the interactive menu opened with /wm edit <arena>. This guide follows the entire workflow from creation to a playable, registered arena.
GAMEPLAY FLOW
![[IMG]](//proxy.spigotmc.org/594f8a27ce50a0c77b4d9bd6ad3674f0431b640a/68747470733a2f2f692e696d6775722e636f6d2f6b7231566947662e706e67)
![[IMG]](//proxy.spigotmc.org/2ff8c96cf869199331b0feab9955c95c34777c30/68747470733a2f2f692e696d6775722e636f6d2f567655565830552e706e67)
COMMANDS & PERMISSIONS
All commands can be used via /whackme or /wm.
STATS & LEADERBOARDS
Whack Me rewards players who keep coming back. Track completed games, perfect runs, personal record scores, longest hit streaks, lifetime green and red hits, success rate, and per-arena records—then display the server's top performers through the built-in stats menu and live leaderboards.
![[IMG]](//proxy.spigotmc.org/fe9b634e5365b08c41ab8dc66c0f70d23dfabc28/68747470733a2f2f692e696d6775722e636f6d2f744d494446356b2e706e67)
![[IMG]](//proxy.spigotmc.org/f1ee21b09978dd65e29c4860e88a9c7b466ec288/68747470733a2f2f692e696d6775722e636f6d2f304b497038514e2e706e67)
PLACEHOLDERS
To use these placeholders, you must have PlaceholderAPI installed on your server.
bStats METRICS
This plugin collects anonymous usage statistics through bStats.
This data helps us understand how Whack Me is being used in the wild and helps guide future development. No private information is collected.
![[IMG]](//proxy.spigotmc.org/65a41823a4f752951cbc54168225fe834c67f8be/68747470733a2f2f6273746174732e6f72672f7369676e6174757265732f62756b6b69742f576861636b4d652e737667)
Enjoying the plugin?
We spend hundreds of hours making Whack Me the best minigame experience for your server.
If you like the plugin, please consider leaving a 5-star review!
A huge thank you to everyone who has supported the project so far! ❤️
WHACK ME
Whack Me is a fast-paced, single-player whack-a-block minigame for Minecraft servers.
The player enters a configured arena and tries to hit as many green point blocks as possible before the timer expires while avoiding red blocks. Correct hits increase the score and streak; incorrect hits reduce the score and reset the current streak. At the end of a run, Whack Me reports the final score, personal best, longest streak, success rate, and correct and incorrect hits.
GAMEPLAY SHOWCASE
Watch Whack Me in action, from joining an arena and hitting rising point blocks to streak building, result summaries, personal bests, and arena records.
FEATURES
- Fast Single-Player Gameplay: Give players a focused, replayable timed score challenge where every decision matters.
- Dynamic Point Blocks: Green and red blocks rise, wait, and fall from configured portal locations throughout every run.
- Balanced Block Selection: Whack Me keeps visible reward and penalty blocks close to an even distribution for fair, unpredictable gameplay.
- Arena-Specific Tuning: Configure minimum and maximum active blocks, movement speed, peak wait time, spawn checks, and asynchronous movement per arena.
- Custom Block Appearances: Use blocks, player heads, or custom items for the green, red, and gray hit states.
- Interactive GUI Setup: Create and manage arenas through visual in-game menus instead of manually editing data files.
- Custom Portal Layouts: Build automatic eight-frame layouts or design fully custom point-block positions with the portal editor.
- Arena Signs: Create clickable, auto-updating join signs that let players enter available arenas instantly.
- Scoreboards, Boss Bars & Action Bars: Display live timers, scores, streaks, success rates, and arena records during gameplay.
- Detailed Result Summaries: Report final score, personal best, longest streak, correct and incorrect hits, and success rate after every completed run.
- Configurable Rewards: Run console or player commands when players join, quit, finish a game, or hit green, red, and gray blocks, with built-in player, arena, score, streak, and block placeholders.
- Personal & Arena Records: Track each player's highest score and every arena's global record holder.
- Perfect Runs & Statistics: Record games played, perfect runs, lifetime hits, personal records, and longest streaks.
- Built-In Leaderboards: Rank the server's top players by scores, perfect runs, streaks, and lifetime block hits.
- Safe Player State Handling: Inventories, armor, potion effects, food, and player state are restored automatically after a run.
- Arena Protection & Isolation: Prevent block changes, item abuse, damage, and unwanted command or chat interference while players compete.
- Music Support via NoteBlockAPI: Assign custom .nbs songs per arena, preview tracks in-game, or use the bundled music library.
- Highly Configurable: Customize messages, sounds, menus, scoreboards, boss bars, signs, gameplay behavior, and presentation.
- PlaceholderAPI Support: Display live game data, persistent statistics, arena records, and leaderboards in other plugins.
- Flat File & MySQL Storage: Start with simple local storage or persist player statistics through MySQL.
- Developer API: Hook into game lifecycle, player flow, and statistic changes through public Bukkit events.
- Debug & Profiling Tools: Preview MiniMessage components and inspect event timing reports for troubleshooting.
ARENA SETUP GUIDE
Whack Me arenas are configured through the interactive menu opened with /wm edit <arena>. This guide follows the entire workflow from creation to a playable, registered arena.
Spoiler: Click to view Step-by-Step Guide & GIFs
Step 1: Create the Arena
Create a new arena with a unique, stable ID:
![[IMG]](//proxy.spigotmc.org/e02c00c13127c29df6f1494638e9ec2c441b8785/68747470733a2f2f692e696d6775722e636f6d2f67675a307674612e706e67)
Use IDs such as arcade_1 or castle_whack. The ID is reused by join commands, placeholders, setup output, and saved data.
Step 2: Open the Setup Menu
![[IMG]](//proxy.spigotmc.org/1b679c909fa99cf60d7862ff1d616a361450fd8a/68747470733a2f2f692e696d6775722e636f6d2f334d3851524b552e676966)
The home page provides access to locations, portal layout editing, point-block settings, music, display toggles, arena records, signs, and final registration.
Step 3: Set Start and End Locations
![[IMG]](//proxy.spigotmc.org/1000b35a21d12e64ea526caa9811cb8e8a63380f/68747470733a2f2f692e696d6775722e636f6d2f435569683359412e676966)
Open Manage Arena Locations ( FILLED_MAP). Both locations are required.
Start Location
When the plugin detects the surrounding frame ring, those eight blocks become the arena's portal locations automatically.
End Location
The end location is used after normal finishes, leaves, kicks, cancellations, and reconnect recovery.
Step 4: Define the Portal Layout
![[IMG]](//proxy.spigotmc.org/1613401f02a9929c6d64e128e008bde5ad470a35/68747470733a2f2f692e696d6775722e636f6d2f4b5054443670332e676966)
Portal locations are the positions from which point blocks rise. Use the automatic eight-frame ring from the start-location action, or click Manage Portal Layout ( ENDER_PEARL) to build a custom layout.
In Portal Editing Mode:
Note: Registration requires at least one portal location. In practice, use several well-spaced frames so multiple blocks can be visible and reachable at once.
Step 5: Open Point-Block Settings
![[IMG]](//proxy.spigotmc.org/b73addad6c14df065b968c32d1f1746bc6b97325/68747470733a2f2f692e696d6775722e636f6d2f5963596a5a44572e676966)
The Point Block Settings entry unlocks after portal locations exist. It opens a dialog with arena-specific spawning, movement, and appearance controls.
Step 6: Set Active Block Amounts
Choose Active Block Limits to edit the minimum and maximum together. Both are capped by the number of portal locations. If the maximum is set below the minimum, Whack Me raises it to match; changing either value individually also keeps the pair valid.
Tip: More simultaneous blocks increase visual load and decision pressure. Start with 4-8, then test the layout from a player's viewing angle.
Customize Block Appearance (Optional)
Use Customize Point Block Looks to assign the green, red, and gray hit-state items. Put an item on your cursor and click the corresponding preview slot. Blocks, player heads, and custom item metadata are supported, and the saved stack amount is normalized to one.
Step 7: Select Arena Music (Optional)
![[IMG]](//proxy.spigotmc.org/ce479f7caca079d32c032699f8ed15da27d9fa0a/68747470733a2f2f692e696d6775722e636f6d2f394469564c54532e676966)
If NoteBlockAPI is installed, Select Arena Music lists every valid .nbs file in /plugins/WhackMe/musics/.
Whack Me includes five starter songs and repeats the selected song while a player occupies the arena.
Step 8: Configure Other Settings (Optional)
![[IMG]](//proxy.spigotmc.org/60b26558cfbc29842bb5314a42e83c0eed1d7e59/68747470733a2f2f692e696d6775722e636f6d2f4a7a4c563566502e676966)
The Other Arena Settings page controls two independent per-arena options:
Changes apply immediately if that arena currently has a running game.
Step 9: Reset an Arena Record (Optional)
![[IMG]](//proxy.spigotmc.org/d85af8eaf7ff46cf9280dccbb7d2591bda14111e/68747470733a2f2f692e696d6775722e636f6d2f456e334b735a782e676966)
After an arena has a record, Reset Arena Record shows its holder and score. The confirmation page prevents accidental deletion. Confirming resets only that arena's global holder to None and score to 0; it does not erase player statistics or personal records.
Step 10: Create a Join Sign (Optional)
![[IMG]](//proxy.spigotmc.org/c0be42d36fad21c44446203f6c235d77dcf8d30d/68747470733a2f2f692e696d6775722e636f6d2f4b4f58347768782e676966)
Place a sign, look directly at it, and click Create Arena Sign ( OAK_SIGN). Whack Me registers, formats, and waxes the sign. Its state updates automatically, and players can right-click it to join.
Breaking a registered sign requires whackme.sign.break.
Step 11: Register the Arena
Click Register the Arena ( FIREWORK) when setup is complete. Whack Me verifies these required values in order:
If a value is missing, registration stops and names the missing option. On success, the arena becomes ready, starts its waiting runtime, and the success message includes a clickable /wm join <arena> action.
Note: Arena data is saved automatically and during shutdown. If critical saved locations are missing on a later startup, Whack Me automatically marks the arena as not ready instead of starting a broken game.
How to Join:
An arena accepts one player at a time. If occupied, other players must use another arena or wait until the run finishes.
Step 1: Create the Arena
Create a new arena with a unique, stable ID:
Code (Text):
/wm create <arena_id>
Use IDs such as arcade_1 or castle_whack. The ID is reused by join commands, placeholders, setup output, and saved data.
Step 2: Open the Setup Menu
Code (Text):
/wm edit <arena_id>
The home page provides access to locations, portal layout editing, point-block settings, music, display toggles, arena records, signs, and final registration.
Step 3: Set Start and End Locations
Open Manage Arena Locations ( FILLED_MAP). Both locations are required.
Start Location
- Click: Saves your exact position. In the normal layout mode, you must already be surrounded by end portal frames.
- Shift-click: Centers the saved position on the current block and automatically places end portal frames in the eight surrounding positions.
When the plugin detects the surrounding frame ring, those eight blocks become the arena's portal locations automatically.
End Location
- Click: Saves your exact position.
- Shift-click: Centers the position on the current block.
The end location is used after normal finishes, leaves, kicks, cancellations, and reconnect recovery.
Step 4: Define the Portal Layout
Portal locations are the positions from which point blocks rise. Use the automatic eight-frame ring from the start-location action, or click Manage Portal Layout ( ENDER_PEARL) to build a custom layout.
In Portal Editing Mode:
- Your inventory is saved and replaced with end portal frames plus a barrier.
- Place frames to add point-block positions.
- Break frames to remove positions.
- Use the barrier to leave editing mode, save the new list, and restore your inventory.
Note: Registration requires at least one portal location. In practice, use several well-spaced frames so multiple blocks can be visible and reachable at once.
Step 5: Open Point-Block Settings
The Point Block Settings entry unlocks after portal locations exist. It opens a dialog with arena-specific spawning, movement, and appearance controls.
- Minimum active blocks: Default 4, allowed from 1 to the portal count. Lowest target number of simultaneously visible blocks.
- Maximum active blocks: Default 8, allowed from 1 to the portal count. Hard cap on simultaneously visible blocks.
- Vertical movement step: Default 0.05, allowed from 0.01 to 0.20. Distance moved per tick; higher is faster.
- Maximum vertical step: Default 0.64, allowed from 0.01 to 1.00. Safety cap applied to the movement step.
- Peak wait: Default 12 ticks, allowed from 0 to 40. Time the block waits at its highest point.
- Spawn check period: Default 8 ticks, allowed from 1 to 20. Delay between checks that replace missing point blocks.
- Asynchronous movement: Disabled by default. Moves point-block animation outside the main thread; cleanup remains synchronous.
Step 6: Set Active Block Amounts
Choose Active Block Limits to edit the minimum and maximum together. Both are capped by the number of portal locations. If the maximum is set below the minimum, Whack Me raises it to match; changing either value individually also keeps the pair valid.
Tip: More simultaneous blocks increase visual load and decision pressure. Start with 4-8, then test the layout from a player's viewing angle.
Customize Block Appearance (Optional)
Use Customize Point Block Looks to assign the green, red, and gray hit-state items. Put an item on your cursor and click the corresponding preview slot. Blocks, player heads, and custom item metadata are supported, and the saved stack amount is normalized to one.
Step 7: Select Arena Music (Optional)
If NoteBlockAPI is installed, Select Arena Music lists every valid .nbs file in /plugins/WhackMe/musics/.
- Left-click: Select the song for this arena.
- Right-click: Preview the song for yourself.
- No Song: Clear the arena's selection.
Whack Me includes five starter songs and repeats the selected song while a player occupies the arena.
Step 8: Configure Other Settings (Optional)
The Other Arena Settings page controls two independent per-arena options:
- Arena Scoreboard: Enables the live scoreboard for this arena. The global scoreboard-enabled option must also be enabled.
- Arena Boss Bar: Enables the configured timer-progress boss bar for this arena. bossbar.yml must also have enabled: true.
Changes apply immediately if that arena currently has a running game.
Step 9: Reset an Arena Record (Optional)
After an arena has a record, Reset Arena Record shows its holder and score. The confirmation page prevents accidental deletion. Confirming resets only that arena's global holder to None and score to 0; it does not erase player statistics or personal records.
Step 10: Create a Join Sign (Optional)
Place a sign, look directly at it, and click Create Arena Sign ( OAK_SIGN). Whack Me registers, formats, and waxes the sign. Its state updates automatically, and players can right-click it to join.
Breaking a registered sign requires whackme.sign.break.
Step 11: Register the Arena
Click Register the Arena ( FIREWORK) when setup is complete. Whack Me verifies these required values in order:
- Start location
- End location
- At least one portal location
If a value is missing, registration stops and names the missing option. On success, the arena becomes ready, starts its waiting runtime, and the success message includes a clickable /wm join <arena> action.
Note: Arena data is saved automatically and during shutdown. If critical saved locations are missing on a later startup, Whack Me automatically marks the arena as not ready instead of starting a broken game.
How to Join:
- Command: /wm join <arena_id>
- Sign: Right-click the registered arena sign.
An arena accepts one player at a time. If occupied, other players must use another arena or wait until the run finishes.
GAMEPLAY FLOW
- Join an Arena: The player enters a registered, unoccupied arena with /wm join <arena> or by right-clicking its join sign.
- Prepare the Run: Whack Me saves the player's inventory and state, clears temporary statistics, and teleports them to the arena start.
- Follow the Live Displays: The scoreboard, boss bar, action bar, and optional arena music begin as the configured timer starts counting down.
- Whack the Right Blocks: Hit rising green blocks to gain score and build a streak while avoiding red blocks that remove a point and reset the streak.
- Chase a Better Result: Keep accuracy high to improve the success rate, extend the longest streak, complete a perfect run, and beat the personal best.
- Finish the Run: When time expires, Whack Me calculates the final score, hits, success rate, personal record, perfect-run status, and arena record.
- Return Safely: The player's saved state is restored, they are teleported to the end location, and the arena immediately becomes available again.
- Compete Long-Term: Completed results update persistent statistics, the stats menu, PlaceholderAPI values, and global leaderboards.
COMMANDS & PERMISSIONS
All commands can be used via /whackme or /wm.
Spoiler: Player Commands (Everyone)
Gameplay Commands
No permissions required by default.
![[IMG]](//proxy.spigotmc.org/000e7db80eccf13761d011f4a753965e4d27afff/68747470733a2f2f692e696d6775722e636f6d2f74506b477a53552e706e67)
No permissions required by default.
- /wm join <arena>
Join a registered, currently unoccupied arena and immediately start a timed run. - /wm leave
Leave the current game, restore the saved player state, and return to the arena's end location. - /wm stats [player]
Open the statistics menu for yourself or another online/cached offline player.
Spoiler: Arena Management Commands (Click to View)
Arena Setup & Management
Requires whackme.arena.* for full access.
Requires whackme.arena.* for full access.
- /wm create <arena_id>
Permission: whackme.arena.create
Create a new, unconfigured arena with the specified unique ID. - /wm delete <arena_id> [--confirm] [--cancel]
Permission: whackme.arena.delete
Permanently unregister an arena through an explicit confirmation flow. - /wm list
Permission: whackme.arena.list
List every arena and show clickable join actions for ready arenas or setup actions for incomplete arenas. - /wm edit <arena_id>
Permission: whackme.arena.edit
Open the interactive setup menu for an existing arena.
Spoiler: Admin Commands (Click to View)
Main Administration Commands
Requires whackme.admin or the listed node.
![[IMG]](//proxy.spigotmc.org/55810be1b79b9a29f21b639625807066f73c178b/68747470733a2f2f692e696d6775722e636f6d2f67754e68316f7a2e706e67)
Requires whackme.admin or the listed node.
- /wm
Permission: whackme.command.help
Display the installed Whack Me version and author. - /wm help
Permission: whackme.command.help
Display player commands and any administrative commands available to the sender. - /wm reload
Permission: whackme.admin.reload
Reload messages, configuration options, menus, command policy, event profiling, signs, boss bars, sounds, and live game presentation. - /wm stop [arena]
Permission: whackme.admin.stop
Force-stop the current or specified game without applying its run statistics. The console must provide an arena ID. - /wm kick <player>
Permission: whackme.admin.kick
Remove an online player from their current game and follow the normal result and cleanup path. - Break registered arena signs
Permission: whackme.sign.break
Allow staff to break signs registered to Whack Me arenas. - Bypass the replay cooldown
Permission: whackme.cooldown.bypass
Allow a player to join another game without waiting for the configured cooldown. - Bypass in-game command blocking
Permission: whackme.commandblock.bypass
Allow staff to use unrestricted commands while inside a Whack Me arena.
Spoiler: Debug Commands (Advanced Users)
![[IMG]](//proxy.spigotmc.org/df936a72a51c0aea94cec530401d2511979c1bd7/68747470733a2f2f692e696d6775722e636f6d2f425a37596247512e706e67)
Advanced Troubleshooting
Requires whackme.debug or the listed node and debug: true in config.yml.
Requires whackme.debug or the listed node and debug: true in config.yml.
⚠️ Note: Debug commands are intended for testing and troubleshooting.
- /wm debug component <message>
Permission: whackme.debug.component
Preview MiniMessage formatting, gradients, hex colors, and components directly in-game. - /wm debug dump
Permission: whackme.debug.dump
Generate an event timing report for troubleshooting performance issues. Enable event profiling in config.yml for meaningful data.
STATS & LEADERBOARDS
Whack Me rewards players who keep coming back. Track completed games, perfect runs, personal record scores, longest hit streaks, lifetime green and red hits, success rate, and per-arena records—then display the server's top performers through the built-in stats menu and live leaderboards.
PLACEHOLDERS
To use these placeholders, you must have PlaceholderAPI installed on your server.
Spoiler: Server, Player & Statistics Placeholders
Global Plugin Data
%wm_arenas_total% - Total number of registered arenas
%wm_arenas_ready% - Number of arenas that are ready to play
%wm_online_players% - Total players currently inside Whack Me arenas
Live Player Session
Outside an active run, these temporary values normally return 0.
%wm_local_score% - Current score earned during the active run
%wm_local_point_streak% - Current consecutive correct-hit streak
%wm_local_longest_point_streak% - Highest streak reached during the current run
Persistent Player Statistics
%wm_whacked_point_blocks% - Total number of green point blocks hit
%wm_whacked_minus_point_blocks% - Total number of red penalty blocks hit
%wm_whacked_block_rate% - Positive-hit rate as a percentage value
%wm_record_score% - Highest personal score ever reached
%wm_perfect_runs% - Total number of perfect runs completed
%wm_games_played% - Total number of completed games
%wm_tours_played% - Alias for total completed games
%wm_longest_point_streak% - Highest consecutive correct-hit streak
Generic Statistic Lookup
Examples
%wm_stat:games_played%
%wm_stat:longest_hit_streak%
%wm_stat:local_correct_blocks%
%wm_stat:local_wrong_blocks%
Global Plugin Data
Code (Text):
%wm_arenas_total% - Total number of registered arenas
%wm_arenas_ready% - Number of arenas that are ready to play
%wm_online_players% - Total players currently inside Whack Me arenas
Outside an active run, these temporary values normally return 0.
Code (Text):
%wm_local_score% - Current score earned during the active run
%wm_local_point_streak% - Current consecutive correct-hit streak
%wm_local_longest_point_streak% - Highest streak reached during the current run
Code (Text):
%wm_whacked_point_blocks% - Total number of green point blocks hit
%wm_whacked_minus_point_blocks% - Total number of red penalty blocks hit
%wm_whacked_block_rate% - Positive-hit rate as a percentage value
%wm_record_score% - Highest personal score ever reached
%wm_perfect_runs% - Total number of perfect runs completed
%wm_games_played% - Total number of completed games
%wm_tours_played% - Alias for total completed games
%wm_longest_point_streak% - Highest consecutive correct-hit streak
Code (Text):
%wm_stat:<statistic_key>%
Code (Text):
%wm_stat:games_played%
%wm_stat:longest_hit_streak%
%wm_stat:local_correct_blocks%
%wm_stat:local_wrong_blocks%
Spoiler: Arena Status Placeholders
Arena-Specific Syntax
Replace <id> with the exact, case-correct arena identifier.
Arena Settings & Records
%wm_arena:<id>:ready% - Whether the arena is registered and ready
%wm_arena:<id>:record_holder% - Arena record holder
%wm_arena:<id>:record_score% - Highest score recorded in the arena
Live Game Data
%wm_arena:<id>:player_name% - Player currently using the arena
%wm_arena:<id>:point_blocks% - Number of active point blocks
%wm_arena:<id>:state% - Current arena state
%wm_arena:<id>:timer% - Remaining game time in seconds
%wm_arena:<id>:score% - Current score of the active player
Arena-Specific Syntax
Code (Text):
%wm_arena:<arena_id>:<stat>%
Arena Settings & Records
Code (Text):
%wm_arena:<id>:ready% - Whether the arena is registered and ready
%wm_arena:<id>:record_holder% - Arena record holder
%wm_arena:<id>:record_score% - Highest score recorded in the arena
Code (Text):
%wm_arena:<id>:player_name% - Player currently using the arena
%wm_arena:<id>:point_blocks% - Number of active point blocks
%wm_arena:<id>:state% - Current arena state
%wm_arena:<id>:timer% - Remaining game time in seconds
%wm_arena:<id>:score% - Current score of the active player
Spoiler: Leaderboard Placeholders
Leaderboard Syntax
1. Parameters
2. Available Statistics
games_played
perfect_runs
record_score
longest_hit_streak
whacked_plus_blocks
whacked_minus_blocks
3. Usage Examples
# Name of the highest-scoring player
%wm_leaderboard:record_score:1:name%
# Score of the highest-scoring player
%wm_leaderboard:record_score:1:value%
# UUID of the player in 3rd place
%wm_leaderboard:record_score:3:uuid%
# Name of the player with the most perfect runs
%wm_leaderboard:perfect_runs:1:name%
# Value of the 5th longest lifetime streak
%wm_leaderboard:longest_hit_streak:5:value%
Leaderboard entries with a value of
0 are excluded. Empty valid positions return
No Player for names and
0 for values.
Leaderboard Syntax
Code (Text):
%wm_leaderboard:<statistic>:<position>:<name|uuid|value>%
- <statistic>: The persistent statistic to rank.
- <position>: The rank position from 1 through 10.
- <type>: name (username), uuid (unique ID), or value (raw score).
2. Available Statistics
Code (Text):
games_played
perfect_runs
record_score
longest_hit_streak
whacked_plus_blocks
whacked_minus_blocks
Code (Text):
# Name of the highest-scoring player
%wm_leaderboard:record_score:1:name%
# Score of the highest-scoring player
%wm_leaderboard:record_score:1:value%
# UUID of the player in 3rd place
%wm_leaderboard:record_score:3:uuid%
# Name of the player with the most perfect runs
%wm_leaderboard:perfect_runs:1:name%
# Value of the 5th longest lifetime streak
%wm_leaderboard:longest_hit_streak:5:value%
bStats METRICS
This plugin collects anonymous usage statistics through bStats.
This data helps us understand how Whack Me is being used in the wild and helps guide future development. No private information is collected.
Enjoying the plugin?
We spend hundreds of hours making Whack Me the best minigame experience for your server.
If you like the plugin, please consider leaving a 5-star review!
A huge thank you to everyone who has supported the project so far! ❤️
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Whack Me | [1.21.11 - 26.2] is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 11,685 times (via Spigot). Download it and open it directly in the game.