HeadBlocks MINI-GAMES - HeadBlocks免费版

概述

HeadBlocks 是一款能让玩家在忙碌中享受乐趣的插件。玩法很简单：你可以在世界中隐藏一定数量的头颅，玩家需要找到它们以获得丰厚奖励。最常见的用途是复活节或圣诞节的“寻头”活动！

💡功能特性

• 易于使用：配置简单，上手快速。
• 无数量限制：可放置的头颅数量没有上限。
• 丰富的交互：
• 点击头颅或根据收集等级执行命令。
• 支持使用 HeadDatabase 的多种头颅和材质。
• 点击时可播放自定义音效。
• 点击后可发送多行、居中的消息。
• 可在头颅位置生成完全自定义颜色和样式的烟花或爆炸效果。
• 可向玩家发送完全自定义的标题（Title）。
• 可为已找到和未找到的头颅添加粒子效果。
• 多场景支持：
• 可用于大厅、单个服务器，甚至多个服务器（需配合 Redis）。
• 玩家数据可存储在 SQLite 或 MySQL 中。
• 高度可定制：
• 所有文本均可翻译。
• 提供开发者 API。
• 包含多种占位符（详见下文）。
• 配置可自动更新。
• 支持 Minecraft 1.16+ 的颜色代码。
• 可在头颅上方显示全息文字（支持占位符）。
• 头颅管理：
• 可设置头颅的点击顺序或最大点击次数。
• 已获得的头颅可被“推开”（无法再次互动）。
• 支持头颅旋转模式（可同时旋转或静止）。
• 新功能：
• 提示系统：可通过行动栏（ActionBar）或音效给予玩家寻找提示。
• 独立奖励：可为每个头颅单独设置奖励（命令、全服广播、消息）。
• 隐藏已找到的头颅：使用 PacketEvents 在玩家找到头颅后将其隐藏。

> 请注意：如果你使用分级奖励（tiered rewards），请确保从一开始就正确设置。目前无法为已到达的等级重新分配奖励！

❓配置与文件

• config.yml：插件主配置文件。
• language/：语言文件夹，包含翻译文件（当前提供英文 en 和法文 fr）。
• headblocks.db：SQLite 数据库文件，用于存储玩家数据（如果使用 MySQL 则不使用此文件）。
• locations.yml：记录所有头颅位置的文件。

🎮命令列表

• /headblocks progress <player>：显示玩家的寻找进度（可在 config.yml 中自定义进度条样式）。
• /headblocks give <player>：给予玩家一个特殊头颅。放置后，该头颅将成为可点击的（每个玩家限一次）。
• /headblocks remove <headUuid>：通过 UUID 移除已生成的头颅。
• /headblocks removeall：移除所有已生成的头颅。
• /headblocks reset <player>：重置指定玩家的所有数据。
• /headblocks resetall：重置所有玩家的数据。
• /headblocks list：在聊天栏显示所有头颅及其位置的列表。
• /headblocks rename <name>：重命名一个头颅（用于在 GUI、统计和聊天中显示）。
• /headblocks stats <player>：在聊天栏显示玩家已找到和未找到的头颅列表。
• /headblocks top <limit>：在聊天栏显示玩家排行榜。
• /headblocks move：移动一个已存在的头颅，同时保留其玩家数据。
• /headblocks export：将 HeadBlocks 数据库导出到另一个数据库。
• /headblocks options：打开一个用于设置点击顺序或最大点击次数的 GUI。
• /headblocks reload：重载插件配置。
• /headblocks version：显示插件版本。
• /headblocks help：显示帮助信息。

🔧权限节点

• headblocks.use：允许玩家与头颅互动。
• headblocks.commands.top：允许使用 /headblocks top 命令。
• headblocks.commands.progress：允许使用 /headblocks progress 命令查看自己的进度。
• headblocks.commands.progress.other：允许查看其他玩家的进度。
• headblocks.admin：允许使用所有管理员命令（默认 OP 拥有此权限）。

依赖需求

• 如需使用占位符，你需要安装 PlaceholderAPI。
• 如需使用 HeadDatabase 中的头颅，你需要安装 HeadDatabase。

✨占位符

• %headblocks_current%：返回玩家已找到的头颅数量。
• %headblocks_max%：返回世界中放置的头颅总数。
• %headblocks_left%：返回玩家尚未找到的头颅数量。
• %headblocks_hasHead_<headUUID | headName>%：返回玩家是否已找到某个特定头颅（返回原始值 True 或 False）。
• %headblocks_order_previous%：如果设置了顺序，显示上一个已找到的头颅序号（返回整数，若无法计算则返回 "-"）。
• %headblocks_order_current%：如果设置了顺序，显示当前应寻找的头颅序号（返回整数，若无法计算则返回 "-"）。
• `%headblocks_order_next%：如果设置了顺序，显示下一个要寻找的头颅序号（返回整数，若无法计算则返回 "-"）。
• %headblocks_leaderboard_<position>_<name|custom|value>%：用于构建排行榜（custom 的具体含义请查看配置文件）。

⭐开发者 API

• HeadClickEvent：当玩家点击头颅时触发。
• HeadCreatedEvent：当创建一个新头颅时调用。
• HeadDeletedEvent：当删除一个头颅时触发。

源代码仓库位于 Github！

💡问题与支持

发现漏洞或有建议？欢迎在 Github Issue 提交问题或参与讨论！

插件可能尚不完美，在给出评价前，如果需要帮助或遇到错误，请随时联系我！

本插件的完整源代码已在 GitHub 上开源。

已知问题

• （暂无已知问题列出）

特别感谢

• Minecraft-heads：提供大量头颅材质选择。
• Item-NBT-API：用于头颅相关的数据管理。
• Config-Updater：实现配置自动更新。
• XSound (来自 XSeries)：用于播放音效。
• Stress-test：由 Just2Craft 完成。

Made with ❤️

💡文档

本插件的完整文档和最新信息，请访问其官方 Wiki 页面。

• Wiki 地址：https://github.com/YouHaveTrouble/minecraft-optimization/wiki