Config Tooltips: Custom Item Tooltips for Minecraft

Config Tooltips lets you add custom tooltips to any item in Minecraft via a simple JSON config file. Lightweight, client-side, and modpack-friendly.

Config Tooltips

Every Minecraft player knows the feeling of staring at an item in their inventory and wishing it explained itself a little better. Maybe you want a modpack to guide new players through complex crafting chains, or perhaps you just want a cheeky note attached to your favorite sword. Config Tooltips is a lightweight add-on that does exactly that: it lets you attach custom tooltip text to any item in the game, including items added by other mods, using nothing more than a JSON configuration file.

Although the original project is no longer maintained as of December 2022, it remains a handy utility for players running older modpacks and anyone who prefers a config-driven approach over heavier tooltip mods. If you are planning to download Config Tooltips for Minecraft, here is everything you need to know about how it works, how to set it up, and what to expect.

What Config Tooltips Actually Does

The concept is refreshingly simple. The add-on reads a file located at config/extra_tooltips/tooltip.json and uses its contents to append tooltip lines to items you specify. Because it hooks into the item registry rather than a fixed list, it works with vanilla items and modded items alike, which makes it especially useful for pack authors who want consistent documentation across dozens of mods.

The default file comes with a structured example showing exactly how entries are formatted, so you can copy the pattern and start adding your own tooltips within minutes. Each entry maps an item identifier to the text you want displayed, and you can stack multiple lines for longer explanations.

Client-Side Only and Modpack Friendly

One of the most appealing aspects of Config Tooltips for Minecraft is that it is required only on the client. Servers do not need to install it, and players who join without it simply will not see the custom tooltips. The author also explicitly permitted use in any modpack, so pack developers can bundle it without worrying about permissions.

Supported Versions and Loaders

Config Tooltips was built for the Forge mod loader and targets older Minecraft releases from the 1.12 through 1.16 era, which is precisely why it still appeals to players maintaining legacy modpacks. If you are running a modern version of the game, check compatibility carefully before adding it to your setup, since the project has not received updates since late 2022.

For players who juggle several instances at once, the foxygame.net launcher makes short work of it: you can install Config Tooltips with a single click from the built-in add-on catalog, and the launcher keeps each mod tied to the correct game version automatically.

How to Install Config Tooltips

Getting started is straightforward, especially if you have installed Forge mods before. Follow these steps:

  • Confirm that your Minecraft instance is running a Forge version the add-on supports.
  • Download Config Tooltips from a reputable mod repository and place the JAR file in your mods folder.
  • Launch the game once so the mod can generate its default configuration directory.
  • Open config/extra_tooltips/tooltip.json with any text editor and add your entries following the example structure.
  • Save the file and reload it in-game using the command below.

Reloading Your Changes

Editing JSON by hand is quick, but restarting the game every time you tweak a line is not. The add-on includes a handy command, /reloadtooltips, which refreshes the configuration without a restart. There is one catch: the command only works in singleplayer. If you are testing on a multiplayer server, the usual workaround is to open a singleplayer world, run the command there, and then return to the server, or simply relaunch the game.

Writing Your First Tooltip Entry

The default configuration file is structured as a list of objects, each pairing an item ID with the tooltip content you want to show. Once you understand the pattern, adding a note to a modded sword or a cryptic hint on a quest item takes seconds. Keep your JSON syntax clean, since a single missing comma will prevent the file from loading and your tooltips will silently disappear.

Who Should Use It

Config Tooltips shines in three situations: modpack authors who want to document progression without writing a custom mod, server owners preparing guide-focused experiences, and tinkerers who enjoy personalizing their world with flavor text. It is not a replacement for dynamic tooltip libraries that pull live data such as durability or energy values, but for static, hand-written descriptions it is hard to beat for simplicity.

Final Thoughts

Config Tooltips is a small, focused add-on that solves a specific problem elegantly. Its JSON-driven approach means no coding knowledge is required, its client-side nature keeps servers clean, and its compatibility with modded items makes it a quiet workhorse for pack development. Just remember that the project is no longer supported, so pair it with a game version it was designed for and keep backups of your configuration. For legacy packs and anyone who values straightforward customization, it remains a worthwhile addition to the mods folder.