Whack Me
一个竞技场。三十秒。刷新个人最佳成绩。
快速回合 · 自定义竞技场 · 持久 rivalry
给玩家一个理由来你的街机厅,并回来再玩一局。
浏览文档 · 构建你的第一个竞技场
将大厅的一角变成一场分数挑战。在大型游戏之间添加一个快速活动。让玩家追逐完美表现并竞争竞技场纪录。Whack Me 为你的 Minecraft 服务器带来了一个单人打地鼠迷你游戏。
玩家进入竞技场,在时间耗尽前击打绿色方块并避开红色方块。默认回合持续三十秒;时长、竞技场布局、显示方式和奖励均由你配置。
易于上手,难以放下。
绿色代表继续。 每次正确击中都会加分并累积连击。红色代表三思。 错误击中会扣分但不会使分数低于零,并重置当前连击。
点块从竞技场的传送门位置升起、暂停然后落下。击中后,方块变为灰色的已击中状态,因此同一目标不能重复得分。方块选择器在出现新方块时平衡绿色和红色目标。
通过可配置的记分板、Boss 栏和操作栏跟踪剩余时间、分数和连击。结束时,查看你的正确和错误击中次数、准确率、最长连击和个人最佳成绩,然后尝试超越该结果。
实时运行:紧凑的挑战,视野中显示你的分数和剩余时间。
结果摘要将分数、连击和准确率汇总在一起。
你的空间。你的布局。
使用 /wm create arcade_1 创建竞技场,然后打开 /wm edit arcade_1。游戏内设置菜单引导你完成位置、传送门位置、方块设置、音乐、显示和注册的配置。
从框架环开始。 shift+点击起始位置操作以居中玩家位置并放置八个周围的传送门框架。保存一个结束位置供玩家从运行返回时使用。
或者制作自定义布局。 使用传送门编辑器添加和移除生成位置。构建适合房间且从起始位置可见且可达的布局。
让玩家走上前去游玩。 注册一个竞技场加入告示牌或使用 /wm join <arena>。每个竞技场同时只容纳一名玩家;多个竞技场让玩家各自进行自己的运行。
完整的竞技场设置教程
### **步骤 1:创建竞技场**
使用唯一且稳定的 ID 创建新竞技场:
/wm create <arena_id>
使用诸如 arcade_1 或 castle_whack 之类的 ID。ID 将被加入命令、占位符、设置输出和保存的数据复用。
步骤 2:打开设置菜单
/wm edit <arena_id>
主页提供对位置、传送门布局编辑、点块设置、音乐、显示切换、竞技场记录、告示牌和最终注册的访问。
步骤 3:设置起始和结束位置
打开 管理竞技场位置 (FILLED_MAP)。两个位置都是必需的。
起始位置
- 点击: 保存你的确切位置。在正常布局模式下,你必须已经被末地传送门框架包围。
- Shift+点击: 将保存的位置居中于当前方块,并自动在周围八个位置放置末地传送门框架。
当插件检测到周围的框架环时,这八个方块会自动成为竞技场的传送门位置。
结束位置
- 点击: 保存你的确切位置。
- Shift+点击: 将位置居中于当前方块。
结束位置用于正常结束、离开、踢出、取消和重连恢复之后。
步骤 4:定义传送门布局
传送门位置是点块升起的位置。可以使用来自起始位置操作的自动八框环,或者点击 管理传送门布局 (ENDER_PEARL) 来构建自定义布局。
在传送门编辑模式中:
- 你的物品栏被保存并替换为末地传送门框架和一个屏障方块。
- 放置框架以添加点块位置。
- 破坏框架以移除位置。
- 使用屏障方块退出编辑模式,保存新列表并恢复你的物品栏。
注意: 注册至少需要一个传送门位置。实际上,请使用几个间距良好的框架,以便一次可见且可达多个方块。
步骤 5:打开点块设置
点块设置条目在存在传送门位置后解锁。它打开一个包含竞技场特定生成、移动和外观控制的对话框。
- 最小活跃方块数: 默认 4,允许范围 1 到传送门数量。同时可见的目标最少数量。
- 最大活跃方块数: 默认 8,允许范围 1 到传送门数量。同时可见方块数的硬上限。
- 垂直移动步长: 默认 0.05,允许范围 0.01 到 0.20。每刻移动的距离;越高越快。
- 最大垂直步长: 默认 0.64,允许范围 0.01 到 1.00。应用于移动步长的安全上限。
- 峰值等待: 默认 12 刻,允许范围 0 到 40。方块在其最高点等待的时间。
- 生成检查周期: 默认 8 刻,允许范围 1 到 20。替换缺失点块之间的延迟。
- 异步移动: 默认禁用。将点块动画移至主线程之外;清理保持同步。
步骤 6:设置活跃方块数量
选择 活跃方块上限 可同时编辑最小值和最大值。两者均受传送门位置数量的限制。如果最大值低于最小值,Whack Me 会自动将其提升至与最小值一致;单独修改任一数值也会确保这对数值保持有效。
提示: 同时显示的方块越多,视觉负担和决策压力就越大。建议从 4-8 开始,然后以玩家的视角测试布局效果。
自定义方块外观(可选)
使用 自定义目标方块外观 来分配绿色、红色和灰色命中状态的物品。将物品置于光标上,然后点击对应的预览槽位。支持方块、玩家头颅以及自定义物品元数据,保存的物品堆叠数量会被标准化为 1。
步骤 7:选择竞技场音乐(可选)
如果已安装 NoteBlockAPI,选择竞技场音乐 会列出 /plugins/WhackMe/musics/ 目录下所有有效的 .nbs 文件。
- 左键点击: 为该竞技场选择曲目。
- 右键点击: 为自己预览该曲目。
- 无歌曲: 清除竞技场的音乐选择。
Whack Me 内置了五首起始曲目,并在玩家占用竞技场时循环播放所选曲目。
步骤 8:配置其他设置(可选)
其他竞技场设置 页面控制两个独立的单竞技场选项:
- 竞技场计分板: 启用该竞技场的实时计分板。全局的 scoreboard-enabled 选项也必须处于启用状态。
- 竞技场 Boss 条: 启用该竞技场配置的计时进度 Boss 条。bossbar.yml 中也必须设置 enabled: true。
如果该竞技场当前正在进行游戏,更改将立即生效。
步骤 9:重置竞技场记录(可选)
当竞技场产生记录后,重置竞技场记录 会显示其持有者和分数。确认页面可防止误删。确认后,仅将该竞技场的全球持有者重置为 None,分数重置为 0;不会删除玩家统计数据或个人记录。
步骤 10:创建加入告示牌(可选)
放置一个告示牌,直视它并点击 创建竞技场告示牌 (OAK_SIGN)。Whack Me 会注册、格式化并打蜡该告示牌。其状态会自动更新,玩家可以右键点击它来加入。
破坏已注册的告示牌需要权限 whackme.sign.break。
步骤 11:注册竞技场
设置完成后,点击 注册竞技场 (FIREWORK)。Whack Me 会按顺序验证以下必填项:
如果缺少任何一项,注册将停止并指出缺失的选项。成功时,竞技场变为就绪状态,启动等待运行时,并且成功消息中包含一个可点击的 /wm join <arena> 操作链接。
注意: 竞技场数据会在自动保存及服务器关闭时保存。如果在后续启动时发现关键保存的位置丢失,Whack Me 会自动标记该竞技场为“未就绪”,而不是启动一个损坏的游戏。
如何加入:
- 命令: /wm join <arena_id>
- 告示牌: 右键点击已注册的竞技场告示牌。
竞技场一次只接受一名玩家。如果被占用,其他玩家必须使用其他竞技场或等待本轮运行结束。
阅读竞技场设置指南
掌控节奏,彰显风格。
控制压力。 设置每个竞技场可见方块的最小/最大数量、移动速度、峰值等待时间和生成检查周期。无论是轻松的大厅活动还是繁忙的街机挑战,均可沿用相同的游戏规则。
选择目标。 为绿色、红色和灰色命中状态分配方块物品、玩家头颅或自定义物品。外观编辑器保留物品元数据,使目标符合服务器的主题风格。
营造氛围。 借助 NoteBlockAPI,选择竞技场的 .nbs 歌曲,在游戏中预览,或将自己的歌曲添加到 plugins/WhackMe/musics/ 中。插件捆绑了五首起始曲目。
打造专属展示。 通过 YAML 文件编辑消息、音效、菜单、告示牌、计分板和 Boss 条。可按竞技场开启或关闭计分板和 Boss 条,并使用 /wm reload 重载展示更改。
保持专注。 竞技场保护功能阻止建造、丢弃物品、切换、拾取和玩家伤害。配置聊天隔离、允许的命令、离开命令拦截以及回放冷却时间,以适应你的服务器需求。
探索目标方块设置 · 查看主配置文件
今日的个人最佳,明日的服务器纪录。
追踪 游戏次数、完美通关、个人最高分、最长连击、终身绿色/红色命中数,以及各竞技场的最佳成绩。玩家可以使用 /wm stats [player] 查看自己的进度或其他玩家的统计数据。
玩家统计数据让每一轮的进步得以延续。
将服务器最出色的成绩公开展示。
内置排行榜对分数、完美通关、连击、游戏次数和终身命中进行排名。PlaceholderAPI 可将这些排名整合到兼容的水晶球、计分板和菜单中。设置 leaderboard-size 可选择展示的排名位数。
对于简单的本地设置,可使用 flat-file storage(扁平文件存储);对于基于数据库的玩家统计数据,请使用 MySQL。竞技场记录仍作为已保存的竞技场数据的一部分。
了解统计数据和记录
奖励精彩时刻,展示成长历程。
执行你选择的奖励。 配置控制台命令或玩家命令,用于加入、退出、完成游戏以及击中绿色、红色或灰色方块。在 rewards.yml 中使用玩家、竞技场、分数、计时器、连击和命中次数占位符。奖励是可选的,命令列表默认为空。
奖励触发器与简单示例
- **game-join:** 玩家开始一轮游戏。
- **game-quit:** 玩家提前离开或断开连接。
- **game-end:** 回合正常结束。
- **green-block-step / red-block-step / gray-block-step:** 对应颜色的方块被击中。
默认情况下,命令以控制台身份运行。在命令前加上 p: 可以以玩家身份运行。
game-end:
- 'tell %player% You finished %arena% with %score% points!'
支持的占位符: %player%, %uuid%, %arena%, %timer%, %score%, %hit-streak%, %max-streak%, %green-blocks%, %red-blocks% 和 %block-type%。
在任何地方显示数据。 安装 PlaceholderAPI 后,可以在其他兼容插件中显示玩家的实时分数、终身统计数据、竞技场状态和排行榜位置。Whack Me 会自动注册其扩展。
服务器、玩家与统计占位符
**全局插件数据**
%wm_arenas_total% - 已注册的竞技场总数
%wm_arenas_ready% - 准备好可玩的竞技场数量
%wm_online_players% - 当前处于 Whack Me 竞技场中的玩家总数
实时玩家会话
在非活跃游戏期间,这些临时值通常返回 0。
%wm_local_score% - 当前游戏中获得的分数
%wm_local_point_streak% - 当前连续正确击中的连击数
%wm_local_longest_point_streak% - 当前游戏中达到的最高连击数
持久化玩家统计数据
%wm_whacked_point_blocks% - 击中的绿色加分方块总数
%wm_whacked_minus_point_blocks% - 击中的红色惩罚方块总数
%wm_whacked_block_rate% - 正命中率(百分比)
%wm_record_score% - 历史最高个人分数
%wm_perfect_runs% - 完成的完美局数
%wm_games_played% - 完成的总游戏局数
%wm_tours_played% - 已完成总局数的别名
%wm_longest_point_streak% - 历史最高连续正确击中连击数
通用统计查询
%wm_stat:<statistic_key>%
示例
%wm_stat:games_played%
%wm_stat:longest_hit_streak%
%wm_stat:local_correct_blocks%
%wm_stat:local_wrong_blocks%
竞技场状态占位符
**竞技场特定语法**
%wm_arena:<arena_id>:<stat>%
将 <id> 替换为竞技场标识符(匹配时不区分大小写)。
竞技场设置与记录
%wm_arena:<id>:ready% - 竞技场是否已注册并准备就绪
%wm_arena:<id>:record_holder% - 竞技场记录保持者
%wm_arena:<id>:record_score% - 该竞技场中的最高记录分数
实时游戏数据
%wm_arena:<id>:player_name% - 当前正在使用该竞技场的玩家
%wm_arena:<id>:point_blocks% - 活跃的加分方块数量
%wm_arena:<id>:state% - 当前竞技场状态
%wm_arena:<id>:timer% - 剩余游戏时间(秒)
%wm_arena:<id>:score% - 当前玩家的分数
排行榜占位符
**排行榜语法**
%wm_leaderboard:<statistic>:<position>:<name|uuid|value>%
1. 参数
- <statistic>: 用于排名的持久化统计数据。
- <position>: 排名位置,范围从 1 到配置的 leaderboard-size(默认:10)。
- <type>: name(用户名)、uuid(唯一 ID)或 value(原始分数)。
2. 可用统计数据
games_played
perfect_runs
record_score
longest_hit_streak
whacked_plus_blocks
whacked_minus_blocks
3. 使用示例
# 得分最高的玩家姓名
%wm_leaderboard:record_score:1:name%
# 得分最高的玩家分数
%wm_leaderboard:record_score:1:value%
# 排名第 3 的玩家 UUID
%wm_leaderboard:record_score:3:uuid%
# 完美局数最多的玩家姓名
%wm_leaderboard:perfect_runs:1:name%
# 第 5 长的终身连击数数值
%wm_leaderboard:longest_hit_streak:5:value%
值为 0 的排行榜条目将被排除。空的合法位置对于名称返回 No Player,对于数值返回 0。
基于公共 API 进行构建。 通过 Bukkit 事件响应游戏开始和结束、状态更改、加入尝试、离开以及统计数据变化。无需编辑 Whack Me 即可将你自己的插件挂钩到同一轮游戏中。
Reward configuration · Placeholder reference · Javadocs
简洁的玩家流程。清晰的员工控制。
使用 /wm 或 /whackme 执行所有命令。玩家可以加入、离开并查看统计数据;工作人员可以通过以下权限创建、编辑、列出、停止和管理竞技场。
玩家命令(所有人)
**游戏命令**
*默认不需要任何权限。*
-
/wm join <arena>
[INDENT]加入一个已注册且当前空闲的竞技场,并立即开始限时游戏。[/INDENT]
-
/wm leave
[INDENT]离开当前游戏,恢复保存的玩家状态,并返回竞技场的终点位置。[/INDENT]
-
/wm stats [玩家]
[INDENT]打开你自己或另一个在线/缓存的离线玩家的统计菜单。[/INDENT]
竞技场管理命令(点击查看)
**竞技场设置与管理**
*需要 whackme.arena 权限以获取完整访问权限。*
-
/wm create <竞技场ID>
[INDENT]权限:whackme.arena.create[/INDENT]
[INDENT]使用指定的唯一 ID 创建一个全新的、未配置的竞技场。[/INDENT]
-
/wm delete <竞技场ID> [--confirm] [--cancel]
[INDENT]权限:whackme.arena.delete[/INDENT]
[INDENT]通过明确的确认流程永久注销一个竞技场。[/INDENT]
-
/wm list
[INDENT]权限:whackme.arena.list[/INDENT]
[INDENT]列出所有竞技场,并为已就绪的竞技场显示可点击的加入操作,为不完整的竞技场显示设置操作。[/INDENT]
-
/wm edit <竞技场ID>
[INDENT]权限:whackme.arena.edit[/INDENT]
[INDENT]打开现有竞技场的交互式设置菜单。[/INDENT]
管理员命令(点击查看)
**主要管理命令**
*需要列出的权限;whackme.admin 包含这些管理命令。*
-
/wm
[INDENT]无需权限。[/INDENT]
[INDENT]显示已安装的 Whack Me 版本和作者信息。[/INDENT]
-
/wm help
[INDENT]权限:whackme.command.help[/INDENT]
[INDENT]显示玩家可用的命令以及发送者具备管理权限的命令。[/INDENT]
-
/wm reload
[INDENT]权限:whackme.admin.reload[/INDENT]
[INDENT]重新加载消息、配置选项、菜单、命令策略、事件分析、告示牌、Boss 栏、音效、奖励以及实时游戏展示内容。[/INDENT]
-
/wm stop [arena]
[INDENT]权限:whackme.admin.stop[/INDENT]
[INDENT]强制停止当前或指定的游戏,且不应用其运行统计数据。控制台必须提供竞技场 ID。[/INDENT]
-
/wm kick <player>
[INDENT]权限:whackme.admin.kick[/INDENT]
[INDENT]将在线玩家从其当前游戏中移除,并执行正常的结算与清理流程。[/INDENT]
-
破坏已注册的竞技场告示牌
[INDENT]权限:whackme.sign.break[/INDENT]
[INDENT]允许工作人员破坏已注册到 Whack Me 竞技场的告示牌。[/INDENT]
-
绕过重玩冷却时间
[INDENT]权限:whackme.cooldown.bypass[/INDENT]
[INDENT]允许玩家在无需等待配置的冷却时间的情况下加入其他游戏。[/INDENT]
-
绕过游戏内命令拦截
[INDENT]权限:whackme.commandblock.bypass[/INDENT]
[INDENT]允许工作人员在 Whack Me 竞技场内部使用不受限制的命令。[/INDENT]
调试命令(高级用户)
高级故障排除
需要 whackme.debug 权限或列出节点,并在 config.yml 中设置 debug: true。
⚠️ 注意: 调试命令仅用于测试和故障排除。
-
/wm debug component <message>
[INDENT]权限:whackme.debug.component[/INDENT]
[INDENT]直接在游戏内预览 MiniMessage 格式、渐变、十六进制颜色和组件。[/INDENT]
-
/wm debug dump
[INDENT]权限:whackme.debug.dump[/INDENT]
[INDENT]生成事件计时报告以排查性能问题。在 config.yml 中启用事件分析以获取有意义的数据。[/INDENT]
玩家命令参考 · 管理员参考
安装。配置。追逐高分。
要求: Java 25 和 兼容 Paper 的 Minecraft 服务器。PlaceholderAPI 和 NoteBlockAPI 为可选集成。
- 将 Whack Me JAR 文件放入服务器的 plugins 文件夹并重启。
- 运行 /wm create arcade_1 和 /wm edit arcade_1。
- 保存起点和终点位置,添加传送门位置并注册竞技场。
- 运行 /wm join arcade_1 或右键点击其加入告示牌进行游戏。
玩家库存会在游戏开始前保存,并在结束后恢复。断线玩家在返回时将恢复其保存的库存。竞技场数据会自动保存并在关闭时保存;未完整保存的竞技场在启动时会被标记为不可用。
配置文件一览
- **config.yml:** 游戏时长、重播冷却时间、存储、聊天和命令策略。
- **arenas.yml:** 竞技场位置、传送门布局、设置、告示牌、歌曲和记录。
- **rewards.yml:** 可选的命令奖励及其占位符。
- **messages.yml / sounds.yml:** 消息、格式和声音选择。
- **scoreboard.yml / bossbar.yml / signs.yml:** 实时显示和加入告示牌的格式。
- **menu/:** 设置和统计菜单布局。
- **mysql.yml:** 选择 MySQL 时的数据库连接设置。
- **musics/:** 内置和自定义的 NoteBlockAPI 歌曲。
打开安装指南
帮助塑造下一个更新。
Whack Me 通过 bStats 收集匿名使用统计信息。这些聚合统计数据有助于展示插件的使用情况并指导未来的开发。
你的下一个个人最佳成绩始于再玩一次。
由 Despical 创建。喜欢 Whack Me?请在评论中分享你的体验。
文档 · 源代码 · Discord 支持
Turn a corner of your lobby into a score challenge. Add a quick activity between larger games. Let players chase a perfect run and compete for the arena record. Whack Me brings a single-player whack-a-block minigame to your Minecraft server.
Players enter an arena, hit the green blocks and avoid the red ones before time runs out. The default round lasts thirty seconds; the duration, arena layout, displays and rewards are yours to configure.
Easy to start. Hard to put down.
Green means go. Every correct hit adds a point and builds your streak. Red means rethink. A wrong hit removes a point without taking the score below zero, and resets your current streak.
Point blocks rise, pause and fall from the arena's portal positions. A hit turns the block into its gray hit state, so the same target cannot award points twice. The block selector balances green and red targets as new blocks appear.
Follow the remaining time, score and streak through configurable scoreboards, boss bars and action bars. At the end, see your correct and incorrect hits, accuracy, longest streak and personal best, then try to beat the result.
The live run: a compact challenge with your score and remaining time in view.
The result summary brings the score, streak and accuracy together.
Your space. Your layout.
Create an arena with /wm create arcade_1, then open /wm edit arcade_1. The in-game setup menu takes you through locations, portal positions, block settings, music, displays and registration.
Set up and manage an arena through the in-game menu.
Start with a frame ring. Shift-click the start-location action to center the player position and place eight surrounding portal frames. Save an end location for players returning from the run.
Or make a custom layout. Use the portal editor to add and remove spawn positions. Build a layout that suits the room and keeps targets visible and reachable from the start position.
Let players walk up and play. Register an arena join sign or use /wm join <arena>. Each arena hosts one player at a time; multiple arenas let players take their own runs.
The complete arena setup walkthrough
### **Step 1: Create the Arena**
Create a new arena with a unique, stable ID:
/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
/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.
Read the arena setup guide
Tune the pace. Keep your style.
Control the pressure. Set the minimum and maximum visible blocks, movement speed, peak wait and spawn-check period for each arena. Use a relaxed lobby activity or a busier arcade challenge with the same gameplay rules.
Choose the targets. Assign block items, player heads or custom items to the green, red and gray hit states. The appearance editor keeps item metadata, letting the targets fit your server's theme.
Bring the atmosphere. With NoteBlockAPI, select an arena's .nbs song, preview it in game or add your own songs to plugins/WhackMe/musics/. Five starter songs are bundled with the plugin.
Make the displays yours. Edit messages, sounds, menus, signs, scoreboards and boss bars through YAML files. Turn the scoreboard and boss bar on or off per arena, and reload presentation changes with /wm reload.
Keep the run focused. Arena protections block building, item dropping, swapping, pickups and player damage. Configure chat isolation, allowed commands, leave-command blocking and the replay cooldown to suit your server.
Explore point-block settings · View the main configuration
A personal best today. A server record tomorrow.
Track games played, perfect runs, personal record scores, longest hit streaks, lifetime green and red hits, and per-arena best scores. Players can inspect their own progress or another player's statistics with /wm stats [player].
Player statistics keep the progress from one run to the next.
Put your server's strongest results on display.
The built-in leaderboards rank scores, perfect runs, streaks, games played and lifetime hits. PlaceholderAPI lets you bring those rankings into compatible holograms, scoreboards and menus. Set leaderboard-size to choose how many positions are available.
Use flat-file storage for a simple local setup or MySQL for database-backed player statistics. Arena records remain part of the saved arena data.
Read about statistics and records
Reward the moment. Show the progress.
Run the rewards you choose. Configure console commands or player commands for joining, quitting, finishing a game and hitting green, red or gray blocks. Use player, arena, score, timer, streak and hit-count placeholders in rewards.yml. Rewards are optional and the command lists start empty.
Reward triggers and a simple example
- **game-join:** the player starts a run.
- **game-quit:** the player leaves early or disconnects.
- **game-end:** the round reaches its normal end.
- **green-block-step / red-block-step / gray-block-step:** the matching block is hit.
Commands run as console by default. Prefix a command with p: to run it as the player.
game-end:
- 'tell %player% You finished %arena% with %score% points!'
Supported placeholders: %player%, %uuid%, %arena%, %timer%, %score%, %hit-streak%, %max-streak%, %green-blocks%, %red-blocks% and %block-type%.
Display the data anywhere. With PlaceholderAPI installed, show a player's live score, lifetime statistics, arena status and leaderboard positions in other compatible plugins. Whack Me registers its expansion automatically.
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
%wm_stat:<statistic_key>%
Examples
%wm_stat:games_played%
%wm_stat:longest_hit_streak%
%wm_stat:local_correct_blocks%
%wm_stat:local_wrong_blocks%
Arena Status Placeholders
**Arena-Specific Syntax**
%wm_arena:<arena_id>:<stat>%
Replace <id> with the arena identifier (matching is case-insensitive).
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
Leaderboard Placeholders
**Leaderboard Syntax**
%wm_leaderboard:<statistic>:<position>:<name|uuid|value>%
1. Parameters
- <statistic>: The persistent statistic to rank.
- <position>: The rank position from 1 through the configured leaderboard-size (default: 10).
- <type>: name (username), uuid (unique ID), or value (raw score).
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.
Build on the public API. React to game starts and finishes, state changes, join attempts, departures and statistic changes through Bukkit events. Hook your own plugin into the same run without editing Whack Me.
Reward configuration · Placeholder reference · Javadocs
A short player flow. Clear controls for staff.
Use /wm or /whackme for every command. Players can join, leave and open statistics; staff can create, edit, list, stop and manage arenas through the permissions below.
Player Commands (Everyone)
**Gameplay Commands**
*No permissions required by default.*
-
/wm join <arena>
[INDENT]Join a registered, currently unoccupied arena and immediately start a timed run.[/INDENT]
-
/wm leave
[INDENT]Leave the current game, restore the saved player state, and return to the arena's end location.[/INDENT]
-
/wm stats [player]
[INDENT]Open the statistics menu for yourself or another online/cached offline player.[/INDENT]
Arena Management Commands (Click to View)
**Arena Setup & Management**
*Requires whackme.arena.* for full access.*
-
/wm create <arena_id>
[INDENT]Permission: whackme.arena.create[/INDENT]
[INDENT]Create a new, unconfigured arena with the specified unique ID.[/INDENT]
-
/wm delete <arena_id> [--confirm] [--cancel]
[INDENT]Permission: whackme.arena.delete[/INDENT]
[INDENT]Permanently unregister an arena through an explicit confirmation flow.[/INDENT]
-
/wm list
[INDENT]Permission: whackme.arena.list[/INDENT]
[INDENT]List every arena and show clickable join actions for ready arenas or setup actions for incomplete arenas.[/INDENT]
-
/wm edit <arena_id>
[INDENT]Permission: whackme.arena.edit[/INDENT]
[INDENT]Open the interactive setup menu for an existing arena.[/INDENT]
Admin Commands (Click to View)
**Main Administration Commands**
*Requires the listed permission; whackme.admin includes the administration commands.*
-
/wm
[INDENT]No permission required.[/INDENT]
[INDENT]Display the installed Whack Me version and author.[/INDENT]
-
/wm help
[INDENT]Permission: whackme.command.help[/INDENT]
[INDENT]Display player commands and any administrative commands available to the sender.[/INDENT]
-
/wm reload
[INDENT]Permission: whackme.admin.reload[/INDENT]
[INDENT]Reload messages, configuration options, menus, command policy, event profiling, signs, boss bars, sounds, rewards, and live game presentation.[/INDENT]
-
/wm stop [arena]
[INDENT]Permission: whackme.admin.stop[/INDENT]
[INDENT]Force-stop the current or specified game without applying its run statistics. The console must provide an arena ID.[/INDENT]
-
/wm kick <player>
[INDENT]Permission: whackme.admin.kick[/INDENT]
[INDENT]Remove an online player from their current game and follow the normal result and cleanup path.[/INDENT]
-
Break registered arena signs
[INDENT]Permission: whackme.sign.break[/INDENT]
[INDENT]Allow staff to break signs registered to Whack Me arenas.[/INDENT]
-
Bypass the replay cooldown
[INDENT]Permission: whackme.cooldown.bypass[/INDENT]
[INDENT]Allow a player to join another game without waiting for the configured cooldown.[/INDENT]
-
Bypass in-game command blocking
[INDENT]Permission: whackme.commandblock.bypass[/INDENT]
[INDENT]Allow staff to use unrestricted commands while inside a Whack Me arena.[/INDENT]
Debug Commands (Advanced Users)
Advanced Troubleshooting
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>
[INDENT]Permission: whackme.debug.component[/INDENT]
[INDENT]Preview MiniMessage formatting, gradients, hex colors, and components directly in-game.[/INDENT]
-
/wm debug dump
[INDENT]Permission: whackme.debug.dump[/INDENT]
[INDENT]Generate an event timing report for troubleshooting performance issues. Enable event profiling in config.yml for meaningful data.[/INDENT]
Player command reference · Administration reference
Install. Set up. Chase the score.
Requirements: Java 25 and a Paper-compatible Minecraft server. PlaceholderAPI and NoteBlockAPI are optional integrations.
- Place the Whack Me JAR in your server's plugins folder and restart.
- Run /wm create arcade_1 and /wm edit arcade_1.
- Save the start and end locations, add portal positions and register the arena.
- Run /wm join arcade_1 or right-click its join sign to play.
Player inventories are saved before the run and restored when it ends. Disconnecting players recover their saved inventory when they return. Arena data is saved automatically and during shutdown; incomplete saved arenas are marked not ready at startup.
Configuration files at a glance
- **config.yml:** gameplay duration, replay cooldown, storage, chat and command policy.
- **arenas.yml:** arena locations, portal layouts, settings, signs, songs and records.
- **rewards.yml:** optional command rewards and their placeholders.
- **messages.yml / sounds.yml:** messages, formatting and sound choices.
- **scoreboard.yml / bossbar.yml / signs.yml:** live displays and join-sign formatting.
- **menu/:** setup and statistics menu layouts.
- **mysql.yml:** database connection settings when MySQL is selected.
- **musics/:** bundled and custom NoteBlockAPI songs.
Open the installation guide
Help shape the next update.
Whack Me collects anonymous usage statistics through bStats. These aggregate statistics help show how the plugin is used and guide future development.
Your next personal best starts with one more run.
Created by Despical. Enjoying Whack Me? Share your experience in a review.
Documentation · Source code · Discord support
评论 0
登录后参与评分
还没有评论,来抢沙发吧