Keep Head Data: Preserving Player Head Lore and Names in Minecraft 1.21+
Player heads have always been one of the most creative decorative blocks in Minecraft. Whether you use them to build a hall of fame on your server, craft custom map art, or simply display your friends' skins, those little blocks carry a ton of personality. With the Minecraft 1.21 update, Mojang finally fixed a long-standing bug that caused heads to lose their names when placed and broken. But as many builders quickly discovered, the fix wasn't complete. Important details like lore, the new item_name component, and custom data still vanish the moment you place a head down. That's where the Keep Head Data datapack steps in to save the day.
Why Player Heads Lose Their Identity in 1.21
Before 1.21, the infamous bug MC-174496 meant that any player head would lose its custom name after being placed and mined again. Mojang addressed that issue, so now a head keeps its custom_name (the one you set with an anvil) when you break it. However, the fix didn't extend to several other critical components that make heads truly unique. Lore lines, the subtle item_name replacement, and any custom_data tags are stripped away during the placement-to-item conversion. For mapmakers and server admins who rely on these details to trigger commands or tell stories, this is a huge problem. You'd place a beautifully named trophy head only to get back a generic "Player Head" with none of its original character.
What the Keep Head Data Datapack Does
This lightweight datapack acts as a seamless continuation of the popular Keep Head Names concept, fully updated for modern Minecraft mechanics. Once installed, it ensures that every player head retains its full identity when you place and mine it. The datapack works silently in the background, intercepting the block placement and breaking events to store and restore all the important item components. No commands to run, no complex setups — just drop it into your world and enjoy persistent head data.
Preserving lore and item_name
Lore is often used to add flavor text, quest hints, or server rules to items. With Keep Head Data, any lore you've added to a player head stays intact after it's been placed as a block and picked back up. Similarly, the item_name component, which was introduced in 1.21, gets the same treatment. This component replaces the item's default name without the italics of an anvil rename, and it can't be changed in survival. Without the datapack, that subtle but important detail disappears forever once the head touches the ground. Now you can confidently use item_name to label heads in your adventure maps, knowing the label will survive any building or rearranging.
Custom data and beyond
Many advanced creations use custom_data tags to store hidden information — think of unlockable achievements, NPC identifiers, or integration with command block systems. Keep Head Data ensures these tags are never lost, making it an essential tool for technical players and mapmakers who push Minecraft's limits. The datapack is designed to be future-proof; because it hooks into vanilla mechanics in a non-invasive way, it's unlikely to break with minor updates. The creator notes that you shouldn't expect frequent updates simply because the pack is built to last.
item_name vs custom_name: A Quick Clarification
If you're new to 1.21's item naming changes, the difference between item_name and custom_name can be confusing. Here's a simple breakdown:
- custom_name – The name you set with an anvil. It appears in italics by default and can be removed or changed by using the anvil again. This is what most players are familiar with.
- item_name – A new component that replaces the item's original name entirely. It displays without italics and cannot be altered or removed in survival mode. Think of it as the item's true identity, set once and permanent.
Keep Head Data protects both, but the item_name preservation is especially valuable because there's no other way to recover it in survival once it's lost. If you're designing a custom head shop or a museum exhibit, this datapack guarantees that every head on display remains exactly as you intended, no matter how many times it's moved.
Installing Keep Head Data in Your World
Adding the datapack to your singleplayer world or server is straightforward. Download the datapack file from popular Minecraft community platforms and place it in your world's datapacks folder. After a quick /reload, the pack activates and begins protecting your heads immediately. If you’re looking for an even smoother experience, you can install this datapack directly through the foxygame.net launcher, a convenient, flexible, and modern Minecraft launcher that lets you browse and download mods and datapacks right from its menu without digging through folders manually. Once you've added it, just place any player head, break it, and check its components — everything will be exactly as it was.
Because the datapack only affects player heads, it won't interfere with other blocks or mechanics. It's compatible with most other datapacks and mods, making it a safe addition to even heavily customized worlds. There's no performance impact to worry about, as the logic only runs when a player head is placed or broken.
Conclusion
Minecraft 1.21 brought a welcome fix for player head names, but it left a gap that frustrated builders and mapmakers alike. The Keep Head Data datapack bridges that gap perfectly by preserving lore, item_name, and custom_data components through placement and mining. It's a simple, elegant solution that respects your creativity and saves you from tedious re-application of item details. Whether you're running a bustling multiplayer server, crafting an intricate adventure map, or just want your trophy room to stay accurate, this datapack deserves a spot in your world. Install it once and never worry about losing head data again.