
将你的世界变成寻宝游戏。
隐藏头颅、方块、生物或 3D 模型。让玩家找到它们,赚取奖励并攀升排行榜。
复活节、万圣节、圣诞节、大厅收藏品、速通挑战:一款插件,全年适用各种活动。
100% 免费且开源 • 无付费版 • 1.20 → 26.3 • Spigot / Paper / Purpur / Folia
⭐ 为什么选择 HeadBlocks?
- 一切都在游戏中完成,通过菜单操作。 创建寻宝任务、放置头颅、设置奖励和行为逻辑,无需打开任何 YAML 文件。
- 同时支持无限数量的寻宝任务。 每个任务都有独立的头颅、进度系统、奖励、排行榜和规则。
- 不仅限于头颅。 可隐藏方块、物品、悬浮文本、生物、NPC、Nexo / ItemsAdder / Oraxen 家具或 ModelEngine / BetterModel 3D 模型。
- 专为服务器网络设计。 MySQL + Redis 确保玩家进度在所有服务器上同步。
- 轻量级且持续维护。 超过 17,000 次下载(所有平台),评分 4.7/5,Discord 提供活跃支持。

? 你可以用它构建什么?
- ? 季节性活动:一场在 4 月 1 日开启并在两周后自动关闭的复活节寻蛋活动。
- ⏱️ 速通挑战:玩家踩上压力板,计时开始,最快成绩登上排行榜。
- ? 剧情线索:头颅必须按顺序寻找,每个头颅提供下一个线索。
- ? 实时竞赛 (3.6.0):头颅分批生成;率先拾取者获得该头颅,最先到达终点者获胜。
- ? 大厅收藏品:在大厅各处隐藏头颅,每找到 10 个即可领取奖励。
- ? 进度路径:由前一个寻宝任务、权限、游戏时长、WorldGuard 区域或任何 PlaceholderAPI 值解锁的寻宝任务。
✨ 功能特性
寻宝任务与行为逻辑
- 自由模式:玩家可以按任意顺序寻找头颅
- 有序模式:必须按照指定顺序寻找头颅
- 定时模式:寻宝任务在两个日期之间自动开启和关闭
- 计时模式:由压力板启动的竞速模式,拥有独立排行榜
- 生成头颅 (3.6.0):头颅以随机位置或区域内成批出现,支持加权模板、积分、随机奖励和陷阱
- 前置条件:区域(立方体或 WorldGuard,可选限制范围)、前序任务、权限、游戏时长、PlaceholderAPI 比较,支持组合 ALL / ANY

奖励
- 针对每个找到的头颅发送消息、头衔、广播和命令
- 里程碑奖励(每找到 X 个头颅,或在完成寻宝任务时)
- 随机命令,发放物品前检查背包空间
视觉效果与反馈
- 头颅上方的全息显示,标记已找到 / 未找到
- 未找到头颅上方显示粒子效果
- 点击时触发烟花、音效、头衔和粒子
- 旋转的头颅、渐变色和彩虹文字
- 提示:靠近时播放声音,在动作栏显示距离和箭头

进度与排行榜
- 每个任务的进度和全局进度,支持自定义进度条
- 全局、单任务、计时和积分排行榜
- 详细的玩家统计数据
存储与多服务器支持
- SQLite:开箱即用,无需配置
- MySQL / MariaDB:共享数据库,连接池,SSL 支持
- Redis:服务器间的实时同步
? 集成支持
- PlaceholderAPI:全局和单任务的占位符(进度、排行榜、计时器、分数等)
- HeadDatabase / HeadDB:使用
hdb:<id>调用任意头颅 - WorldGuard:将区域用作寻宝任务范围
- Nexo, ItemsAdder, Oraxen:自定义物品和家具
- ModelEngine, BetterModel:3D 模型
- Citizens, FancyNpcs, ZNPCsPlus:NPC
- PacketEvents:带有占位符的个人专属全息图,客户端隐藏已找到的头颅
? 1 分钟快速上手
- 将 jar 包放入
/plugins目录并重启服务器 - 执行
/hb hunt create easter - 执行
/hb give获取头颅 - 潜行 + 右键点击来放置头颅
- 执行
/hb options并通过寻宝菜单设置奖励和行为逻辑
就这样,你的玩家就可以开始寻宝了。完整指南请查看 Wiki。
? 兼容性
- Minecraft 1.20 → 26.3,Java 17+
- Paper / Folia / Purpur:原生构建版本可在 Modrinth 和 Hangar 获取
- Spigot:构建版本可在 SpigotMC 获取
- 语言:包含英语和法语,更多语言请访问 Crowdin(欢迎贡献!)
主要命令
/hb progress//hb top: 玩家进度和排行榜/hb hunt create|delete|enable|disable|list: 管理寻宝任务/hb hunt select <hunt>: 选择新头颅归属的寻宝任务/hb hunt schedule: 设置定时任务的日期/hb spawn <hunt>(3.6.0): 生成点、当前存在的头颅、重新滚动/hb give,/hb options,/hb reload
所有命令:Wiki → 命令与权限
权限节点
| 权限 | 描述 | 默认值 |
|---|---|---|
headblocks.use |
与头颅交互 | 所有人 |
headblocks.commands.progress |
查看自己的进度 | 所有人 |
headblocks.commands.top |
排行榜 | 所有人 |
headblocks.commands.progress.other |
其他玩家的进度 | op |
headblocks.area.bypass |
绕过狩猎区域限制 | op |
headblocks.admin |
所有管理命令 | op |
开发者 API
事件:HeadClickEvent、HeadCreatedEvent、HeadDeletedEvent、HuntCreateEvent、HuntDeleteEvent、HuntStateChangeEvent(狩猎类事件可取消)。
文档:wiki → Developers
截图
❤️ 喜欢 HeadBlocks?
评价很有帮助,在 GitHub 上给个 ⭐ 也好!
遇到 Bug 或问题?请在 Discord 上提问,而不是在评价中留言,这样能更快得到解答。

Turn your world into a treasure hunt.
Hide heads, blocks, mobs or 3D models. Your players find them, earn rewards and climb the leaderboards.
Easter, Halloween, Christmas, lobby collectibles, speedruns: one plugin for every event, all year long.
100% free & open source • No premium version • 1.20 → 26.3 • Spigot / Paper / Purpur / Folia
? Wiki • ? Discord • ? GitHub • ? Translate
⭐ Why HeadBlocks?
- Everything in game, through menus. Create a hunt, place heads, set rewards and behaviors without opening a single YAML file.
- Unlimited hunts at the same time. Each one has its own heads, progression, rewards, leaderboard and rules.
- Not only heads. Hide blocks, items, floating texts, mobs, NPCs, Nexo / ItemsAdder / Oraxen furniture or ModelEngine / BetterModel 3D models.
- Built for networks. MySQL + Redis keep player progress in sync across all your servers.
- Lightweight and maintained. 17,000+ downloads (on all platforms), rated 4.7/5, active support on Discord.

? What can you build with it?
- ? A seasonal event: an Easter egg hunt that opens on April 1st and closes on its own two weeks later.
- ⏱️ A speedrun: players step on a pressure plate, the timer starts, the fastest run tops the leaderboard.
- ? A story trail: heads must be found in order, each one giving the next clue.
- ? A live race (3.6.0): heads spawn a few at a time; the first to grab one takes it, and the first to reach the goal wins.
- ? Hub collectibles: hidden heads all around your lobby, with a reward every 10 found.
- ? A progression path: hunts unlocked by a previous hunt, a permission, playtime, a WorldGuard region or any PlaceholderAPI value.
✨ Features
Hunts & behaviors
- Free: find the heads in any order
- Ordered: the heads must be found in a set order
- Scheduled: the hunt opens and closes on its own between two dates
- Timed: race mode started by a pressure plate, with a dedicated leaderboard
- Spawning heads (3.6.0): heads appear a few at a time, at random spots or in an area, with weighted templates, points, random rewards and traps
- Requirements: area (cuboid or WorldGuard, with optional confinement), previous hunt, permission, playtime, PlaceholderAPI comparison, combined with ALL / ANY

Rewards
- Messages, titles, broadcasts and commands for each head found
- Milestone rewards (every X heads, or on hunt completion)
- Random commands, inventory space check before giving items
Visuals & feedback
- Holograms above the heads, showing found / not found
- Particles above the heads not found yet
- Fireworks, sounds, titles and particles on click
- Spinning heads, gradient and rainbow texts
- Hints: a sound when close, a distance and an arrow in the action bar

Progression & leaderboards
- Progress per hunt and global, with customizable progress bars
- Global, per-hunt, timed and points leaderboards
- Detailed player statistics
Storage & multi-server
- SQLite: works out of the box, nothing to configure
- MySQL / MariaDB: shared database, connection pool, SSL
- Redis: real-time synchronization between servers
? Integrations
- PlaceholderAPI: global and per-hunt placeholders (progress, leaderboards, timers, scores…)
- HeadDatabase / HeadDB: use any head with
hdb:<id> - WorldGuard: regions as hunt areas
- Nexo, ItemsAdder, Oraxen: custom items and furniture
- ModelEngine, BetterModel: 3D models
- Citizens, FancyNpcs, ZNPCsPlus: NPCs
- PacketEvents: per-player holograms with placeholders, found heads hidden client-side
? Get started in 1 minute
- Drop the jar in
/pluginsand restart /hb hunt create easter/hb giveto get the heads- Sneak + right-click to place them
/hb optionsand the hunt menu to set rewards and behaviors
That's it, your players can start hunting. Full guide on the wiki.
? Compatibility
- Minecraft 1.20 → 26.3, Java 17+
- Paper / Folia / Purpur: native build on Modrinth and Hangar
- Spigot: build on SpigotMC
- Languages: English and French included, more on Crowdin (contributions welcome!)
Main commands
/hb progress//hb top: player progress and leaderboard/hb hunt create|delete|enable|disable|list: manage hunts/hb hunt select <hunt>: choose the hunt where new heads go/hb hunt schedule: set the dates of a scheduled hunt/hb spawn <hunt>(3.6.0): spawn points, heads present, reroll/hb give,/hb options,/hb reload
All commands: wiki → Commands and Permissions
Permissions
| Permission | Description | Default |
|---|---|---|
headblocks.use |
Interact with heads | everyone |
headblocks.commands.progress |
Own progress | everyone |
headblocks.commands.top |
Leaderboard | everyone |
headblocks.commands.progress.other |
Other players' progress | op |
headblocks.area.bypass |
Bypass hunt area confinement | op |
headblocks.admin |
All admin commands | op |
Developer API
Events: HeadClickEvent, HeadCreatedEvent, HeadDeletedEvent, HuntCreateEvent, HuntDeleteEvent, HuntStateChangeEvent (hunt events are cancellable).
Documentation: wiki → Developers
Screenshots
❤️ Enjoying HeadBlocks?
A review helps a lot, and a ⭐ on GitHub too!
Bug or question? Ask on Discord rather than in the reviews, it gets answered faster.
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadBlocks
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
HeadBlocks v3.5.0
更新内容
✨ 新功能
- 隐藏更多物品。
heads列表现在接受方块(block:LANTERN)、物品(item:DIAMOND:1001)、物品展示框(frame:FILLED_MAP)、浮动文本(text:&6Find me!)以及无 AI 的生物(mob:CAT)。选项置于方括号内,例如mob:ZOMBIE[head=DIAMOND_HELMET,baby=true]。详见 文档。 - 其他插件的内容,在已安装时:来自 Nexo、ItemsAdder 和 Oraxen 的自定义物品与家具,来自 MythicMobs 的生物,来自 ModelEngine 和 BetterModel 的 3D 模型,以及来自 Citizens、FancyNpcs 和 ZNPCsPlus 的 NPC。
- 渲染模式。
config.yml中新增rendering部分(包含mode、scale、glow),可在每次狩猎中覆盖设置:头和方块可放置为真实方块(BLOCK)或作为浮动、可缩放且平滑旋转的显示实体(DISPLAY)。 /hb hunt rendering <hunt> <block|display>转换狩猎中已放置的头,保留其内容、位置及玩家进度。/hb hunt info显示狩猎的渲染状态。- 目录。
/hb give打开一个菜单以获取物品:按类型筛选,选择物品关联的狩猎,按住 Shift + 点击以获取一组物品。/hb give <player>为该玩家打开此菜单,也可从控制台运行。
? 改进
- 作为实体渲染的头,对于已通过
hideFoundHeads找到的玩家原生隐藏:无需 PacketEvents,也不会留下不可见的碰撞体积。 - 实体永远不会保存在世界中:它们在区块加载时生成,若被移除则会重新生成,因此卸载插件后不会留下任何痕迹。
- 已放置的方块头受到保护:它们不会燃烧、融化、腐烂,移除支撑物时不会掉落,也不会被粘性活塞拉动,点击仅视为认领(不会打开箱子,不会切换拉杆)。
- 物品展示框放置在点击的面上,包括地板和天花板。
/hb move也会移动作为实体渲染的头。- 移动到另一个狩猎的头会采用新狩猎的渲染设置。
- 全息图会抬高至高于生物等高内容的上方。
- 狩猎的旋转设置现已应用于其头。
- 在拥有大量头的服务器上,头的查找速度更快。
⚠️ 破坏性更改
/hb give <player> <number|*> [hunt]已被目录取代:头编号、*和狩猎参数不再存在。通过编号给予头的脚本或命令需进行更新。
感谢您使用 HeadBlocks ❤️
如果您发现错误或有问题,请随时:
- 在 Github 提交问题
- 或在 Discord 中提问
- 或在 Spigot 讨论区 中交流
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧