promotional bannermobile promotional banner

Head Database

A server-side mod that enables players to retrieve all different kinds of textured player heads.

Title

mc-versions   forge   fabric

đŸ—ŋ Head Database

A server-side mod (also usable in singleplayer) that enables players to retrieve all different kinds of textured player heads, which are great for decoration.

🆕 What does it add?

Access to about 85k different player heads in modded environments!

Commands

/hdb

  • Opens the Head Database menu
  • First, a list of categories is shown
  • Once a category is clicked, a paginated view of categorized player heads is shown
  • Clicking any head will give it to the player

Command showcase

/hdb search <...>

  • Opens a menu with search results
  • Includes search term matches in name and tags of the individual heads
  • You can use multiple search terms by separating them with spaces

Search command showcase

/hdb reload

  • Reloads the config

âš™ī¸ Configuration

The configuration file is located at:

Forge

Client Server
.minecraft/saves/<world_name>/serverconfig/head_database-server.toml <server_folder>/world/serverconfig/head_database-server.toml

Fabric

.minecraft/config/head-database-server.json

Options

mode

  • Specifies which permission mode to use (who is allowed to use the command?)
  • Can be either of:
    • OP_ONLY: Operators only
    • WHITELIST: Operators and additional whitelisted players
    • EVERYONE: Everyone can run the commands

required_op_level

  • Specifies the required operator level (0-4) when using either OP_ONLY or WHITELIST mode

whitelist

  • List of non-operator player names or UUIDs allowed to use the command when using WHITELIST mode

â„šī¸ /hdb reload can only be used by operators, regardless of config values

🌐 Where does the data come from?

The database is fetched from the public domain repository at https://github.com/TheSilentPro/heads. When the server starts (internal or dedicated), this ~15 MB JSON file is downloaded and parsed.

The Head Database Team

profile avatar
Owner
  • 3
    Followers
  • 6
    Projects
  • 1.3M
    Downloads

More from 3xpl01tView all

  • Golem Overhaul project image

    Golem Overhaul

    • 1.5M
    • Mods

    A mod which overhauls the vanilla golems!

    • 1.5M
    • January 18, 2026
    • Mods
    • +2
  • Create: Mob Spawners project image

    Create: Mob Spawners

    • 1.1M
    • Mods

    An addon for the Create mod for Minecraft. It adds a tool that can catch mobs which can then be placed into a Mechanical Spawner.

    • 1.1M
    • December 17, 2025
    • Mods
    • +2
  • Mercantile project image

    Mercantile

    • 233
    • Mods

    Adds a simple currency system with optional Create 6+ integration

    • 233
    • December 5, 2025
    • Mods
    • +2
  • Looter's Compass project image

    Looter's Compass

    • 157.5K
    • Mods

    Adds a compass that points to the nearest un-opened loot container from the Lootr mod.

    • 157.5K
    • November 7, 2025
    • Mods
  • Golem Overhaul project image

    Golem Overhaul

    • 1.5M
    • Mods

    A mod which overhauls the vanilla golems!

    • 1.5M
    • January 18, 2026
    • Mods
    • +2
  • Create: Mob Spawners project image

    Create: Mob Spawners

    • 1.1M
    • Mods

    An addon for the Create mod for Minecraft. It adds a tool that can catch mobs which can then be placed into a Mechanical Spawner.

    • 1.1M
    • December 17, 2025
    • Mods
    • +2
  • Mercantile project image

    Mercantile

    • 233
    • Mods

    Adds a simple currency system with optional Create 6+ integration

    • 233
    • December 5, 2025
    • Mods
    • +2
  • Looter's Compass project image

    Looter's Compass

    • 157.5K
    • Mods

    Adds a compass that points to the nearest un-opened loot container from the Lootr mod.

    • 157.5K
    • November 7, 2025
    • Mods