HeadDatabase

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

<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

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

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