Whack Me

插件

· 作者 Despical

《Whack Me》是一款快节奏的 Minecraft 反应小游戏,玩家需要在限定时间内击打绿色方块、避开红色方块,并建立连击以创造高分。

0 本站下载 0 关注 更新于 1 周前

最新 2.0.4 · 26.3 · Paper / Purpur

一键开服(送7天)

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 支持

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源