LibTooltips: Custom Item Tooltips for Minecraft Mods

LibTooltips lets modders add colorful, multi-line item tooltips with no code needed for Minecraft. Download LibTooltips and customize every item today.

LibTooltips

Item tooltips are one of the most underrated parts of Minecraft. They tell you what a sword does, which enchantment is on your pickaxe, and whether that mysterious gem is worth keeping. But for mod developers, hardcoding tooltip text is tedious, and for modpack creators, customizing those tooltips usually means digging into config files or writing Java. LibTooltips changes that entirely. It is a lightweight library that turns tooltips into simple translation-key entries, so anyone can add rich, colorful, multi-line descriptions to items without touching a single line of code.

What Is LibTooltips for Minecraft?

LibTooltips is an API that drives tooltips through translation keys. Instead of writing code, you define entries in a language file using a predictable naming pattern, and the library handles the rest. A basic example looks like this:

  • "tooltip.minecraft.diamond.0": "Such a fancy <ltrgb>rgb rainbow</ltrgb> tooltip!"
  • "tooltip.minecraft.diamond.1": "And look, it even supports several lines, wow"

Each numbered key becomes a new line in the tooltip. The library also processes basic tags, which means you can change colors, adjust formatting, and even alter text dynamically. That rainbow RGB effect above is not a gimmick; it is a real tag that LibTooltips parses and renders in-game.

Permanent Tooltips

Beyond standard hover text, LibTooltips supports permanent tooltips that always display on an item. Using the "tooltip.always" prefix, you can attach information that stays visible no matter what:

  • "tooltip.always.minecraft.diamond.0": "This tooltip will always show!"

This is ideal for quest items, guide books, or any gear that needs a constant reminder attached to it.

Supported Minecraft Versions and Mod Loaders

LibTooltips is built for modern Minecraft and works across the major mod loaders, including Fabric and NeoForge. Because it is designed as a library rather than a standalone content mod, it slots cleanly into existing setups. Version support generally tracks the current release cycle, so players on recent Minecraft builds can expect compatibility without extra patches. If you are running an older pack, checking the project page for the exact version list is always a good idea before you download LibTooltips.

Jar-in-Jar: Why You Rarely Install It Manually

Here is the clever part. LibTooltips is meant to be Jar-in-Jar'd into other mods. That means when a developer builds a mod that depends on it, the library gets bundled inside automatically. Players never have to download it separately, and there is no risk of a missing dependency error. If you are putting together a modpack, though, you can absolutely include LibTooltips directly to unlock tooltip support across your entire collection.

For players who prefer a frictionless setup, the foxygame.net launcher handles this kind of dependency management gracefully, letting you add LibTooltips and its companion mods in a single click while it keeps every version aligned automatically.

How to Install LibTooltips

If you are a player adding it to a modpack, or a developer testing locally, the process is straightforward. Here is how to install it on a typical Fabric or NeoForge profile:

  • Confirm your Minecraft version matches a supported LibTooltips release.
  • Place the library file into your mods folder alongside your other mods.
  • Launch the game once so the loader registers the library.
  • Verify it loaded by checking the mod list on the title screen.

Remember that most players will never need to do this manually, since bundled mods bring LibTooltips along for the ride. If a mod you downloaded lists it as a dependency and it is missing, that usually means the pack was assembled incorrectly rather than a problem with the library itself.

Writing Your First Tooltip

Creating custom tooltips is as simple as editing a language file. Pick your target item, follow the "tooltip.[namespace].[item].[line]" pattern, and save. Want three lines on a netherite ingot? Add keys ending in .0, .1, and .2. Want a permanent label on a custom quest token? Use the "tooltip.always" variant. No compilation, no restarts beyond a resource reload, and no Java knowledge required.

Porting and Community Support

Wondering about a port to a different Minecraft version or loader? The developer has been open about this, and requests are welcome through the community Discord. LibTooltips is maintained by wd, and the project has an active wiki covering tag syntax, formatting options, and advanced use cases. If you run into an odd rendering issue or want to suggest a new tag, the Discord is the fastest route to an answer.

Final Thoughts

LibTooltips solves a small problem extremely well. It removes the code barrier from item tooltips, hands control to pack makers and modders, and stays out of the way for regular players thanks to Jar-in-Jar bundling. Whether you are building a sprawling modpack or just want your custom sword to display a rainbow-colored description, this library delivers. Check the supported versions for your loader, download LibTooltips, and start writing tooltips that actually look good.