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.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

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

  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.

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

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

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.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

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

FAQ

Head Index questions

Question not listed? Ask our team.

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.

Ready for your server with Head Index?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server