🤯 Hazar's Head Library

A modern, Kotlin-powered Minecraft mod for collecting and giving custom heads!

See bottom of desc for api version updates

📦 Features

• 🔍 In-game searchable head index (Dex style!)
• 👥 Supports:
  • Vanilla player heads (via player name or UUID)
  • Custom texture heads (via base64 textureValue)
  • Custom player heads (via Player Entities)
  • ⚡ Async profile fetching (non-blocking, smooth AF)
  • 🛠️ Extensible data format (add your own heads via JSON) for devs

🧠 In-Game Commands

/heads

You must be in Creative mode to access the head menu!

📚 Submitting New Heads

Wanna contribute a cool head texture? click the source code link and follow the read me in the main branch

Side

This mod is fully Client and Server Friendly

API

If youd like to use this as an api, refrence it via the Modrinth Maven

• A full tutorial can be found on the source code branch for your chosen version

V1.1.0

• Added Config:
  • requiresCreative - Bool
  • useCurrency - Bool
  • itemCurrencyJson - String
  • currencyAmount - Int
  • permissionLevelCommandReload - Int
  • permissionLevelCommandInfo - Int
  • permissionLevelCommandUI - Int

  itemCurrencyJson and currencyAmount are optional if useCurrency = false

• Added luckperm support
  • hhl.headdex.reload - reload config command
  • hhl.headdex.info - info command (outputs mod version)
  • hhl.headdex.ui - open head ui