Head Database

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.

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"
}