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