![](\"https:\/\/raw.githubusercontent.com\/PotatoPresident\/HeadIndex\/master\/images\/banner.png\")
<\/p>\n# Head Index<\/p>\n
<\/p>\n
Head Index is an easy-to-use server-side head database mod for the Fabric Loader.
\nHead Index provides easy access to thousands of heads provided by minecraft-heads.com.
\nUnlike a plugin, Head Index can also be used in singleplayer without the need for a server.
\nNew heads are added all the time and will be automatically added whenever you restart the server without needing to update.
\nHead Index also supports setting an item, xp, or economy (Common Economy API) cost for survival servers.<\/p>\n
Head Index is powered by Minecraft Heads.
\nTo use the mod, you **must** enter a free license key into the config file.<\/p>\n
## Links<\/p>\n
![](\"https:\/\/i.imgur.com\/T8cKQeG.png\")
<\/p>\n
![](\"https:\/\/i.imgur.com\/WXeGIUy.png\")
<\/p>\n
—<\/p>\n
![](\"https:\/\/i.imgur.com\/7xolbTP.png\")
<\/p>\n
## Features<\/p>\n
### Easy to use GUI interface
\n![](\"https:\/\/i.imgur.com\/ZdNQBnQ.gif\")
<\/p>\n
### Many Different Categories
\n![](\"https:\/\/i.imgur.com\/iBgjiww.gif\")
<\/p>\n
### Searching
\n![](\"https:\/\/i.imgur.com\/TdbRJlF.gif\")
<\/p>\n
### Custom Player Heads
\n![](\"https:\/\/i.imgur.com\/HdOtuBP.gif\")
<\/p>\n
### Customizable Cost
\n![](\"https:\/\/shx.is\/5W4KcTBr0.gif\")
<\/p>\n
—<\/p>\n
![](\"https:\/\/i.imgur.com\/54cCFHp.png\")
<\/p>\n
## Commands<\/p>\n
– `\/head` – Opens head GUI —<\/p>\n ## Config<\/p>\n “`json —<\/p>\n ## Permissions<\/p>\n Compatible with LuckPerms, PlayerRoles or any other fabric permission manager.<\/p>\n You can adjust the default permission level in the config file to allow all players access without a permission manager.<\/p>\n – `headindex.menu` – Grants \/head and \/head menu – Defaults to level 2 OP —<\/p>\n ## Powered By<\/p>\n An easy to use, server-side head database mod for the Fabric Loader.<\/p>\n","protected":false},"featured_media":79936,"template":"","meta":{"_minecraft_slug":"headindex","_minecraft_project_id":"mEPmyd7J","_minecraft_author":"Potatoboy9999","_minecraft_license":"MIT","_minecraft_downloads":40320,"_minecraft_follows":152,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headindex.zip","_minecraft_size_bytes":117946096,"_minecraft_version_count":32,"_minecraft_updated_at":"2026-05-16T21:28:35.663769Z","_minecraft_date_created":"2021-05-18T03:47:30.101127Z","_minecraft_date_modified":"2025-12-17T19:55:50.229044Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headindex","_minecraft_icon_attachment_id":79936,"_minecraft_imported_at":"2026-06-04T14:33:39+00:00","_minecraft_import_hash":"c5402c7b0d4cf3162ae9447456c0010e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,97,98,92],"mod_loader":[99,100],"minecraft_version":[48,49,50,51,625,52,53,54,55,56,57,58,59,36,60,94,101,102,62,37,40,41,74,38,78,79,80,81],"class_list":["post-79935","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-fabric","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-rc3","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n– `\/head menu` – Also opens head GUI
\n– `\/head search
\n– `\/head player
\n{
\n “_licenseComment”: “Enter your license key below. Register here: https:\/\/minecraft-heads.com\/wiki\/minecraft-heads\/api-v2-for-users”,
\n “license”: “LICENSE_HERE”,
\n “_permissionComment”: “The default permission level for the commands. Set to 0 to allow all players access”,
\n “permissionLevel”: 2,
\n “_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”,
\n “economyType”: “FREE”,
\n “_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”,
\n “costType”: “minecraft:diamond”,
\n “_costAmountComment”: “The amount of the item, currency or level to use for the cost”,
\n “costAmount”: 1
\n}
\n“`<\/p>\n
\n– `headindex.search` – Grants \/head search and button in GUI – Defaults to level 2 OP
\n– `headindex.playername` – Grants custom heads in GUI – Defaults to level 2 OP<\/p>\n![\"Minecraft](\"https:\/\/cdn.modrinth.com\/data\/cached_images\/f39d5c338260643a07fab8653d072bf4f6a2db57_0.webp\")
<\/p>\n","protected":false},"excerpt":{"rendered":"