HeadDBModern head database for Paper and Folia

Browse, search, favorite, price, customize, and obtain more than 100,000 Minecraft heads through a clean GUI.

Get Started

Commands

Browse Heads

Player-focused GUI

Browse categories, search heads, manage favorites, and obtain heads without command-heavy workflows.

Server-owner control

Configure permissions, messages, GUI layout, sounds, economy pricing, custom content, and administrative tools.

Automatic database updates

Loads verified remote data, checks for catalog updates automatically, and keeps a local cache for resilient startup.

Paper and Folia

Built for modern Paper-compatible servers with Folia-safe scheduling and Java 25 support.

Local customization

Create Custom Heads, Custom Categories, tags, collections, favorites, and metadata overrides without modifying public data.

Public API

Integrate through the public API module instead of depending on implementation internals.

What HeadDB provides

HeadDB is a Minecraft head database plugin for Paper and Folia servers. It gives players a polished inventory interface for browsing, searching, favoriting, optionally purchasing, and obtaining head items while giving server owners precise control over access and behavior.

The public catalog contains more than 100,000 heads and is organized through categories, tags, and collections. Server-specific content remains local and persists independently from the public database.

This documentation covers installation, commands, permissions, configuration, GUI usage, economy, updates, local data, API integration, and troubleshooting.

Recommended path

Install HeadDB and start the server once.
Review the generated files under plugins/HeadDB/.
Grant headdb.basic to players and headdb.admin only to trusted staff.
Configure economy pricing if heads should cost money.
Run /hdb status and /hdb verify.
Open /hdb and test the player workflow.

Continue with Installation or Getting Started.