CurseForge · Minecraft mod
Head Index
An easy to user server-side head database mod for the Fabric Loader.
Quick answer
Which Head Index release should I use?
Head Index 1.2.2 targets 26.3 with Fabric, Quilt. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.
Where it goes
Is Head Index required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does Head Index 1.2.2 need?
1.2.2. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Head Index without breaking your instance.
Built for Head Index 1.2.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.2.2. It targets 26.3 with Fabric, Quilt; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.2.2. It opens that exact file at the source.
About this project
What does Head Index add?
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
Project description from CurseForge.
Pick your setup
Head Index by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
2 loader builds26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader buildsShowing the newest 12 of 34 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Head Index versions and loaders
1.2.2
headindex-1.2.2.jar
26 Sept 2026
1.2.1
headindex-1.2.1.jar
28 Jun 2026
1.2.0
headindex-1.2.0.jar
28 Jun 2026
1.1.14
headindex-1.1.14.jar
17 Dec 2025
1.1.13
headindex-1.1.13.jar
11 Oct 2025
1.1.12
headindex-1.1.12.jar
10 Oct 2025
1.1.11
headindex-1.1.11.jar
1 Aug 2025
1.1.10
headindex-1.1.10.jar
20 Jul 2025
1.1.9
headindex-1.1.9.jar
16 Apr 2025
1.1.8
headindex-1.1.8.jar
20 Nov 2024
1.1.7
headindex-1.1.7.jar
18 Jun 2024
1.1.6
headindex-1.1.6.jar
4 Jun 2024
Looking for an older file? The official CurseForge project page is in Resources.


