HeadDB

Features

• More than 100,000 Minecraft heads
• Categories, tags, and collections
• Fast text search with advanced filtering and sorting
• Modern inventory-based navigation
• Favorites
• Player heads
• Custom heads and custom categories
• Custom tags and collections
• Local metadata overrides
• Optional Vault economy integration
• Granular permissions
• In-game administration
• Configurable GUIs, messages, and sounds
• Automatic remote database updates
• Verified local caching and offline fallback
• Paper and Folia support
• Public Java API

Requirements

• Java 25 or newer
• Paper or Folia
• Network access for the initial database download and future updates

After a successful database download, HeadDB can load its verified local cache when the remote database is temporarily unavailable.


Installation

1. Download the latest HeadDB plugin JAR.
2. Place it inside the server's plugins directory.
3. Restart the server.
4. Review the generated configuration files.
5. Grant players headdb.basic or configure more granular permissions.

Open HeadDB in-game with:


Browsing and Search

Players can browse HeadDB without relying on long or complicated commands.

The graphical interface provides:

• Category browsing
• Tags and collections
• Text search
• Advanced search filters
• Sorting
• Favorites
• Player heads
• Paginated results
• Previous, next, and back navigation
• Personal settings

Players can also search directly:


Favorites

Players can mark frequently used heads as favorites and access them later from a dedicated menu.

Favorites are stored per player.


Player Heads

Player heads are handled separately from the public HeadDB catalog.

Administrators can independently control:

• Access to player-head functionality
• Whether players may obtain only their own head
• Whether players may obtain other players' heads
• Player-head economy pricing
• External profile lookups

Custom Heads

Custom Heads are server-local heads managed directly through HeadDB.

They are suitable for:

• Server-specific decorations
• Event rewards
• Staff heads
• Donator content
• Seasonal content
• Custom shop items
• Heads not included in the public database

Custom Heads can be created through the graphical interface or from compatible held head items and texture values.

They can be assigned to categories, tags, and collections and are stored locally for the server.

Custom Heads are not added to the public HeadDB database.

Read the full description on SpigotMC →