

Modrinth · Fabric, Quilt
Head Index on your Minecraft server
Head Index runs on Minecraft servers with Fabric or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
An easy to use, server-side head database mod for the Fabric Loader.
- Downloads
- 52.8K
- Author
- Potatoboy9999
- Loader
- Fabric, Quilt
- Minecraft
- 1.16.5 – 26.3
- Updated
- –
Setup
Install Head Index on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Quilt and choose the matching Minecraft version, for example 26.3.
- 03
Install the mod
Search the mod browser for “Head Index” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Head Index is not needed on the client. Players connect using the server address from the panel.
- On the server
- Required
- On the client
- Not needed
- Loader
- Fabric, Quilt
- Minecraft
- 26.3, 26.2, 26.1.2 +29 more
- License
- MIT License
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Head Index · Modrinth- 1.2.2September 26, 2026Minecraft 26.3 · Fabric, Quilt
- 1.2.1June 28, 2026Minecraft 26.2 · Fabric, Quilt
- 1.2.0June 28, 2026Minecraft 26.1.1, 26.1.2, 26.2 · Fabric, Quilt
- 1.1.14December 17, 2025Minecraft 1.21.11 · Fabric, Quilt
- 1.1.13October 11, 2025Minecraft 1.21.10 · Fabric, Quilt
Original description by the project author
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
Head Index server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Head Index run on?
According to Modrinth, Head Index supports Fabric, Quilt for Minecraft 26.3, 26.2, 26.1.2.
How much RAM does a server with Head Index need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Client only
Iris Shaders
by coderbot
A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs
Client only
[ETF] Entity Texture Features
by Traben
Emissive, Random & Custom texture support for entities in resourcepacks just like Optifine but for Fabric
Client only
[EMF] Entity Model Features
by Traben
EMF is an, OptiFine format, Custom Entity Model replacement mod available for Fabric and Forge.
Client only
Not Enough Animations
by tr7zw
Bringing first-person animations to the third-person
Ready for your server with Head Index?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.