Whack Me Documentation
Whack Me
Section titled “Whack Me”Whack Me is a timed, single-player Minecraft minigame where point blocks rise from a configurable arena layout. Players hit green blocks to score, avoid red penalty blocks, build streaks, and chase both personal and arena records before the timer expires.
Built for server owners who want a polished replayable challenge, Whack Me includes an in-game setup workflow, join signs, per-arena visuals and movement settings, statistics menus, global leaderboards, scoreboards, boss bars, sounds, optional NoteBlockAPI music, PlaceholderAPI placeholders, flat-file or MySQL storage, and a developer event API.
Get Started
Section titled “Get Started” Getting Started Install Whack Me and prepare your server for the first game.
Arena Setup Create a portal layout and configure every arena option step by step.
Gameplay Overview Learn how scoring, streaks, timers, records, and cleanup work.
Features
Section titled “Features” Point Blocks Understand block types, spawning, movement, hit handling, and arena-specific tuning.
Statistics & Records See which values are tracked and how personal, arena, and leaderboard records are calculated.
Arena Music Install NoteBlockAPI, add NBS files, preview songs, and select music per arena.
Commands
Section titled “Commands” Player Commands Join and leave games or inspect online and offline player statistics.
Arena Commands Create, list, edit, and safely delete arenas.
Admin Commands Reload configuration, stop games, kick players, and manage command access.
Debug Commands Preview MiniMessage output and inspect event timing reports.
Configuration Files
Section titled “Configuration Files” config.yml Control gameplay duration, cooldowns, storage, chat, command blocking, and diagnostics.
messages.yml Customize player feedback, results, setup output, and chat text with MiniMessage.
scoreboard.yml Configure the live game scoreboard and its score, timer, streak, and record fields.
bossbar.yml Configure the optional timer-progress boss bar.
signs.yml Customize right-click arena join signs, state labels, and system feedback.
sounds.yml Choose sounds, volume, and pitch for hits, finishes, and new records.
mysql.yml Connect Whack Me to an external database for persistent player statistics.
GUI Menus Customize the setup and player statistics inventory menus.
Other Files Understand automatically managed arena, stat, inventory, and music data.
Placeholders
Section titled “Placeholders” General Placeholders Display totals, live arena data, and persistent or per-run player statistics.
Leaderboard Placeholders Build ranked displays for any supported persistent statistic.
Developer API
Section titled “Developer API” Player Events Control join attempts and observe leaves or statistic updates.
Game Events React to game starts, normal endings, forced stops, and state changes.
Miscellaneous
Section titled “Miscellaneous” FAQ Find quick answers to installation, arena, music, database, and gameplay problems.
Source Code Browse the repository, build the plugin, report issues, or contribute.