# 概述：
HeadBlocks 是一款插件，旨在让您的玩家在享受乐趣的同时保持活跃。 其目标很简单，您在世界中隐藏一定数量的头颅，而您的玩家需要找到这些头颅以获得许多奖励。 最常见的用途是在复活节或圣诞节进行头颅狩猎！
    
# 功能：
- 非常容易使用
- 没有头颅数量限制
- 执行点击或达到关卡时的命令
- 多个头颅和多个纹理（支持HeadDatabase）
- 自定义点击时的声音
- 点击时发送多行居中消息
- 在头颅处自定义烟花或爆炸，具有任意颜色
- 向玩家发送完全可定制的标题
- 在已找到和未找到的头颅上添加粒子（1.13+）
- 可用于大厅、单个服务器，甚至可以同时在多个服务器上使用（与Redis）
- 在SQLite或MySQL中存储玩家数据
- 所有内容都可以翻译
- 开发者API
- 包含几个占位符（见下文）
- 自动配置更新
- 支持Minecraft 1.16+颜色
- 在头颅上显示全息图（DecentHolograms、HolographicDisplays或ProtocolLib）
- 排序或定义头颅的最大点击次数
_请注意，如果您正在使用分层奖励，请确保从一开始就正确设置它。 目前还没有办法为已经达到过的层级分发奖励！_
# Wiki:
您可以在[这里](https://aerwyn81.github.io/HeadBlocks)找到Wiki。
# 配置：
- **config.yml** : _插件配置文件_
- **language/** : _文件夹包含翻译文件（en或fr可用）_
- **headblocks.db** : _用于存储玩家数据的SQLite数据库（不包括MySQL）_
- **locations.yml** : _包含头颅位置列表的文件_
# 命令：
- **progress ** : _显示玩家的进度（可以包含在config.yml中可自定义的进度条）_
- **give ** : _给予一个特殊头颅。放置时，它会变成一个可点击的头颅（每个玩家一次性）_
- **remove ** : _通过其uuid移除生成的头颅_
- **removeall** : _移除所有生成的头颅_
- **reset ** : _重置玩家的所有数据_
- **resetall** : _重置所有玩家的数据_
- **list** : _在聊天中显示所有头颅及其位置的列表_
- **rename ** : _重命名一个头颅（用于在gui、统计信息、聊天中显示头颅）_
- **stats ** : _在聊天中显示玩家已找到和未找到的头颅的列表_
- **top ** : _在聊天中显示玩家排行榜_
- **move** : _在不丢失玩家数据的情况下移动现有头颅_
- **export** : _将HeadBlocks数据库导出到另一个数据库_
- **options** : _打开一个带有排序或最大点击设置的GUI_
- **reload** : _重新加载插件配置_
- **version** : _显示插件版本_
- **help** : _显示帮助消息_
# 权限：
- **headblocks.use** : _允许与头颅互动_
- **headblocks.commands.top** : _排行榜命令_
- **headblocks.commands.progress** : _进度命令_
- **headblocks.commands.progress.other** : _查看其他玩家的进度_
- **headblocks.admin** : _所有管理员命令（默认op）_
如果您想运行占位符，您需要 **PlaceHolderAPI**。
如果您想运行全息图，您需要 **ProtocolLib**。
如果您想使用 HeadDatabase 头颅，您需要 **HeadDatabase**。
# 占位符：
- **%headblocks_current%** : _玩家找到的头颅数量（原始整数）_
- **%headblocks_left%** : _玩家剩余的需要找到的头颅数量（原始整数）_
- **%headblocks_max%** : _放置的头颅总数量（原始整数）_
- **%headblocks_hasHead_uuid%** : _如果玩家找到具有uuid的头颅，uuid在/hb info命令中定义（原始布尔值）_
- **%headblocks_order_previous%** : _如果指定了顺序，显示找到的先前命名的头颅（原始整数或如果无法计算则显示“-”）_
- **%headblocks_order_current%** : _如果指定了顺序，显示当前命名的头颅（原始整数或如果无法计算则显示“-”）_
- **%headblocks_order_next%** : _如果指定了顺序，显示需要找到的下一个命名头颅（原始整数或如果无法计算则显示“-”）_
- **%headblocks_leaderboard__%** : _用于构建排行榜（自定义检查配置文件）_
# API：
- **HeadClickEvent** : _当头颅被点击时触发的事件_
- **HeadCreatedEvent** : _当头颅创建时调用的事件_
- **HeadDeletedEvent** : _当头颅被删除时触发的事件_
☕ 整个插件源代码可在[Github](https://github.com/AerWyn81/HeadBlocks)上获取。
# 已知问题：
- 盔甲架可能会出现在头颅上方。 如果使用默认的全息图配置（默认配置）并且您的ProtocolLib版本过旧，则会发生这种情况。 如果您无法升级您的ProtocolLib版本，您可以更改全息图类型（CMI支持、HolographicDisplay或DecentHologram），或者简单地禁用全息图。
# 特别感谢：
[Minecraft-heads](https://minecraft-heads.com/) : 大量的头颅纹理选择
[Item-NBT-API](https://github.com/tr7zw/Item-NBT-API) : 头颅相关的管理
[Config-Updater](https://github.com/tchristofferson/Config-Updater) : 自动更新配置
XSound from [XSeries](https://github.com/CryptoMorin/XSeries) : 用于播放声音
Stress-test : [Just2Craft](https://www.just2craft.fr/)
# 最终想法
发现问题或有建议？ 随时在Github issue [这里](https://github.com/AerWyn81/HeadBlocks/issues)或讨论中使用！
该插件可能还不太完善，在评测之前，如果您需要帮助或遇到错误，请随时与我联系！