Skip to content

index.md

Latest commit

 

History

History
51 lines (42 loc) · 2.37 KB

index.md

File metadata and controls

51 lines (42 loc) · 2.37 KB
Raw
layout home
hero
name text tagline actions
HeadDB
Modern head database for Paper and Folia
Browse, search, favorite, price, customize, and obtain more than 100,000 Minecraft heads through a clean GUI.
theme text link
brand
Get Started
/getting-started
theme text link
alt
Commands
/commands
theme text link
alt
Browse Heads
features
title details
Player-focused GUI
Browse categories, search heads, manage favorites, and obtain heads without command-heavy workflows.
title details
Server-owner control
Configure permissions, messages, GUI layout, sounds, economy pricing, custom content, and administrative tools.
title details
Automatic database updates
Loads verified remote data, checks for catalog updates automatically, and keeps a local cache for resilient startup.
title details
Paper and Folia
Built for modern Paper-compatible servers with Folia-safe scheduling and Java 25 support.
title details
Local customization
Create Custom Heads, Custom Categories, tags, collections, favorites, and metadata overrides without modifying public data.
title details
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

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

Continue with Installation or Getting Started.