HeadDB icon

HeadDB -----

Database with thousands of custom heads.



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.


Using the API

1. Adding the Dependency

HeadDB publishes its API module via our own Nexus Maven Repo.

Maven
Code (Text):

<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>
 
Gradle
Code (Text):

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

dependencies {
    implementation "com.bitworksmc:headdb-api:VERSION"
}
 
Resource Information
Author:
----------
Total Downloads: 21
First Release: Mar 11, 2026
Last Update: Mar 21, 2026
Category: ---------------
All-Time Rating:
0 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings