ModsFinder

Head Index

by Potatoboy9999

Players who need a specific head for a build can search a server-side database through Head Index, which is a Fabric and Quilt mod for 1.16.5 – 26.3.

FabricQuiltServer-side onlyMIT LicenseOpen source1.16.5 – 26.3

What it does

Head Index is a head database for servers. Once installed, operators open a head menu and search heads with a search button in a GUI, then pick one from a custom heads screen. The lookup data comes from Minecraft Heads, and the mod is built on Fabric API, which must be installed next to it on both Fabric and Quilt.

The mod is server-side only, so players join a server that runs it without installing anything. Access is limited by default to operators at permission level 2, and the level can be changed in the config file. A free license key entered in that file is needed before use. Head Index works alongside LuckPerms, PlayerRoles and other Fabric permission managers, and can also be used without one by lowering the default permission level.

Builds exist for 31 release versions, with snapshot builds published as well. The latest files, 1.2.2 for 26.3, were published on 2026-09-26, and the code is open source under the MIT License.

Key features

  1. Head search GUI

    A search button opens a GUI where heads can be looked up by name and chosen from the results.

  2. Custom heads screen

    A separate screen lists custom heads, so a server can keep its own selection alongside the database.

  3. Operator-only default

    Access defaults to permission level 2, and the level is set in the config file.

  4. Permission manager support

    The mod works with LuckPerms, PlayerRoles and other Fabric permission managers for finer control.

Compatibility

Latest build for each game version and loader.

26.x4 of 4 versions with builds
26.31.2.21.2.2
26.21.2.11.2.1
26.1.21.2.01.2.0
26.1.11.2.01.2.0
1.21.x10 of 10 versions with builds
1.21.111.1.141.1.14
1.21.101.1.131.1.13
1.21.81.1.111.1.11
1.21.71.1.111.1.11
1.21.61.1.111.1.11
1.21.51.1.91.1.9
1.21.41.1.81.1.8
1.21.31.1.81.1.8
1.21.11.1.71.1.7
1.211.1.71.1.7
1.20.x6 of 6 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x1 of 1 version with builds
ReleaseBetaAlphaNot available

This mod also publishes snapshot builds. Snapshots are not shown in the matrix.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Use cases

Building and decoration servers

Builders on a creative or build server can fetch a named head without leaving the game.

Servers without a permission manager

Lowering the access level in the config file lets players reach the menu without a separate manager installed.

Who it’s for: Server owners who want a head database for their players, and builders who need a particular head for decoration work.

How it compares

Full comparison

Minecraft Heads Browser is a client-side only Fabric mod for 1.21 – 1.21.5, released under the GNU General Public License v3.0 only. Anvil Heads is a server-side only Fabric mod for 1.20.1 – 1.20.2 under the MIT License. Head Index runs on the server alone and covers a much wider set of versions.

ModLoadersGame versionsEnvironmentUpdated
Head IndexFabric and Quilt1.16.5 – 26.3Server-side only2026-09-26
Minecraft Heads BrowserFabric1.21 – 1.21.5Client-side only2025-05-21
Anvil HeadsFabric1.20.1 – 1.20.2Server-side only2023-09-29

Questions

Does Head Index need Fabric API?

Yes. Fabric API is a required dependency, and it must be installed alongside Head Index on Fabric and Quilt servers.

Do players need to install Head Index?

No. Players join without it, since only the server has to run the mod.

Where is the license key entered?

The free license key is entered in the mod's config file before the mod can be used.

Can Head Index work without a permission manager?

Yes. The default permission level can be adjusted in the config file so players reach the menu without LuckPerms or another manager.

In the catalog

Head Index is one of 12,078 Decoration mods on ModsFinder, and one of 6,982 Decoration mods for Fabric. 8,071 mods support Minecraft 26.3.

More from Potatoboy9999

All projects

Similar mods

What the author says

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…
Potatoboy9999, on the Modrinth page

Official listing

Owner
Potatoboy9999
Published
2021-05-18
Updated on Modrinth
2026-09-26
Facts verified
2026-10-15

Tags