Head Database

Thousands of custom Minecraft heads

Загрузки: 2K
Подписчики: 5
Обновлён: 21 марта 2026 г.
Лицензия: GPL-3.0-only

Опубликован 11 марта 2026 г.

Исходный код Сообщить об ошибке

A collection of heads in a GUI menu

Features

Massive Head Library Browse thousands of player heads, from popular themes to custom community submissions.
Lightweight API Decoupled headdb-api module keeps your plugin lean—no extra dependencies at runtime.
Async Loading The database loads on a background thread.
Flexible Querying Search by name, ID,category, or tags.

Head Database is a powerful Minecraft plugin that provides instant access to thousands of custom decorative heads directly in-game through an intuitive GUI menu. Players and administrators can browse categorized collections of heads and place them in the world without needing to manually search for textures or commands. This makes it easy to decorate builds, create themed areas, design custom maps, or enhance server gameplay with unique visual elements.

The plugin connects to a centrally maintained database containing thousands of player heads, all organized into easy-to-navigate categories. New heads can be requested and added to the global database so the entire community can benefit. Servers can also upload and manage their own private heads, allowing them to maintain exclusive collections for custom events, crates, or server-specific content.

Head Database is designed to save time and simplify access to custom heads that would otherwise require manual commands, external websites, or texture lookups. With instant in-game browsing, simple placement, and continuous database updates, it provides a convenient and scalable solution for servers that want a large library of decorative heads available at any time.

A category of heads in a GUI menu reading "Country Flags"

Before installing, server owners should note that the plugin relies on an online head database to fetch and organize head textures. An internet connection is required for accessing the shared database and retrieving new heads.

API

Head Database has a powerful API, learn more about it in our GitHub Documentation

To get started with Maven:

<repositories>
    <repository>
        <id>bitworks-repo</id>
        <url>https://nexus.bitworksmc.com/repository/maven-releases/</url>
    </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>com.bitworksmc</groupId>
    <artifactId>headdb-api</artifactId>
    <version>VERSION</version>
  </dependency>
</dependencies>

To get started with Gradle:

repositories {
    mavenCentral()
    maven { url 'https://nexus.bitworksmc.com/repository/maven-releases/' }
}

dependencies {
    implementation "com.bitworksmc:headdb-api:VERSION"
}

Ченджлог

6.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 21 марта 2026 г.

HeadDB 6.0.1 Changelog

Last updated: March 18, 2026
Release status: In progress

Fixes (Permissions)

Added support for headdb.category.* as a global category permission.
Added support for headdb.category as a parent permission for all categories.
Unified category permission checks across main menu, local heads, favorites, and custom categories.
Fixed default category checks so category names with spaces/symbols can be granted via normalized permission nodes.
Fixed custom category permission validation to use the custom category identifier instead of the object instance string.
Standardized favorites permission around headdb.category.favorites while keeping headdb.favorites as a backward-compatible alias.

Permission Tree Updates

Updated plugin.yml to add:
- headdb.category
- headdb.category.*
- headdb.category.favorites
Updated headdb.admin children to include category-wide nodes.
Linked headdb.favorites to headdb.category.favorites for compatibility with existing setups.

6.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 11 марта 2026 г.

HeadDB 6.0.0 Changelog

Last updated: March 11, 2026 Release status: In progress

CI/CD Updates (March 11, 2026)

Added Maven distributionManagement to headdb-api/pom.xml for:
- nexus-releases (https://nexus.bitworksmc.com/repository/maven-releases/)
- nexus-snapshots (https://nexus.bitworksmc.com/repository/maven-snapshots/)
Replaced the old build upload pipeline with .github/workflows/publish.yml to deploy headdb-api on master pushes and manual runs.
Added .github/workflows/release.yml to build on v* tags (or manual tag input) and create GitHub Releases using changelog/<version>.md when available.

Additional Updates (March 11, 2026)

Made the Discord join message clickable in chat (open_url) from:
- Main menu info item
- Heads GUI info item
- Favorites GUI info item
- Local Heads GUI info item
- Custom Categories GUI info item
Updated main menu control slots:
- More Categories moved to slot 47
- Search moved to slot 48
- Local Heads moved to slot 50
- Favorites moved to slot 51

Pending Commit Summary

refactor: migrate HeadDB to com.bitworksmc with legacy API support

Pending Commit Description

Moved plugin source packages from com.github.thesilentpro.headdb.* to com.bitworksmc.headdb.*.
Updated plugin main class references and build metadata to the new package namespace.
Switched Maven project coordinates for this project to com.bitworksmc.
Introduced new API namespace under com.bitworksmc.headdb.api.*.
Kept legacy API namespace (com.github.thesilentpro.headdb.api.*) for migration and marked it as deprecated.
Added a runtime adapter to register both legacy and modern HeadAPI services in Bukkit.
Updated documentation and release notes to reflect the migration and compatibility path.

Highlights

Full v6 rewrite foundation was introduced.
Added/expanded config system work (config manager, sound config, head customization, item factory relocation).
Added Folia 1.21.11 support and related compatibility fixes.
Head database source moved to a configurable URL option.
Menu pagination issues were fixed.
Vault economy integration was modernized to work with VaultUnlocked API expectations, with safer fallback behavior.
Project namespace migration started from com.github.thesilentpro to com.bitworksmc.

Breaking Changes (6.0.0)

Primary plugin code package moved to com.bitworksmc.headdb.*.
Bukkit plugin main class changed to com.bitworksmc.headdb.core.HeadDB.
Maven project group changed to com.bitworksmc.
Primary API namespace is now com.bitworksmc.headdb.api.*.

Compatibility Notes

Legacy API package com.github.thesilentpro.headdb.api.* is still present for migration and marked @Deprecated(forRemoval = true, since = "6.0.0").
HeadDB now registers both API service interfaces in Bukkit ServicesManager:
- com.bitworksmc.headdb.api.HeadAPI (new)
- com.github.thesilentpro.headdb.api.HeadAPI (legacy adapter)

Migration Guide

Update imports from com.github.thesilentpro.headdb.* to com.bitworksmc.headdb.*.
Update dependency coordinates to com.bitworksmc:*.
Move service lookups to com.bitworksmc.headdb.api.HeadAPI.
Keep legacy imports only temporarily while migrating; they are deprecated for removal.

Commit History Included In 6.0.0 Line

cd526e7 v6 rewrite
d072e51 Update jitpack.yml
97e0d7e Update README.md
9df1f6d Added sounds.yml Added head customization Added config manager Added (and relocated) item creation to item factories
a15cbe7 Merge remote-tracking branch 'origin/master'
84e316d feat: add Folia 1.21.11 support and fix head name rendering
3f1c4df Update HDBCommandSearch.java
8b2ff96 Merge pull request #1 from EarthPol/folia
127cc75 Migrate head database json to a config option url
9091ba2 Update heads.json
a8c0de6 Fix pagination on menu
3f81e57 Migrate to Bitworks - Fix Vault

Working Tree Updates Tracked For 6.0.0 (Pending Commit)

Added new API namespace interfaces:
- com.bitworksmc.headdb.api.HeadAPI
- com.bitworksmc.headdb.api.HeadDatabase
- com.bitworksmc.headdb.api.model.Head
Added legacy runtime adapter:
- com.bitworksmc.headdb.core.api.LegacyHeadAPIAdapter
Updated docs and build metadata to point to com.bitworksmc coordinates and package paths.
Updated plugin metadata and shade main class references to the new namespace.