Back to mods
Head Index project artwork

CurseForge · Minecraft mod

Head Index

An easy to user server-side head database mod for the Fabric Loader.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Head Index release should I use?

Updated yesterday
Latest stable file 1.2.2
Game version 26.3
Loader Fabric, Quilt

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.

Client Not supported
Dedicated server Required
Loader for this release Fabric, Quilt
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by Head Index 1.2.2
required
Matching file found Matched file: 0.161.0+26.3

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.

  1. 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.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 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 OP
  • headindex.search - Grants /head search and button in GUI - Defaults to level 2 OP
  • headindex.playername - Grants custom heads in GUI - Defaults to level 2 OP

Powered By

Minecraft Heads

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.

61 available setups

Showing 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

31 of 31 releases match

Looking for an older file? The official CurseForge project page is in Resources.