HeadDB
面向 Paper 和 Folia 服务器的现代化、可配置的头部数据库。
HeadDB 为玩家提供了一个直观的库存界面,用于浏览、搜索、收藏、购买以及获取超过 100,000 个 Minecraft 头部。
服务器管理员可以掌控权限、经济定价、自定义内容、GUI 布局、音效、消息、数据库更新和管理工具。
功能特性
- 超过 100,000 个 Minecraft 头部
- 分类、标签与合集
- 支持高级筛选与排序的快速文本搜索
- 基于现代库存的导航方式
- 收藏夹功能
- 玩家头部
- 自定义头部与自定义分类
- 自定义标签与合集
- 本地元数据覆盖
- 可选的 Vault 经济集成
- 细粒度权限控制
- 游戏内管理
- 可配置的 GUI、消息与音效
- 自动远程数据库更新
- 经认证的本地缓存与离线备用方案
- 支持 Paper 和 Folia
- 公开的 Java API
要求
- Java 25 或更高版本
- Paper 或 Folia
- 网络访问权限(用于初始数据库下载及后续更新)
成功下载数据库后,当远程数据库暂时不可用时,HeadDB 可以加载其已验证的本地缓存。
安装
- 下载最新版的 HeadDB 插件 JAR 文件。
- 将其放入服务器的
plugins目录中。 - 重启服务器。
- 查看生成的配置文件。
- 授予玩家
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。
链接
HeadDB
A modern, configurable head database for Paper and Folia servers.
HeadDB gives players an intuitive inventory interface for browsing, searching, favoriting, purchasing, and obtaining more than 100,000 Minecraft heads.
Server administrators retain control over permissions, economy pricing, custom content, GUI layouts, sounds, messages, database updates, and administrative tools.
Browse the public head database
Documentation and configuration guide
Features
- More than 100,000 Minecraft heads
- Categories, tags, and collections
- Fast text search with advanced filtering and sorting
- Modern inventory-based navigation
- Favorites
- Player heads
- Custom heads and custom categories
- Custom tags and collections
- Local metadata overrides
- Optional Vault economy integration
- Granular permissions
- In-game administration
- Configurable GUIs, messages, and sounds
- Automatic remote database updates
- Verified local caching and offline fallback
- Paper and Folia support
- Public Java API
Requirements
- Java 25 or newer
- Paper or Folia
- Network access for the initial database download and future updates
After a successful database download, HeadDB can load its verified local cache when the remote database is temporarily unavailable.
Installation
- Download the latest HeadDB plugin JAR.
- Place it inside the server's
pluginsdirectory. - Restart the server.
- Review the generated configuration files.
- Grant players
headdb.basicor configure more granular permissions.
Open HeadDB in-game with:
/hdb
Browsing and Search
Players can browse HeadDB without relying on long or complicated commands.
The graphical interface provides:
- Category browsing
- Tags and collections
- Text search
- Advanced search filters
- Sorting
- Favorites
- Player heads
- Paginated results
- Previous, next, and back navigation
- Personal settings
Players can also search directly:
/hdb search <query>
Favorites
Players can mark frequently used heads as favorites and access them later from a dedicated menu.
Favorites are stored per player.
Player Heads
Player heads are handled separately from the public HeadDB catalog.
Administrators can independently control:
- Access to player-head functionality
- Whether players may obtain only their own head
- Whether players may obtain other players' heads
- Player-head economy pricing
- External profile lookups
Custom Heads
Custom Heads are server-local heads managed directly through HeadDB.
They are suitable for:
- Server-specific decorations
- Event rewards
- Staff heads
- Donator content
- Seasonal content
- Custom shop items
- Heads not included in the public database
Custom Heads can be created through the graphical interface or from compatible held head items and texture values.
They can be assigned to categories, tags, and collections and are stored locally for the server.
Custom Heads are not added to the public HeadDB database.
Custom Categories
Custom Categories are server-local categories used to organize curated selections of remote and custom heads.
They can be used for:
- Spawn decorations
- Event rewards
- Shop inventories
- Seasonal selections
- Staff collections
- Builder resources
- Donator rewards
Custom Categories appear alongside public database categories in the Browse menu.
Adding a head to a Custom Category does not modify its original public database category.
Custom Tags and Collections
Administrators can create local tags and collections to organize both remote and custom heads.
Custom tags and collections can be created, searched, selected, and managed through the graphical interface or supported commands.
They remain local to the server and do not modify the public database.
Administration
Admin Mode exposes additional management controls throughout the HeadDB interface.
Administrators can:
- Create and manage Custom Heads
- Create and manage Custom Categories
- Create custom tags and collections
- Edit head metadata
- Hide or restore heads
- Configure GUI buttons
- Verify or refresh the remote database
- Access runtime and diagnostic information
Local Metadata Overrides
Remote heads remain immutable in the public database, but administrators can apply local overrides for their own server.
Supported overrides include:
- Name
- Lore
- Category
- Tags
- Collections
- Visibility
Overrides can be reset without modifying the original remote data.
Economy Integration
HeadDB can optionally charge players when they obtain heads.
Economy support requires:
- Vault
- A Vault-compatible economy provider
Pricing can be configured for:
- Remote heads
- Player heads
- Remote categories
- Custom categories
- Individual heads
- A global fallback price
When economy support is disabled, heads are free.
See the HeadDB wiki for economy setup and pricing precedence.
Automatic Database Updates
HeadDB periodically checks the remote database for newly published heads.
Scheduled refreshes are enabled by default and avoid downloading database artifacts when the published catalog has not changed.
Administrators can still perform an immediate refresh:
/hdb refresh
The refresh schedule can be configured in config.yml.
Commands
Common commands include:
| Command | Description |
|---|---|
/hdb |
Opens the main HeadDB menu |
/hdb help |
Displays available commands |
/hdb search <query> |
Searches for heads |
/hdb status |
Displays database status |
/hdb refresh |
Checks for database updates |
/hdb reload |
Reloads HeadDB |
/hdb update |
Downloads an available plugin update |
Run /hdb help in-game or visit the HeadDB wiki for the complete command reference.
Permissions
For a standard player setup, grant:
headdb.basic
For complete administrative access, grant:
headdb.admin
Individual category access can be controlled with:
headdb.category.<category-id>
HeadDB also provides granular permissions for individual commands, GUI actions, player heads, custom heads, custom categories, favorites, editing, and database administration.
Some internal permission nodes retain legacy names for compatibility.
See the HeadDB wiki for the complete permission reference.
Configuration
HeadDB separates configuration by responsibility.
config.yml
Controls core plugin behavior, including:
- Remote database settings
- Local cache behavior
- Startup and scheduled refreshes
- HTTP timeouts
- Player heads
- Custom content
- Update checking
- Automatic plugin updates
- Diagnostics
gui.yml
Controls:
- Menu layouts
- Button positions
- Materials
- Head icons
- Display names
- Lore
sounds.yml
Controls configurable sound effects for:
- GUI navigation
- Head interactions
- Favorites
- Visibility changes
- Purchases
- Confirmations
- Errors
- Administrative actions
- Commands
economy.yml
Controls:
- Vault integration
- Global pricing
- Player-head pricing
- Category pricing
- Custom-category pricing
- Individual head pricing
messages/
Contains localized:
- Player-facing messages
- Command feedback
- Administrative messages
- Errors
- Interface text
Full configuration documentation is available on the HeadDB wiki.
Local Storage
HeadDB stores server-specific data locally, including:
- Custom Heads
- Custom Categories
- Custom tags and collections
- Favorites
- Player-head cache data
- Hidden heads
- Remote metadata overrides
- Draft content
Local content persists across server restarts and remains under the server owner's control.
Remote Database and Cache
HeadDB downloads a verified remote catalog containing public heads, categories, tags, collections, and revocations.
Downloaded database artifacts are stored in a local cache.
On startup, HeadDB can load the cached database immediately and then check whether a newer remote version is available.
If the remote service is temporarily unavailable, the last verified cached database remains usable.
Developer API
HeadDB exposes a public Java API through Bukkit's service provider system.
Integrations can access:
- Remote and custom heads
- Categories
- Tags
- Collections
- Search
- Favorites
- Custom Heads
- Custom Categories
- Player-head functionality
The API and core modules target Java 21.
The Paper platform module targets Java 25.
See the HeadDB wiki for dependency setup, API documentation, and integration examples.
Links
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 HeadDB
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持

评论 0
登录后参与评分
还没有评论,来抢沙发吧