Tooltip Overhaul
A complete visual refresh for Minecraft tooltips, completely replacing the vanilla tooltip system with a clearer and polished layout.
This mod is client-side only, no dependencies required. Just drop it in your mods folder and start playing! (Fabric users need ModMenu to open the config screen)
Tooltip Overhaul is highly customizable. You can easily replicate the look of the vanilla tooltips or customize them to be as extravagant as possible, you have the complete creative freedom. As always, every tooltip, more modern, sharper, clearer.
Features
Readability
- Scrollable tooltips: scroll through tooltips taller than the screen instead of losing legible text.
- Text wrapping: prevents tooltips from being too wide by automatically inserting line breaks where needed.
- Equipment comparison: compare armor and weapons against what you're wearing and holding (rebindable keybind).
- Pinned tooltips: don't miss out on important content by having to switch between tooltips, you can pin them and move them freely around the screen (rebindable keybind).
Appearance
- Decorative frames: 30+ default frame overlays that enhance the appearance of tooltip borders.
- Tooltip layouts: 4+ different types of layouts that change the visual appearance of tooltips, for greater customization and diversity.
- Tooltip effects: 37+ fully customizable decorative effects such as flashes, explosions, particles, patterns... to take the design of the tooltips to the next level.
- Animations: 11+ tooltip transitions (appearance and disappearance) and 16+ item icon animations.
- 3D item icon & preview panel: items render in 3D inside the tooltip, even through an additional panel with extra perspectives.
- Vignettes: 5+ different gradient styles that add extra lightning and style to the tooltips.
- Rating element: a customizable rarity label along the item name.
- Divider line: the separator line between the tooltip title and the content is customizable in color and design.
- Custom corners: 11+ different options for the tooltip corners so you can choose the best possible look, whether you prefer a more polished style, more rustic, etc.
- Vast amount of config: you can modify anything! Paddings, colors and gradient types, effects, speeds, animations, and much more.
All of it is shown in the Showcase below.
Configuration
- In-game config screen: no file editing is longer required.
- Custom frames config screen: no file editing is longer required to configure specific items, tags, rarities, effects, vignettes, etc.
- Live preview: per-item changes render in real time as you edit through the in-game config screen.
- Hot reload:
/tooltipoverhaul reloador by pressing downF3 + T, to automatically detect new imported textures.
Compatibility
Works alongside JEI, EMI, ModernFix, Flerovium, FTB Quests and Apotheosis, among others.
For mod and pack authors, any mod or resource pack can register its own frames. See the wiki and read the category below. If there's a mod you'd like supported natively, ask in the Discord.
For Developers, Artists, Modpack & Resource Pack Authors
The information provided on this page is intended for direct use by the user and to concisely specify the mod's content in a legible way, so no technical information is stated at all.
We highly recommend visiting the wiki page, which explains how to create custom textures for tooltip frames and how to configure custom frames for your mod or texture pack to easily add compatibility with Tooltip Overhaul.
Configuration
The easiest way is through the in-game config screen, which can be accessed through the mods menu or through a keybind (unbinded by default) for faster access. It covers every configuration option and allows you to edit custom frames from Tooltip Overhaul or external mods.
There are two ways to configure tooltips. Through global configuration, or through custom frames. The global config affects all tooltips equally, while a custom frame allows you to specify conditions for which items a frame is applied or not (specific items, tags, namespaces, rarities, specific durabilities, nbt/component tags, enchantments, etc.), whose configuration takes priority over the global one.
Fabric users need ModMenu to open the config screen.
If you want to edit the files directly anyway
- Global: config/tooltipoverhaul/tooltipoverhaul.toml
- Specific: config/tooltipoverhaul/custom_frames.json or config/tooltipoverhaul/overrides/<external_modid>/custom_frames.json to access custom frames created by external mods (if a copy is present)
Showcase
Everything below is included in the mod. Click a section to expand it.
Effects
Bubbles

Cinder

Crystals

Fireflies

Fireflies II

Echo

Galaxy

Magic Orbs

Speed Lines

Nebula

Spiral

White Dust

Metal Shining

Steel Shining

Rim Light

Ripples

Sonar

Stars

Floating Stars

Prism

Snowfall

Opal

Aurora

Fluorite

Astral

Comets

Storm

Sunbeams

Fireworks

Eruption

Searchlights

Blasts

Firebreath

Shield

Lasers

Missiles

Wisps

Tooltip Animations
Fade

Pop

Rise

Unfold

Zoom

Slide

Swing

Emerge

Squash

Card

Shake

Icon Animations
Zoom

Rotate

Rotate Fast

Rotate Zoom

Zoom Snap

Skew

Vibration

Tilt Wave

Flip

Pendulum

Bounce

Go Down

Pulse

Fan In

Hover Pop

Barrel Roll

Corner Styles
Default (square)

Rounded

Bevel

Inner

Cut

Thick

Bracket

Block

Notch

Weld

Gem

Vignettes
Circular

Hole

Ellipse

Diamond

Ring

Linear

Frame Overlays
The following frames are included by default in Tooltip Overhaul.
Amethyst
Angelical

Battle

Cataclysm
Amber
Cavemen
Construction Punk

Demonic

Diamond

Draconic Fire (based off Ice & Fire II)

Emerald

Fire

Flower

Frost

Futuristic

Garden

Gear

Greek Temple

Gummy Bear

Guns and Wires

King

Medieval Crossroads

Neon Fire

Nuclear Alarm

Plasma Lamp

Pure Alchemy

Silver

Skyland

Steampunk

Zombie Brain

Tooltip Layouts
Tooltips can have different types of fully configurable layouts.
Default (Classic)

Badge

Floating

Compact

Divider Lines
Gradient

Static

Linear

Dashed

Dotted

Ornament

Gradient Ornament

Infinite Posibilities!



From Other Authors
Resource packs can also add their own frames and configurations. These ones are worth a look!
Support
Bug reports, feature requests, compatibility suggestions and general questions all go to the Discord or to the Issues tab.
Feel free to include this mod in any modpack, public or private!
Credits
Xylonity - Programmer & mod designer
TheModderG - Tooltip overlays & mod icon designer
Yomai - Additional tooltip overlay designer
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 |
- Fixed armor not rendering in the preview panel when the tooltip was using one of the following vignettes: Ellipse, Diamond, Ring, Linear
- Fixed vignettes not adapting properly to the whole Badge tooltip layout
- Fixed scrollable tooltips blocking the mouse wheel for mods that use it on container items, like the item selection from Easy Shulker Boxes
- Fixed armor not rendering in the preview panel when the tooltip was using one of the following vignettes: Ellipse, Diamond, Ring, Linear
- Fixed vignettes not adapting properly to the whole Badge tooltip layout
- Fixed scrollable tooltips blocking the mouse wheel for mods that use it on container items, like the item selection from Easy Shulker Boxes
- Fixed armor not rendering in the preview panel when the tooltip was using one of the following vignettes: Ellipse, Diamond, Ring, Linear
- Fixed vignettes not adapting properly to the whole Badge tooltip layout
- Fixed scrollable tooltips blocking the mouse wheel for mods that use it on container items, like the item selection from Easy Shulker Boxes
- Fixed armor not rendering in the preview panel when the tooltip was using one of the following vignettes: Ellipse, Diamond, Ring, Linear
- Fixed vignettes not adapting properly to the whole Badge tooltip layout
- Fixed scrollable tooltips blocking the mouse wheel for mods that use it on container items, like the item selection from Easy Shulker Boxes
- Fixed armor not rendering in the preview panel when the tooltip was using one of the following vignettes: Ellipse, Diamond, Ring, Linear
- Fixed vignettes not adapting properly to the whole Badge tooltip layout
- Fixed scrollable tooltips blocking the mouse wheel for mods that use it on container items, like the item selection from Easy Shulker Boxes
- Lateral texture overlay sections are now rendered below corners
- Fixed icon size config option not working properly on certain tooltip layouts
- Fixed title/rating text alignment not adapting properly to the tooltip proportions by adding another config entry that lets u align them independently of the icon size
- Lateral texture overlay sections are now rendered below corners
- Fixed icon size config option not working properly on certain tooltip layouts
- Fixed title/rating text alignment not adapting properly to the tooltip proportions by adding another config entry that lets u align them independently of the icon size
- Lateral texture overlay sections are now rendered below corners
- Fixed icon size config option not working properly on certain tooltip layouts
- Fixed title/rating text alignment not adapting properly to the tooltip proportions by adding another config entry that lets u align them independently of the icon size
- Lateral texture overlay sections are now rendered below corners
- Fixed icon size config option not working properly on certain tooltip layouts
- Fixed title/rating text alignment not adapting properly to the tooltip proportions by adding another config entry that lets u align them independently of the icon size
- Lateral texture overlay sections are now rendered below corners
- Fixed icon size config option not working properly on certain tooltip layouts
- Fixed title/rating text alignment not adapting properly to the tooltip proportions by adding another config entry that lets u align them independently of the icon size
- Fixed game crashing while hovering over a modded itemstack with an item count above 99 (like Sophisticated Backpacks)
- Fixed game crashing while hovering over a modded itemstack with an item count above 99 (like Sophisticated Backpacks)
- Fixed game crashing while hovering over a modded itemstack with an item count above 99 (like Sophisticated Backpacks)
- Fixed icon corner type not working properly on Floating and Badge tooltip layouts
- Fixed icon corner type not working properly on Floating and Badge tooltip layouts
- Fixed icon corner type not working properly on Floating and Badge tooltip layouts
- Fixed icon corner type not working properly on Floating and Badge tooltip layouts
- Fixed icon corner type not working properly on Floating and Badge tooltip layouts
- Added category buttons inside custom frames screens for better user experience (control+re/avg cycles sections)
- Shadow corner type now matches the background's corner type
- Added category buttons inside custom frames screens for better user experience (control+re/avg cycles sections)
- Shadow corner type now matches the background's corner type
- Added category buttons inside custom frames screens for better user experience (control+re/avg cycles sections)
- Shadow corner type now matches the background's corner type
- Added category buttons inside custom frames screens for better user experience (control+re/avg cycles sections)
- Shadow corner type now matches the background's corner type
- Added category buttons inside custom frames screens for better user experience (control+re/avg cycles sections)
- Shadow corner type now matches the background's corner type
- Added a new type of corner type: Full Thick
- Added a config option to change the icon border style: Style 1 (default) and Style 2
- Added a preview button inside the global config screen
- Rating text is now translatable using any translation key, and it is now previewed within its input box
- Added some critical cache limits to prevent memory leaks
- Fixed preview panel "cut" and "notch" corners adding extra pixels
- Added a new type of corner type: Full Thick
- Added a config option to change the icon border style: Style 1 (default) and Style 2
- Added a preview button inside the global config screen
- Rating text is now translatable using any translation key, and it is now previewed within its input box
- Added some critical cache limits to prevent memory leaks
- Fixed preview panel "cut" and "notch" corners adding extra pixels
- Added a new type of corner type: Full Thick
- Added a config option to change the icon border style: Style 1 (default) and Style 2
- Added a preview button inside the global config screen
- Rating text is now translatable using any translation key, and it is now previewed within its input box
- Added some critical cache limits to prevent memory leaks
- Fixed preview panel "cut" and "notch" corners adding extra pixels
- Added a new type of corner type: Full Thick
- Added a config option to change the icon border style: Style 1 (default) and Style 2
- Added a preview button inside the global config screen
- Rating text is now translatable using any translation key, and it is now previewed within its input box
- Added some critical cache limits to prevent memory leaks
- Fixed preview panel "cut" and "notch" corners adding extra pixels
- Added a new type of corner type: Full Thick
- Added a config option to change the icon border style: Style 1 (default) and Style 2
- Added a preview button inside the global config screen
- Rating text is now translatable using any translation key, and it is now previewed within its input box
- Added some critical cache limits to prevent memory leaks
- Fixed preview panel "cut" and "notch" corners adding extra pixels
- Added 3 brand-new tooltip styles that change the visual layout of the tooltip: Classic, Badge, Floating and Compact
- Added ingame editing for every active mod/resourcepack custom frames file
- Added a new effect and vignette ingame editor screens.
- Several tooltips can now be pinned to the screen at once (3 by default, configurable) through a configurable keybind (unbinded by default), with independent dragging, scrolling and closing
- Polished both ingame config and custom frames screens, with new animations, polished colors and better visual harmony
- Most effects have been reworked with a whole new polished look: Bubbles, Cinder, Crystals, Fireflies, Echo, Galaxy, Magic Orbs, Speed Lines, Spiral, Metal Shining, Rim Light, Ripples, Sonar, Stars
- Added 21 new effects: Astral, Fluorite, Aurora, Opal, Floating Stars, Steel Shining, Fireflies II, Snowfall, Prism, Comets, Storm, Sunbeams, Fireworks, Eruption, Searchlights, Blasts, Firebreath, Shield, Lasers, Missiles, Wisps
- Added 4 new divider line types: Dashed, Dotted, Ornament, Gradient Ornament
- Reworked the custom frames preview with a centered item and automatic fitting, no longer using a random mosaic placement
- Added reusable templates to custom frames json files which, once applied to certain items, inherit the same (overrideable) values defined in the template itself
- Added conditional custom frame rules based on remaining durability, custom item names, certain enchantments and specific tags/components
- Effects are now configurable (per intensity, deformation, saturation, colors, density, speed, etc.)
- Added a configurable keybind (unbinded by default) for fast accessing TO's ingame config screen
- Custom frames json file entries can now be dragged and reordered through the ingame config screen
- Custom frames json file entries can now specify their priority over other entries
- Custom frame entries are now updated automatically on mod/resourcepack updates only while the whole entry is unmodified
- Some config options (like icon animations) are now selectable instead of forcing the user to write them down
- Added frame editor validation, automatic backups, control+S support and draft support
- Added a browser for items, enchantments and frames, with a search bar, preview and multiple item selection support
- Added a configurable tooltip appear delay and an option to keep the tooltip settled when moving straight from one item to another, so sweeping across the inventory doesn't flash animations
- Added config options to cap the tooltip height and width as a percentage of the screen
- Added a config option to render effects behind the text, icon and frame
- Added a config option to show the item registry name (for example minecraft:oak_planks) without having to press F3+H
- Added a config option to show the item durability without having to press F3+H
- Added custom icons to the ingame custom frames config screen and others
- Added language localization to config entries and descriptions
- Icon background color and border color are now configurable
- The whole tooltip is now drawn above vanilla toasts (advancements, recipe unlocks, etc.), which used to slip between the text and the background (the depth is now configurable)
- Custom frames tooltip preview is now automatically updated once a config option is changed
- Long text tooltips now auto-scroll once, for players that might not know this functionality exists
- Internal refactor of the effect building pattern into a common canvas for much faster and better effect creation process, so expect more effects soon
- Split the tooltip animation into separate appear and disappear animations
- Replaced clickable cycling options with popup selection
- Custom frame editor changes are automatically recovered from a separate draft without applying them until Save, so no changes should be lost by mistake
- Updated the whole modpage and wiki
- Updated silver and amethyst frame overlay textures
- Updated some default config entries & added more custom frames entries by default
- Fixed tooltips appending the mod name even if it was already stated in the description
- Fixed the tooltip appear animation and icon animations replaying on every tick for items that update their NBT while hovered
- Fixed tooltips disappearing when a mod renders a second tooltip in the same frame
- Fixed custom tooltip components that render past their declared width (like Celestisynth's weapon ability box) being cut by the inner frame and divider line
- Fixed cinder effect not adapting to the whole tooltip proportions
- Fixed the tooltip shadow config option not covering the preview panel
- Fixed the custom frame overlay texture ignoring its own transparency on fade animations
- Fixed metal_shining effect ending too early on big tooltips
- Fixed two tooltips drawn in the same frame at the same spot overlapping each other, that happened for example when using the mod JEED, after hovering over status effect icons
- Fixed brighter corner and edge pixels on the inner frame while the tooltip fades in or out
- Fixed EMI recipe screens of mods whose id contains "tag" (Create: Vin"tag"e Improvements...) losing the hovered item
- Fixed tooltips not replaying animations on the second hover of the same item
- Added 3 brand-new tooltip styles that change the visual layout of the tooltip: Classic, Badge, Floating and Compact
- Added ingame editing for every active mod/resourcepack custom frames file
- Added a new effect and vignette ingame editor screens.
- Several tooltips can now be pinned to the screen at once (3 by default, configurable) through a configurable keybind (unbinded by default), with independent dragging, scrolling and closing
- Polished both ingame config and custom frames screens, with new animations, polished colors and better visual harmony
- Most effects have been reworked with a whole new polished look: Bubbles, Cinder, Crystals, Fireflies, Echo, Galaxy, Magic Orbs, Speed Lines, Spiral, Metal Shining, Rim Light, Ripples, Sonar, Stars
- Added 21 new effects: Astral, Fluorite, Aurora, Opal, Floating Stars, Steel Shining, Fireflies II, Snowfall, Prism, Comets, Storm, Sunbeams, Fireworks, Eruption, Searchlights, Blasts, Firebreath, Shield, Lasers, Missiles, Wisps
- Added 4 new divider line types: Dashed, Dotted, Ornament, Gradient Ornament
- Reworked the custom frames preview with a centered item and automatic fitting, no longer using a random mosaic placement
- Added reusable templates to custom frames json files which, once applied to certain items, inherit the same (overrideable) values defined in the template itself
- Added conditional custom frame rules based on remaining durability, custom item names, certain enchantments and specific tags/components
- Effects are now configurable (per intensity, deformation, saturation, colors, density, speed, etc.)
- Added a configurable keybind (unbinded by default) for fast accessing TO's ingame config screen
- Custom frames json file entries can now be dragged and reordered through the ingame config screen
- Custom frames json file entries can now specify their priority over other entries
- Custom frame entries are now updated automatically on mod/resourcepack updates only while the whole entry is unmodified
- Some config options (like icon animations) are now selectable instead of forcing the user to write them down
- Added frame editor validation, automatic backups, control+S support and draft support
- Added a browser for items, enchantments and frames, with a search bar, preview and multiple item selection support
- Added a configurable tooltip appear delay and an option to keep the tooltip settled when moving straight from one item to another, so sweeping across the inventory doesn't flash animations
- Added config options to cap the tooltip height and width as a percentage of the screen
- Added a config option to render effects behind the text, icon and frame
- Added a config option to show the item registry name (for example minecraft:oak_planks) without having to press F3+H
- Added a config option to show the item durability without having to press F3+H
- Added custom icons to the ingame custom frames config screen and others
- Added language localization to config entries and descriptions
- Icon background color and border color are now configurable
- The whole tooltip is now drawn above vanilla toasts (advancements, recipe unlocks, etc.), which used to slip between the text and the background (the depth is now configurable)
- Custom frames tooltip preview is now automatically updated once a config option is changed
- Long text tooltips now auto-scroll once, for players that might not know this functionality exists
- Internal refactor of the effect building pattern into a common canvas for much faster and better effect creation process, so expect more effects soon
- Split the tooltip animation into separate appear and disappear animations
- Replaced clickable cycling options with popup selection
- Custom frame editor changes are automatically recovered from a separate draft without applying them until Save, so no changes should be lost by mistake
- Updated the whole modpage and wiki
- Updated silver and amethyst frame overlay textures
- Updated some default config entries & added more custom frames entries by default
- Fixed tooltips appending the mod name even if it was already stated in the description
- Fixed the tooltip appear animation and icon animations replaying on every tick for items that update their NBT while hovered
- Fixed tooltips disappearing when a mod renders a second tooltip in the same frame
- Fixed custom tooltip components that render past their declared width (like Celestisynth's weapon ability box) being cut by the inner frame and divider line
- Fixed cinder effect not adapting to the whole tooltip proportions
- Fixed the tooltip shadow config option not covering the preview panel
- Fixed the custom frame overlay texture ignoring its own transparency on fade animations
- Fixed metal_shining effect ending too early on big tooltips
- Fixed two tooltips drawn in the same frame at the same spot overlapping each other, that happened for example when using the mod JEED, after hovering over status effect icons
- Fixed brighter corner and edge pixels on the inner frame while the tooltip fades in or out
- Fixed EMI recipe screens of mods whose id contains "tag" (Create: Vin"tag"e Improvements...) losing the hovered item
- Fixed tooltips not replaying animations on the second hover of the same item






