About Head Index
From ModrinthAn easy to use, server-side head database mod for the Fabric Loader.
Head Index

Head Index is an easy-to-use server-side head database mod for the Fabric Loader. Head Index provides easy access to thousands of heads provided by minecraft-heads.com. Unlike a plugin, Head Index can also be used in singleplayer without the need for a server. New heads are added all the time and will be automatically added whenever you restart the server without needing to update. Head Index also supports setting an item, xp, or economy (Common Economy API) cost for survival servers.
Head Index is powered by Minecraft Heads. To use the mod, you must enter a free license key into the config file.
Links

Features
Easy to use GUI interface

Many Different Categories

Searching

Custom Player Heads

Customizable Cost


Commands
/head- Opens head GUI/head menu- Also opens head GUI/head search <search>- Opens search menu/head player <playername>- Get a specific player head
Config
{
"_licenseComment": "Enter your license key below. Register here: https://minecraft-heads.com/wiki/minecraft-heads/api-v2-for-users",
"license": "LICENSE_HERE",
"_permissionComment": "The default permission level for the commands. Set to 0 to allow all players access",
"permissionLevel": 2,
"_economyComment": "The type of economy to use. Set to FREE to disable economy, ITEM to use an item, TAG to use a tag, ECONOMY to use an economy currency, LEVEL to use minecraft levels, or LEVELPOINTS to use level points",
"economyType": "FREE",
"_costComment": "The identifier for the item, tag or currency to use for the cost, only needed if economyType is set to ITEM, TAG, or ECONOMY",
"costType": "minecraft:diamond",
"_costAmountComment": "The amount of the item, currency or level to use for the cost",
"costAmount": 1
}
Permissions
Compatible with LuckPerms, PlayerRoles or any other fabric permission manager.
You can adjust the default permission level in the config file to allow all players access without a permission manager.
headindex.menu- Grants /head and /head menu - Defaults to level 2 OPheadindex.search- Grants /head search and button in GUI - Defaults to level 2 OPheadindex.playername- Grants custom heads in GUI - Defaults to level 2 OP
Powered By
Highlights
From source dataGame versions
Supports 32 Minecraft versions, the newest being 26.3.
Loaders
Runs on Fabric and Quilt.
Footprint
Rated a light load on a server.
What kind of mod it is
From the catalogGameplay & overhauls
New mechanics, content and overhauls that change how the game plays.
Runs on your server
From source side supportModrinth lists Head Index as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- FabricQuilt
- Runs on
- Serverrequired on the server
- Game versions
- 26.3 and 31 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-01Open ↗
- ✓AuthorPotatoboy9999, as published on Modrinth
- ✓LicenseMITFree









