HeadBlocks MINI-GAMES - 复活节寻头小游戏

HeadBlocks 将自定义头颅收集玩法变成一场真正的寻宝冒险。你可以在世界各处隐藏头颅，创建不同主题的猎寻活动，并通过奖励、排行榜与进度系统持续激发玩家的探索热情。

💡插件简介

HeadBlocks — The Ultimate Head Hunting Experience

把你的服务器变成令人兴奋的寻宝游乐场。

• 支持版本：1.20 — 1.21+
• 特性：Multi-Server Ready、Fully Translatable、Free & Open Source

HeadBlocks 允许你将自定义头颅隐藏在世界各处，并把它们变成可收集的宝藏。玩家可以探索、发现、竞争，努力找齐所有头颅。

这就像把彩蛋探索与成就收集结合在一起，非常适合提升社区活跃度。

你可以将头颅放在任意位置，把它们组织成不同的 hunts，配置奖励与排行榜，让玩家花上数小时探索你世界中的每个角落。

⭐核心功能

Multi-Hunt System

• 创建无限个相互独立的 hunts
• 每个 hunt 都可以拥有自己的头颅集合、规则与进度
• 可同时运行多个活动，例如：
• 万圣节 hunt
• 圣诞节活动
• 常驻探索挑战
• 可随时启用、禁用或归档 hunt

Hunt Behaviors

• Free
• 玩家可以按任意顺序点击头颅
• 经典自由寻宝模式
• Ordered
• 玩家必须按照你设定的特定顺序寻找头颅
• Scheduled
• 仅在指定日期范围内启用的 hunt
• 非常适合季节性活动
• Timed
• 竞速模式
• 玩家从压力板开始计时，与时间赛跑
• 可记录最佳成绩并显示限时排行榜

Powerful Reward System

• 支持按单个头颅发放奖励：
• 消息
• 命令
• 全服广播
• 支持里程碑分层奖励
• 例如找到 10、50、100 个头颅时发放特殊奖励
• 支持库存槽位检查
• 支持随机执行命令

Hint System

通过可配置的邻近提示帮助玩家寻找附近头颅

• 声音提示
• 玩家进入范围内时播放声音
• Action bar 提示
• 显示距离与方向
• 支持可自定义箭头指示器
• 可配置：
• 检测距离
• 冷却时间
• 按头颅单独启用或禁用提示

Visual Effects

• 头颅上方全息文字（已找到/未找到文本）
• 内置 TextDisplay
• 或使用 PacketEvents 的高级模式
• 未找到头颅上方悬浮粒子
• 颜色可自定义
• 点击时可触发：
• 烟花
• 粒子
• 音效
• 标题
• 消息
• Spin mode
• 旋转头颅，提升可见度
• 文本格式支持：
• 渐变色
• 彩虹色
• 纯色

Progression & Leaderboards

• 按 hunt 和全局分别追踪进度
• 可自定义进度条
• 全局与 hunt 专属排行榜：/hb top
• 限时 hunt 最佳时间与排名
• 详细玩家统计：
• 已找到头颅数
• 未找到头颅数
• 完成百分比

🎮多服支持与存储

HeadBlocks 原生支持多服务器环境

• SQLite
• 零配置，开箱即用
• MySQL / MariaDB
• 集中式数据库
• 支持连接池与 SSL
• Redis
• 跨服务器实时同步玩家数据

无论你运行的是单个 SMP，还是多服务器网络，HeadBlocks 都能随之扩展。

✨集成支持

• PlaceholderAPI
• 提供 20+ 个占位符
• 可用于记分板、全息文字、聊天等
• HeadDatabase
• 可通过 hdb:<id> 访问数千种头颅材质
• PacketEvents
• 提供高级全息文字占位符支持
• 支持对已找到头颅进行客户端隐藏

完整 PlaceholderAPI 列表

• %headblocks_current% — 已找到的头颅数量（总计）
• %headblocks_left% — 剩余头颅数量（总计）
• %headblocks_max% — 头颅总数
• %headblocks_hunt_<id>_found% — 指定 hunt 中已找到数量
• %headblocks_hunt_<id>_total% — 指定 hunt 中总数量
• %headblocks_hunt_<id>_left% — 指定 hunt 中剩余数量
• %headblocks_hunt_<id>_progress% — 指定 hunt 中的进度百分比
• %headblocks_hunt_<id>_name% — hunt 显示名称
• %headblocks_hunt_<id>_state% — hunt 状态
• %headblocks_hunt_<id>_besttime% — 最佳时间（限时 hunt）
• %headblocks_hasHead_<uuid|name>% — 检查玩家是否找到特定头颅
• %headblocks_order_previous% — 有序 hunt 中的上一个头颅
• %headblocks_order_current% — 当前目标头颅
• %headblocks_order_next% — 序列中的下一个头颅
• %headblocks_leaderboard_<pos>_name% — 排行榜玩家名称
• %headblocks_leaderboard_<pos>_value% — 排行榜分数
• %headblocks_leaderboard_position% — 玩家自己的排名

🔧命令

管理员命令

• /hb give <player> <*|number> — 给予头颅方块
• /hb remove [uuid] — 移除一个头颅
• /hb removeall [--confirm] — 移除所有头颅
• /hb move — 将头颅移动到新位置
• /hb rename <name> — 重命名头颅
• /hb list [hunt] [page] — 列出所有头颅
• /hb info [uuid] — 查看头颅详细信息
• /hb reset <player> [--head <id>] — 重置玩家进度
• /hb resetall [--head <id>] — 重置所有玩家
• /hb hunt create <name> — 创建一个 hunt
• /hb hunt delete <name> — 删除一个 hunt
• /hb hunt enable/disable <name> — 切换 hunt 状态
• /hb hunt list — 列出所有 hunts
• /hb hunt info <name> — 查看 hunt 详情
• /hb hunt select <name> — 设置当前用于放置的活动 hunt
• /hb hunt assign <criteria> <hunt> — 将头颅分配到某个 hunt
• /hb hunt transfer <uuid> <hunt> — 在 hunts 之间移动头颅
• /hb hunt reset <name> <player> — 重置 hunt 进度
• /hb options rewards [head] — 配置奖励（GUI）
• /hb options hint — 配置提示（GUI）
• /hb debug resync <database|locations> — 重新同步数据
• /hb export database — 将数据导出为 SQL

玩家命令

• /hb progress [player] — 查看进度
• /hb top [number] — 全局排行榜
• /hb hunt top <name> — hunt 排行榜
• /hb hunt progress <player> [hunt] — 查看指定 hunt 进度
• /hb stats <player> [hunt] [page] — 查看详细统计

🎮权限

• headblocks.admin — 访问所有管理员命令
• headblocks.use — 与头颅交互（默认：true）
• headblocks.commands.progress — 使用 /hb progress（默认：true）
• headblocks.commands.top — 使用 /hb top（默认：true）

✨开发者支持

HeadBlocks 提供了可供其他插件监听的事件：

• HeadClickEvent — 当玩家点击头颅时触发
• HeadCreatedEvent — 当头颅被放置时触发
• HeadDeletedEvent — 当头颅被移除时触发
• HuntCreateEvent — 创建 hunt 时触发，可取消
• HuntDeleteEvent — 删除 hunt 时触发
• HuntStateChangeEvent — 启用/禁用 hunt 时触发

⭐语言支持

• 完全可翻译
• 每一条消息都可自定义
• 内置语言：
• English
• French
• 欢迎通过 Crowdin 提交社区翻译

💡快速开始

• 将 HeadBlocks.jar 放入你的 /plugins 文件夹
• 重启服务器
• 使用 /hb hunt create myFirstHunt 创建一个 hunt 并选中它
• 手持头颅，潜行 + 右键 将其放置到世界中
• 按你的需求配置奖励、提示与行为
• 然后让玩家开始探索吧

❓链接

• GitHub
• Wiki
• Discord
• bStats

如果你喜欢 HeadBlocks，请留下一个 ⭐ 评分，这会对项目有很大帮助。

💡文档

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

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