SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
✓ VerifiedGameplay & overhauls

Head Index

by Potatoboy9999 · for Minecraft

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

50KDownloads
4d agoLast updated
MITLicense
Fabric · QuiltLoaders

About Head Index

From Modrinth

An 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 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

Highlights

From source data

Game 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 catalog
Listed on Modrinth as “Mods”

Gameplay & overhauls

New mechanics, content and overhauls that change how the game plays.

Runs on your server

From source side support

Modrinth 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

Head Index, answered

Generated from the mod’s own source data.

Do my players need to install Head Index?

Modrinth lists Head Index as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric and Quilt.

Is it free?

Yes. Head Index is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Head Index on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Head Index in one click.