HeadDB

插件

· 作者 SilentWT

头部模型的第一中央数据库

0 本站下载 0 关注 更新于 1 个月前

最新 7.0.0-rc.8 · 26.2 · Folia / Paper

一键开服(送7天)

HeadDB

面向 Paper 和 Folia 服务器的现代化、可配置的头部数据库。

HeadDB 为玩家提供了一个直观的库存界面,用于浏览、搜索、收藏、购买以及获取超过 100,000 个 Minecraft 头部。

服务器管理员可以掌控权限、经济定价、自定义内容、GUI 布局、音效、消息、数据库更新和管理工具。

浏览公共头部数据库
文档与配置指南


功能特性

  • 超过 100,000 个 Minecraft 头部
  • 分类、标签与合集
  • 支持高级筛选与排序的快速文本搜索
  • 基于现代库存的导航方式
  • 收藏夹功能
  • 玩家头部
  • 自定义头部与自定义分类
  • 自定义标签与合集
  • 本地元数据覆盖
  • 可选的 Vault 经济集成
  • 细粒度权限控制
  • 游戏内管理
  • 可配置的 GUI、消息与音效
  • 自动远程数据库更新
  • 经认证的本地缓存与离线备用方案
  • 支持 Paper 和 Folia
  • 公开的 Java API

Revivenode Hosting


要求

  • Java 25 或更高版本
  • Paper 或 Folia
  • 网络访问权限(用于初始数据库下载及后续更新)

成功下载数据库后,当远程数据库暂时不可用时,HeadDB 可以加载其已验证的本地缓存。


安装

  1. 下载最新版的 HeadDB 插件 JAR 文件。
  2. 将其放入服务器的 plugins 目录中。
  3. 重启服务器。
  4. 查看生成的配置文件。
  5. 授予玩家 headdb.basic 权限,或配置更细粒度的权限。

在游戏中通过以下方式打开 HeadDB:

/hdb

浏览与搜索

玩家可以浏览 HeadDB,无需依赖冗长或复杂的命令。

图形化界面提供了:

  • 分类浏览
  • 标签与合集
  • 文本搜索
  • 高级搜索筛选器
  • 排序
  • 收藏
  • 玩家头颅
  • 分页结果
  • 上一页、下一页和返回导航
  • 个人设置

玩家也可以直接进行搜索:

/hdb search <query>

收藏

玩家可以标记常用头颅为收藏,并稍后从专用菜单中访问它们。

收藏数据按玩家独立存储。


玩家头颅

玩家头颅的处理独立于公开的 HeadDB 目录。

管理员可以独立控制:

  • 访问玩家头颅功能
  • 玩家是否仅能获取自己的头颅
  • 玩家是否可获取其他玩家的头颅
  • 玩家头颅经济定价
  • 外部资料查询

自定义头颅

自定义头颅是通过 HeadDB 直接管理的服务器本地头颅。

它们适用于:

  • 服务器专属装饰
  • 活动奖励
  • 管理员头颅
  • 捐赠者内容
  • 季节性内容
  • 自定义商店物品
  • 未包含在公共数据库中的头颅

自定义头颅可通过图形界面或兼容的头饰物品与纹理值创建。

它们可被分配到分类、标签和收藏中,并存储在服务器本地。

自定义头颅不会添加到公共 HeadDB 数据库。


自定义分类

自定义分类是服务器本地的分类,用于整理精选的远程头颅和自定义头颅。

它们可用于:

  • 出生点装饰
  • 活动奖励
  • 商店库存
  • 季节性选择
  • 管理员专属收藏
  • 建筑资源
  • 捐赠者奖励

自定义分类会显示在浏览菜单中的公共数据库分类旁边。

将头颅添加到自定义分类不会修改其原始的公共数据库分类。


自定义标签与收藏

管理员可以创建本地标签和收藏,以整理远程头颅和自定义头颅。

自定义标签和收藏可通过图形界面或支持的命令进行创建、搜索、选择和管理工作。

它们保留在服务器本地,且不会修改公共数据库。


管理

管理员模式会在 HeadDB 界面中暴露额外的管理控制功能。

管理员可以:

  • 创建和管理自定义头颅
  • 创建和管理自定义分类
  • 创建自定义标签和收藏
  • 编辑头颅元数据
  • 隐藏或恢复头颅
  • 配置 GUI 按钮
  • 验证或刷新远程数据库
  • 访问运行时和诊断信息

本地元数据覆盖

远程头颅在公共数据库中是不可变的,但管理员可以为自己的服务器应用本地覆盖。

支持的覆盖项包括:

  • 名称
  • 描述(Lore)
  • 分类
  • 标签
  • 收藏
  • 可见性

覆盖可以被重置,而无需修改原始远程数据。


经济集成

HeadDB 可以选择在向玩家发放头颅时收取费用。

支持经济系统需要:

  • Vault
  • 一个兼容 Vault 的经济提供商

可以为以下项目配置价格:

  • 远程头颅
  • 玩家头颅
  • 远程分类
  • 自定义分类
  • 单个头颅
  • 全局默认价格

当禁用经济支持时,头颅免费获取。

有关经济设置和价格优先级的详细信息,请参阅 HeadDB wiki。


自动数据库更新

HeadDB 会定期检查远程数据库是否有新发布的头颅。

定时刷新默认启用,并且在已发布目录未更改时避免下载数据库文件。

管理员仍可立即执行刷新操作:

/hdb refresh

刷新计划可在 config.yml 中进行配置。


命令

常用命令包括:

命令 说明
/hdb 打开 HeadDB 主菜单
/hdb help 显示可用命令
/hdb search <查询> 搜索头颅
/hdb status 显示数据库状态
/hdb refresh 检查数据库更新
/hdb reload 重新加载 HeadDB
/hdb update 下载可用的插件更新

在游戏中执行 /hdb help 或访问 HeadDB wiki 以获取完整的命令参考。


权限

对于普通玩家设置,请授予:

headdb.basic

如需完全的管理员访问权限,请授予:

headdb.admin

可以通过以下方式控制单个类别的访问权限:

headdb.category.<category-id>

HeadDB 还提供了用于各个命令、GUI 操作、玩家头颅、自定义头颅、自定义分类、收藏、编辑和数据库管理的细粒度权限。

一些内部权限节点保留了旧名称以保持兼容性。

请参阅 HeadDB wiki 以获取完整的权限参考。


配置

HeadDB 按职责分离配置。

config.yml

控制核心插件行为,包括:

  • 远程数据库设置
  • 本地缓存行为
  • 启动和计划刷新
  • HTTP 超时
  • 玩家头颅
  • 自定义内容
  • 更新检查
  • 自动插件更新
  • 诊断信息

gui.yml

控制:

  • 菜单布局
  • 按钮位置
  • 材质
  • 头颅图标
  • 显示名称
  • 描述文本(Lore)

sounds.yml

控制可配置的声音效果,适用于:

  • GUI 导航
  • 头颅交互
  • 收藏
  • 可见性变化
  • 购买
  • 确认
  • 错误提示
  • 管理员操作
  • 命令反馈

economy.yml

控制:

  • Vault 集成
  • 全局定价
  • 玩家头颅定价
  • 分类定价
  • 自定义分类定价
  • 单个头颅定价

messages/

包含本地化的:

  • 面向玩家的提示信息
  • 命令反馈
  • 管理员消息
  • 错误提示
  • 界面文本

完整的配置文档可在 HeadDB wiki 上找到。


本地存储

HeadDB 在本地存储服务器特定的数据,包括:

  • 自定义头颅
  • 自定义分类
  • 自定义标签和集合
  • 收藏夹
  • 玩家头颅缓存数据
  • 隐藏的头颅
  • 远程元数据覆盖
  • 草稿内容

本地内容在服务器重启后依然保留,并由服务器所有者控制。


远程数据库与缓存

HeadDB 下载经过验证的远程目录,其中包含公开的头颅、分类、标签、集合和撤销列表。

下载的数据库文件存储在本地缓存中。

在启动时,HeadDB 可以立即加载缓存中的数据库,然后检查是否有更新的远程版本可用。

如果远程服务暂时不可用,最后一个已验证的缓存数据库仍可继续使用。


开发者 API

HeadDB 通过 Bukkit 的服务提供者系统暴露了一个公共 Java API。

集成应用可以访问:

  • 远程和自定义头颅
  • 分类
  • 标签
  • 集合
  • 搜索功能
  • 收藏夹
  • 自定义头颅
  • 自定义分类
  • 玩家头颅功能

API 和核心模块针对 Java 21。
Paper 平台模块针对 Java 25。

有关依赖设置、API 文档和集成示例,请参阅 HeadDB wiki。


链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源