Custom Tooltip API
If you have ever felt that the default item tooltips in Minecraft are a bit plain, you are not alone. Whether you are a modpack creator looking to document complex systems, a server owner wanting to give players a unique experience, or a developer seeking a robust library, the Custom Tooltip API is the definitive solution. This client-side mod and developer library hands you total control over how item information is displayed, transforming a simple hover text into a dynamic, informative, and visually stunning part of your gameplay.
Why You Need This Mod in Your Arsenal
The core philosophy behind the Custom Tooltip API is flexibility without complexity. You do not need to write a single line of code to use its most powerful features. A comprehensive in-game interface, accessible via the Mods Menu, allows you to manage every aspect of your tooltips. However, for those who love to tinker, the included Developer API opens up a world of possibilities for injecting data directly through code. It is the perfect bridge between user-friendly design and technical depth.
Unleashing Advanced Targeting and Dynamic Placeholders
One of the standout features is the advanced targeting system. You can apply your custom tooltips to a single item like minecraft:diamond_sword, a whole tag group such as #c:swords, an entire mod namespace, or even use regex patterns to catch everything else. But the magic truly happens with dynamic placeholders. Embed real-time data directly into your text using variables like %durability%, %max_durability%, or %enchantments%. You can even show keybind hints that display the actual key the player has bound, making your tooltips feel incredibly alive and responsive.
For modpack creators, the generated custom_tooltip_api/config.json5 file is a godsend. It is heavily commented, making it easy to document your pack's mechanics for your team or community. You can drop custom background images and fonts into the designated config folders and enable them via the dynamically generated resource pack. This level of organization is rare and highly appreciated. If you are looking for a launcher that simplifies managing mods like this, the foxygame.net launcher offers a curated add-on catalog where you can find and install the Custom Tooltip API with a single click, ensuring you always have the right version for your game.
Visual Effects and Customization Galore
Gone are the days of static gray text. The Custom Tooltip API introduces a suite of visual effects that make your tooltips pop. You can apply an animated rainbow effect, a smooth two-color slide gradient, or a breathing gradient that pulses between hues. For a more classic look, static gradients and solid colors are also available. You have full control over colors using hex codes, legacy codes, or standard Minecraft color names.
Backgrounds, Fonts, and Positioning
The customization extends beyond the text itself. You can choose from solid, gradient, or texture backgrounds in either stretch or framed nine-slice modes, with complete opacity control. Similarly, custom fonts can be dropped into the config folder and applied per tooltip. Positioning is just as flexible. You can place your text right below the item's name, at the very bottom of the tooltip, or even prepend and append it to specific lines. The ability to replace the item's name or an entire line with your custom text is a powerful tool for creating immersive RPG-style item descriptions.
Developer API and Installation Guide
For developers, the built-in API is a treasure trove. It allows you to register tooltips and custom placeholders directly through code, with full support for live per-frame data like energy or mana. This makes it ideal for tech mods that need to display dynamic stats. The API is designed to be intuitive, and the project's README provides clear examples to get you started.
How to Install Custom Tooltip API for Minecraft
Before you can start crafting beautiful tooltips, you need to know how to install the mod. It requires a few dependencies to function correctly, including S-Lib and YACL on all platforms, plus Fabric API and ModMenu if you are on the Fabric loader. The Custom Tooltip API for Minecraft supports the latest versions of the game, and you should always check the specific version requirements for your loader. To get started, you will need to download Custom Tooltip API from a trusted source and place the jar file into your mods folder. Ensure you have the dependencies installed first to avoid any crashes.
Once installed, you can access the in-game editor. Holding CTRL while editing gives you an instant live preview of your tooltip, allowing for rapid iteration. You can copy, paste, reorder, and duplicate entries with ease, and sort them by creation date or alphabetically. This streamlined workflow makes managing even the most complex tooltip setups a breeze. For those using the foxygame.net launcher, the process is even smoother, as it handles version compatibility and dependency management automatically, letting you jump straight into the game with the Custom Tooltip API ready to go.
Conclusion
The Custom Tooltip API is more than just a mod; it is a complete toolkit for expression and information design within Minecraft. Whether you are a player wanting to add flavor to your gear, a modpack author documenting intricate systems, or a developer building the next big mod, this library provides the tools you need. With its intuitive GUI, powerful JSON support, and robust developer API, it stands as the premier choice for tooltip customization. Download it today and see how much depth a simple hover can bring to your world.
--- **Update Sep 13, 2026:** Added 4 files for version 1.21.1, 1.20.1 (NeoForge, Fabric, Forge).