BetterHeads • +40k heads! Vault/Level/Item support! Categories! - BetterHeads - 超40万头颅库

BetterHeads 是一款功能强大的自定义头颅插件，为服务器提供了海量装饰性头颅，并集成了便捷的购买、搜索与管理系统，同时为开发者提供了丰富的 API。

💡重要须知

• 此插件必须安装 NBTAPI 才能运行。
• 不支持使用 Plugman 等插件管理工具进行热重载。
• 请尊重作者劳动成果，严禁在任何地方重新分发此插件。
• 严禁在 MCBBS 等中文论坛发布、搬运或转载此插件。
• 测试支持的版本：1.8.8 至 1.18.1。

✨核心特性

• 海量头颅库：内置超过 40,000 个自定义头颅。
• 多版本支持：兼容 1.8.8 至最新版服务端。
• 多种收费模式：支持游戏等级、Vault 经济、物品材料作为货币。
• 创造模式友好：可为创造模式玩家启用或禁用收费。
• 随机头颅命令：可从指定分类中随机给予玩家头颅。
• 智能搜索：支持按名称或标签搜索头颅。
• 权限控制：可为单个头颅、整个分类设置独立权限，支持免费获取与跳过冷却的权限。
• 冷却系统：可防止玩家过快获取大量头颅，可为创造模式玩家单独禁用。
• 开发者 API：提供功能齐全的 API，方便其他插件集成调用。

🔧安装与配置

安装步骤

• 从 SpigotMC.org 下载插件。
• 将 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 按需编辑配置文件。
• 再次重启服务器以使配置生效。

配置文件

• 主要配置位于 config.yml。
• 插件更新时，配置文件会自动更新（注释会被移除）。
• 权限可在配置文件中进行详细设置。

🎮命令列表

• /betterheads - 打开头颅分类 GUI。
• /betterheads get <id> - 通过 ID 获取指定头颅。
• /betterheads open <玩家名> - 为指定玩家打开分类 GUI。
• /betterheads build <玩家名> <材质> - 直接给予玩家指定材质的自定义头颅。
• /betterheads search <关键词> (-name) - 搜索头颅。使用 -name 后缀则仅按名称搜索。
• /betterheads giverandom <分类> <玩家名> <数量> - 从指定分类随机给予玩家头颅。
• /betterheads giverandom <random|all> <玩家名> <数量> - 从随机或全部分类中给予头颅。
• /betterheads head - 获取你自己的头颅。
• /betterheads head <玩家名> <目标玩家> - 将某玩家的头颅给予另一玩家。
• /betterheads reload - 重载部分配置（建议更改配置后重启服务器）。

命令别名

• 可为 /betterheads 主命令设置别名。
• 注意：设置别名后必须重启服务器才能生效。

⭐权限列表

• betterheads.admin - 使用所有管理命令。
• betterheads.search - 使用搜索功能。
• betterheads.player-head - 使用 /betterheads head 获取自己的头颅。
• betterheads.free - 免费获取所有头颅（默认 OP 无此权限）。
• betterheads.cooldownbypass - 跳过获取头颅的冷却时间（默认 OP 无此权限）。
• 更多细粒度权限（如按分类、按头颅设置）请在配置文件中查看。

❓常见问题解答

• 为什么标记为 BETA？有漏洞吗？

> 插件应无漏洞。使用 BETA 仅是作者的偏好。

• 会添加新头颅吗？

> 插件使用的 API 会自动添加新头颅。

• 需要更新插件来获取新头颅吗？

> 通常不需要，系统会自动处理。但仍建议保持插件最新以获取漏洞修复。

• 为什么免费？

> 作者乐意分享。

• 可以在 MCBBS 发布吗？

> **绝对不行**。

• 插件不工作怎么办？

> 请先确认已安装所有依赖（尤其是 NBTAPI）。若问题依旧，请将启动日志上传至 `https://sourceb.in/` 并在讨论区发帖或加入作者 Discord 寻求帮助。

🔧开发者 API

插件提供了强大的 API，包路径为：com.alonsoaliaga.betterheads.api.BetterHeadsAPI

主要方法

• List<String> getCategories() - 返回可用分类列表。
• ItemStack getHead(int id) - 返回指定 ID 的头颅，无效则返回 null。
• boolean openCategories(Player player) - 为玩家打开分类 GUI。
• boolean openHeads(Player player, String category, int page) - 为玩家打开指定分类和页面的头颅 GUI。
• ItemStack getRandomHead() - 返回一个随机头颅。
• ItemStack getRandomHead(String category) - 返回指定分类的随机头颅。
• List<Integer> getHeadsIds() - 返回所有头颅 ID 列表。
• List<Integer> getHeadsIds(String category) - 返回指定分类的头颅 ID 列表。
• List<Integer> searchHeads(String search) - 按名称搜索并返回匹配的头颅 ID 列表。
• List<Integer> searchHeads(String search, boolean includeTags) - 搜索（可包含标签）并返回 ID 列表。
• boolean searchHeads(Player player, String search, boolean includeTags) - 为玩家打开搜索结果的 GUI。

可用事件

• HeadPurchaseEvent - 当玩家从 GUI 购买/获取头颅时触发。

💡使用条款

下载即表示您同意以下条款

• 禁止以任何形式重新分发本插件。
• 禁止对本插件进行反编译或修改。
• 禁止声称本资源是您自己的作品。