
Head Index
An easy to use, server-side head database mod for the Fabric Loader.
About this Mod
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
Available Versions
How to Install Head Index on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Head Index". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.8 (+25 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Head Index server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Head Index compatible with fabric and quilt?
Head Index officially supports fabric, quilt for Minecraft 1.21.11, 1.21.10, 1.21.8. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Head Index – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Head Index consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Head Index with just one click on your server.