
Heirlooms
Engrave unstackable crafted items with a tooltip containing their history
About this Mod
This description is up to date with the most recent version of Minecraft that the mod supports.
Features may be modified or missing in earlier versions.


About
Heirlooms gives your crafted items a history, then lets you display them like keepsakes
inside your world.
- Adds craft-date and creator-name tooltips to unstackable crafted & enchanted items
- Keeps the extra tooltip hidden until CTRL or ALT is held
- Works with crafted, smithing-table and enchanting-table items from other mods
- Adds Display Cases and Display Racks for showing off your favourite items in-world
New Tooltips
Your unstackable crafted items get a special tooltip showing:
- the date the item was crafted
- the name of the player who crafted it
New Blocks
Heirlooms adds two new blocks, which are perfect for holding your favourite items and elevating their symbolic importance:
- Display Case - showcase your items in a glass enclosure
- Display Rack - show your items on a wooden rack
Both blocks show information about the item, including the tooltip information the mod adds, when a player looks at the block in-world.
Tooltips
Any item that you craft which can't be stacked will receive an heirloom tooltip. Popular examples would include tools, weapons and armour.

Hidden by default
The tooltip information is only shown when holding down the CTRL or ALT keys while hovering over the item.

Supports modded items
As long as the item is made in a crafting table or a smithing table, or enchanted in an enchanting table, it should work, no matter the mod.
This example shows an item from Basic Weapons

Blocks
Heirlooms adds two blocks to show off your items with:

Display Case
The display case is a full-sized block and shows items on the wooden plate in the center.
- Perfect for blocks

Display Rack
The display rack is a small block and shows items at an angle.
- Perfect for tools, weapons, armour

Rendering Differences
The display case and rack render some items differently to each other. If an item is a block with a custom item texture (e.g. sugar cane, torch, sign) the display case will show the block model, while the rack shows the gui sprite:

Frequently Asked Questions
Is there a (fabric/forge/neoforge/risugami's modloader) version?
Heirlooms exists on both Fabric and NeoForge. If you're running Quilt, use the Fabric jar.
Can you backport the mod to Minecraft 1.X.X?
Heirlooms will not be backported. The mod will however support new major versions of Minecraft.
I found a bug / my game crashed
If you find any problems with Heirlooms, please feel encouraged to create an issue on the GitHub
repository issue tracker. Bug reports are incredibly useful and help this mod reach its full potential.
Available Versions
How to Install Heirlooms on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Heirlooms". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+2 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Heirlooms server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Heirlooms compatible with fabric and forge and neoforge?
Heirlooms officially supports fabric, forge, neoforge for Minecraft 1.21.11, 1.21.10, 1.21.9. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Heirlooms – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Heirlooms consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Heirlooms with just one click on your server.



