OreDictTips: Reveal OreDictionary in Minecraft Tooltips
Every seasoned Minecraft player who ventures into the world of mods eventually hits a wall of confusion. You have dozens of new blocks, items, and recipes, and suddenly a crafting recipe refuses to work even though the item in your inventory looks exactly like what the recipe demands. The culprit is often the hidden OreDictionary system, a behind-the-scenes framework that governs item compatibility in modded Minecraft. OreDictTips: Reveal OreDictionary in Minecraft Tooltips exists to pull back the curtain on this system, turning cryptic data into readable, on-screen information.
Understanding the OreDictionary and Why It Matters
The OreDictionary is a core component of Minecraft Forge, acting as a shared vocabulary that allows different mods to treat similar items as interchangeable. For instance, copper ingots from one tech mod and copper ingots from another may have completely different item IDs, yet the OreDictionary assigns them a common tag, such as "ingotCopper." This tag lets crafting recipes accept either version without conflict. Without this system, cross-mod recipes would break constantly, and modpack development would be a nightmare.
The problem is that the vanilla game interface gives you zero visibility into these tags. You cannot tell whether the steel plate from one mod is recognized as the same material as the steel plate from another. OreDictTips solves this by injecting OreDictionary entries directly into the tooltip that appears when you hover over an item. No more guesswork, no more trial-and-error crafting.
Four Display Modes for Every Playstyle
OreDictTips does not force a one-size-fits-all approach. Instead, it ships with four configurable display modes, all controlled through the oredicttips.cfg file. This flexibility means you can tailor the mod to your specific workflow, whether you are a casual builder or a hardcore modpack developer.
Always Mode
When set to Always, the OreDictionary information appears on every item tooltip, all the time. This is the go-to choice for players who constantly juggle recipes and need immediate access to tag data without pressing any extra keys. It keeps the information front and center, though it does add visual noise to every hover.
Debug Mode
Debug mode ties the display to the advanced tooltip toggle, which you activate with the F3+H key combination. When advanced tooltips are off, OreDictTips stays silent. When you switch them on, the OreDictionary lines appear alongside the usual debug information. This mode suits mod developers and players who want the data available on demand but prefer a clean interface during normal play.
Keybind Mode
Keybind mode shows the OreDictionary entries only while you hold down a specific key. The default is the left Shift key, but you can remap it through the standard Minecraft controls menu. This is arguably the most practical mode for everyday use: hold Shift to inspect an item's tags, release it to hide them. It gives you quick access without permanently cluttering your screen.
Keybind Plus Debug Mode
The final mode combines both conditions. You must enable advanced tooltips with F3+H and hold the assigned key simultaneously to see the OreDictionary data. This is the strictest configuration, offering maximum control for players who want to avoid any accidental display. It is a niche option, but for those who value absolute precision, it is perfect.
Visual Clarity and Real-World Utility
All OreDictionary entries rendered by OreDictTips appear in a distinct green color. This is not a random aesthetic choice. The green text immediately separates technical tag data from the standard white or yellow item descriptions, making it easy to scan a tooltip at a glance. You can instantly spot which tags an item carries and whether it will work in a given recipe.
Consider a common scenario in a heavily modded pack. You are assembling a machine that requires steel plates. Your pack includes three different tech mods, each adding its own steel item. Without OreDictTips, you would have to manually check recipe files or consult external wikis to determine compatibility. With the mod installed, you simply hover over any steel plate and see the shared "plateSteel" tag. You know immediately that any of the three variants will work, saving you from wasted resources and frustrating dead ends.
This transparency also opens up creative problem-solving. When you can see that an expensive item from one mod shares a tag with a cheaper item from another, you can substitute the affordable version in your recipes. On servers with limited resources, this kind of knowledge can be the difference between thriving and struggling.
Installation and Version Compatibility
OreDictTips: Reveal OreDictionary in Minecraft Tooltips requires Minecraft Forge to function. The mod does not support Fabric or other loaders, so make sure your environment is set up with Forge before proceeding. The mod has been tested across multiple Minecraft versions, and the developer continues to release builds for newer game updates. However, you should always check the specific version compatibility on the mod's official distribution page before downloading.
One important note: the developer no longer maintains the CurseForge page for this project. All current and future builds are published exclusively on Modrinth. If you are searching for the latest version that works with recent Minecraft releases, Modrinth is the only reliable source. Older builds may still exist on other platforms, but they will not receive updates.
To install the mod, download the appropriate JAR file for your Minecraft version and place it into the mods folder of your client or server installation. The process is straightforward, but if you are unfamiliar with manual mod installation, you can also use a modern launcher that supports mod management. Some launchers can automatically resolve dependencies and place files in the correct directories, which is especially helpful when you are managing a large modpack with dozens of mods. Regardless of your method, the core steps remain the same: obtain the correct file, drop it into mods, and restart the game.
For players who prefer a guided approach, the phrase "how to install" often leads to video tutorials or launcher-specific guides. The general principle holds across all of them: the JAR goes into the mods folder, and Forge must be present. If you run into issues, double-check that your Forge version matches your Minecraft version and that you downloaded the correct OreDictTips build.
Who Benefits from This Mod
OreDictTips is not just for modpack creators or beta testers, though they will certainly appreciate it. Any player who enjoys understanding the deeper mechanics of modded Minecraft will find value in seeing the hidden tags. It transforms the game from a black box into a transparent system where you can reason about item interactions logically.
For players who frequently switch between different modpacks, the mod provides a consistent way to verify item compatibility across wildly different mod sets. You learn to recognize common tags and can predict whether a recipe will work before you even attempt it. This knowledge carries over from one pack to another, making you a more efficient and knowledgeable player overall.
Server administrators and pack maintainers also benefit. When players understand why certain items are or are not interchangeable, they file fewer support tickets and spend less time asking for recipe clarifications. The mod effectively reduces the support burden by putting the information directly in the players' hands.
Final Thoughts
OreDictTips: Reveal OreDictionary in Minecraft Tooltips is a small utility with a significant impact. It does not add new content, mobs, or dimensions. Instead, it grants you something more valuable: insight into how the game actually works under the hood. The four display modes give you granular control over when and how the information appears, and the green text ensures it is always readable. Whether you are a mod developer debugging cross-mod interactions, a pack creator balancing recipes, or a player who simply wants to understand why a crafting table rejects your items, this mod delivers the answers you need. By making the OreDictionary visible, it turns guesswork into knowledge and frustration into understanding, making it an essential addition to any serious modded Minecraft setup.