TieredZ Tooltip Overhaul Compat
TieredZ Tooltip Overhaul Compat is a client-side compatibility addon for Minecraft 1.20.1 Fabric that integrates TieredZ refinement rarities with Tooltip Overhaul.
It allows refined tools and armor to use customizable rarity frames while preserving Tooltip Overhaul's equipment comparison functionality.
Features
- TieredZ Rarity Frames — Adds dedicated Tooltip Overhaul frames for Common, Uncommon, Rare, Epic, Legendary, and Unique TieredZ refinements.
- Dynamic Rarity Detection — Automatically reads the refinement data stored by TieredZ and selects the appropriate frame for each refined item.
- Equipment Comparisons — Preserves Tooltip Overhaul's comparison functionality for refined armor, weapons, and tools.
- Editable Frames — All added rarity frames can be viewed and customized through Tooltip Overhaul's Custom Frames visual editor.
- TieredZ Attributes Preserved — TieredZ continues to provide refinement attributes, modifiers, stat changes, and colored item names.
- TieredZ-Inspired Design — Includes six adapted frame textures based on TieredZ's original rarity border designs.
- Original Frames Preserved — The supplied configuration retains Tooltip Overhaul's original custom frame sections while adding the TieredZ rarity frames.
- Client-Side Only — The addon does not need to be installed on a dedicated server.
Included Files
The following files are included in the root of the addon JAR:
- README.md — Complete installation and configuration instructions.
- custom_frames.json — A ready-to-use version of Tooltip Overhaul's configuration containing the additional TieredZ rarity frame sections.
Open the addon JAR using 7-Zip, WinRAR, or another archive manager to access these files.
Installation
-
Install TieredZ 1.3.3, Tooltip Overhaul 1.5.2, and their required dependencies.
-
Place TieredZ Tooltip Overhaul Compat in your client mods folder.
-
Open the addon JAR using 7-Zip, WinRAR, or another archive manager.
-
Read the included README.md for the complete installation guide.
-
Extract the included custom_frames.json.
-
Make a backup of the existing Tooltip Overhaul configuration located at:
.minecraft/config/tooltipoverhaul/custom_frames.json
-
Replace it with the custom_frames.json included in the addon.
-
In TieredZ's configuration, set:
tieredTooltip=false
-
Restart Minecraft.
About custom_frames.json
The included custom_frames.json is a modified version of Tooltip Overhaul's configuration file. It is not a separate configuration file belonging to this addon.
The original Tooltip Overhaul sections are preserved, including custom frames for special items such as Golden Apples, the Dragon Egg, music discs, Elytra, Diamond and Netherite items, Celestisynth weapons, and selected Cataclysm weapons.
Six additional sections provide editable frames for TieredZ's refinement rarities:
- Common
- Uncommon
- Rare
- Epic
- Legendary
- Unique
The swords displayed in sections 7–12 of Tooltip Overhaul's Custom Frames editor are preview items only. During gameplay, the addon dynamically selects the correct frame according to each item's TieredZ refinement data.
Configuration
TieredZ's original tooltip frame renderer must remain disabled:
tieredTooltip=false
TieredZ will continue applying refinement attributes, modifiers, stat changes, and colored item names. Tooltip Overhaul will handle the tooltip layout, rarity frames, and equipment comparisons.
The added rarity frames can be customized through Tooltip Overhaul's Custom Frames visual editor.
When Mod Menu is installed, Tooltip Overhaul's configuration screen can be accessed through the in-game mod list.
To restore the supplied frames, extract custom_frames.json from the addon JAR again and replace the file located at:
.minecraft/config/tooltipoverhaul/custom_frames.json
Requirements
- Minecraft 1.20.1
- Fabric Loader
- Java 17
- TieredZ 1.3.3 — CurseForge — Required
- Tooltip Overhaul 1.5.2 — CurseForge — Required
- Mod Menu — CurseForge — Optional, for accessing Tooltip Overhaul's in-game configuration screen.
Original Projects
This addon provides compatibility between:
- TieredZ
- Tooltip Overhaul
This is an independent compatibility addon and is not an official release of either original project.
Credits
TieredZ Tooltip Overhaul Compat created by zclashtm.
TieredZ and its original rarity designs were created by Globox_Z and the TieredZ contributors.
Tooltip Overhaul and its customizable tooltip system were created by xylonity and the Tooltip Overhaul team.
License
TieredZ Tooltip Overhaul Compat is licensed under the MIT License.