Powered by Minecraft-Heads

ReHeaded

Browse custom heads directly in-game, preview and rotate them, and use selector books for survival-friendly head conversion.

Fabric • Powered by Minecraft-Heads API v2

✨ Description

ReHeaded is a Fabric mod that lets you browse custom heads directly in-game using the Minecraft-Heads API v2.

Use /reheaded or /rh to open the browser, search through the catalog, preview heads, rotate them, and pick exactly what you want without ever leaving Minecraft. The browser is clean, fast, and uses caching so everything feels smooth instead of laggy or clunky.

In Creative mode, you just get the head instantly. In Survival mode, it creates a selector book so you can convert heads in a more vanilla-friendly way.

There is also a built-in guide and a written book workflow, so once you learn it once, it just clicks and becomes part of normal gameplay.

🚀 Features

• In-game custom head browser
• Commands: /reheaded and /rh
• Minecraft-Heads API v2 catalog browsing
• Search, paging, preview, and caching
• Minecraft username lookup for player heads
• Head rotation and orientation support
• Creative mode instant head delivery
• Survival mode selector books
• Written book → selector book conversion
• Built-in ReHeaded Guide (in-game help)
• Settings screen for preview and conversion effects
• Snapshot-based caching for better performance
• Operator/LAN refresh system with cooldown + status info
• Dropped and placed head/skull conversion
• Particle + sound effects during conversion

🧠 How It Works

🔍 Browser Workflow

1. Run /reheaded or /rh
2. Search for a head or enter a username
3. Preview it and rotate it how you want
4. In Creative → you get it instantly
5. In Survival → it creates a selector book
6. Use that book on a supported head to convert it

📘 ReHeaded Guide

ReHeaded has a built-in help system called the ReHeaded Guide.

If you are playing vanilla (without the client mod), you can still get the guide.

To get it, just sign a book and quill with the title ReHeaded Guide.

It will give you the guide in-game and walk you through selector books, written-book setup, and settings.

If you forget how something works, this is where you check.

📖 Written Book Workflow

1. Make and sign a book and quill
2. Put this on the first line:
   Head Conversion Book
3. Add a minecraft-heads link, username, or UUID
4. Keep the book in your inventory
5. It converts into a selector book automatically
6. Use it on a head to apply it

🧱 Supported Conversion Targets

• Player Head
• Creeper Head
• Zombie Head
• Skeleton Skull
• Wither Skeleton Skull
• Dragon Head
• Piglin Head

⚙️ Requirements

• Fabric Loader
• Fabric API

🌐 Network Use

ReHeaded uses:

• Minecraft-Heads API v2 (for the head catalog)
• Mojang profile/session services
• textures.minecraft.net

It does not scrape minecraft-heads.com.
Everything comes from the API and is cached locally so it is faster and does not spam requests.

🙌 Attribution

• Minecraft-Heads API v2 for the live head catalog and custom-head link resolution
• Mojang profile and session services for player head lookup
• textures.minecraft.net for texture delivery used by previews and player heads
• The overall workflow was also inspired by Custom Heads

Links

• Report Issues
• Minecraft-Heads
• Minecraft-Heads API v2
• Mojang
• Custom Heads

ReHeaded is an independent mod and is not affiliated with Minecraft-Heads.com.
Use of third-party services and content is subject to their terms.

📜 License

ReHeaded CU and PCL