Heads Plugin API 3 - ：自定义头颅生成库

HeadsPluginAPI 是一个用于在 Minecraft 服务器上轻松创建和使用自定义皮肤头颅的 API 库。它提供了从多个在线数据库获取高质量头颅的便捷方式，并已被多个插件（如 HeadsInventory 和 HeadSweeper）所采用。

💡兼容性

• 当前版本 (v2.0.11+)：已测试兼容 1.17 - 1.21.3 (Spigot, Paper, Purpur)。
• 旧版本 (v2.0.11 及更早)：支持 1.13 - 1.17.1。
• 更旧版本 (v1.9.0 及更早)：支持 1.8-beta - 1.13，并部分支持 1.7.10。

🎮功能概述

HeadsPluginAPI 本身是一个开发库。基于它构建的插件（如 HeadsInventory）可以提供以下功能：

• 生成用于建筑装饰和细节提升的各类头颅。
• 不仅提供玩家头颅，还提供来自多个在线数据库的自定义皮肤头颅。
• 支持从以下数据库获取内容：
• heads.freshcoal.com
• minecraft-heads.com
• mineskin.org

主要特性

• 分类清晰：提供高质量、已分类的头颅。
• 海量搜索：支持手动搜索包含超过 60,000 个头颅的完整数据库。
• 自定义分类：允许创建自定义的头颅类别。
• 缓存机制：在数据库无法访问时，提供已分类头颅的缓存。
• 可切换源：允许选择不同的数据库来源。
• 完整文档：提供 Wiki 和 Javadoc 以供开发者使用。

🔧命令与权限

注意：以下命令仅适用于 2.x 版本。目前的 3.x 版本仅作为库使用（例如供 HeadsInventory 或 HeadSweeper 调用）。

插件提供 /headspluginapi 命令（可简写为 /hpa）：

可用命令

• /headspluginapi (listcategories | listcat | lstcat | list | lst | showcategories | showcat | shwcat | show | shw)
• 显示所有类别的列表。
• /headspluginapi (update | up | updateheads | uh | uphds) [CATEGORY_NAME]
• 更新所有或特定类别的头颅。需要权限。

权限节点

• headspluginapi.update
• 允许玩家使用 /headspluginapi update 命令。

❓开发者资源

如果您想在您的插件中使用此 API，请参考以下资源：

• Wiki 文档：https://github.com/CC007/HeadsPluginAPI/wiki
• Javadoc：链接可在上述 Wiki 中找到。

⭐联系信息

• 电子邮箱：[email protected]
• Discord：https://discord.gg/8RQfMX2

✨相关插件示例

• HeadsInventory：用于生成装饰性头颅的插件。
• HeadSweeper：另一个使用此 API 的插件示例。