Unlocking Hidden Data with Omni Ocular
Minecraft is a game of endless discovery, but sometimes the most fascinating details are hidden beneath the surface. If you have ever wanted to peek at the raw NBT data of blocks, entities, or items without breaking immersion, the Omni Ocular mod is your new best friend. This powerful utility transforms the familiar Waila (What Am I Looking At) HUD into a fully customizable data dashboard, letting you see exactly what you want, from furnace burn times to sheep breeding cooldowns.
What Exactly Is Omni Ocular?
Omni Ocular is the spiritual successor to WailaNBT, rebuilt from the ground up with cleaner code and far more flexibility. It integrates seamlessly with Waila and Not Enough Items (NEI) to display player-defined NBT information directly on the heads-up display. Whether you are an extreme number cruncher, a modpack tester, or simply a curious player, this mod puts the hidden metadata of the game world right in front of your eyes. The best part? It works out of the box with sensible defaults, so you can install it and immediately start seeing extra details on furnaces, chests, mobs, and tooltips.
Key Features at a Glance
- Shows custom NBT data on the Waila HUD for tile entities, entities, and item tooltips.
- Fully configurable via XML files with embedded JavaScript logic.
- Supports regular expressions for matching multiple game objects at once.
- Includes built-in functions for localization, name resolution, fluid names, and inventory checks.
- Works on both client and server, with server-side configs overriding client settings for multiplayer fairness.
- Provides handy in-game commands like
/oor,/ooe, and/oonfor reloading configs and identifying registry names.
Installation and Setup
Getting started with Omni Ocular is straightforward. You need to have Not Enough Items and Waila already installed, as both are required dependencies. The mod must be present on both the client and the server to function correctly in multiplayer. Simply place the Omni Ocular jar file into your mods folder, and you are good to go. For those who prefer a more streamlined modding experience, the foxygame.net launcher makes managing setups like this effortless—its modern interface lets you browse and install mods directly from the menu, so you can add Omni Ocular and its dependencies without juggling files manually. If you plan to dive into custom configuration, it is highly recommended to also grab NBTEdit (the 1.7.10 version is available separately) to explore NBT structures in-game.
Understanding the Default HUD Additions
Once installed, Omni Ocular immediately enhances your Waila tooltip with useful data. Point at a furnace, and you will see the remaining burn time and cook progress. Look at a sheep, and the time until it can breed again appears. Hover over a player skull, and the owner’s name is shown. These pre-configured displays are just the beginning—the real power lies in crafting your own custom views.
Diving into Custom Configuration
All customization happens inside XML files located in the minecraft/config/OmniOcular folder. The mod ships with several example files that you can study and modify. Each config file targets specific tile entities, entities, or items using the id attribute, which supports regular expressions for broad matching. Inside these nodes, you define <line> elements that execute JavaScript snippets to fetch and format NBT data. The scripting environment gives you access to a special nbt object representing the full NBT tree of the target, along with helper functions like translate(), name(), and fluidName().
A simple config for a furnace might look like this:
<oo>
<tileentity id="Furnace">
<line displayname="Burn Time">return tick2second(nbt['BurnTime'])</line>
</tileentity>
</oo>You can even use Minecraft formatting codes and special characters like TAB, ALIGNRIGHT, and heart symbols to style the output. If a line returns null, __ERROR__, or undefined, it is automatically hidden, giving you conditional display logic.
Essential In-Game Commands
Omni Ocular adds three commands to help you work with NBT data:
- /oor – Reloads all XML configs from the OmniOcular folder. On a server, this also pushes the updated configs to all online players. Only operators can use it in multiplayer.
- /ooe – Displays the registry name of the entity you are pointing at, invaluable for writing entity configs.
- /oon – Shows the registry name of the item you are holding, perfect for tooltip configs.
Pair these with NBTEdit’s /nbtedit command to explore the raw NBT structure of any block or entity. Once you know the exact tag names, you can build precise display lines.
Server-Side Control and Safety
In multiplayer, server-side configs take absolute priority. Any client-side customizations are ignored, and all players see exactly what the server defines. This prevents clever players from using custom configs to reveal sensitive NBT data, such as passwords stored in tile entities. The /oor command logs the username of whoever runs it, adding an audit trail for server administrators.
Planning Your Own Configs
When writing config files, always name them after the mod they target (e.g., ThermalExpansion.xml) to keep things organized. Use the <init> node to define reusable functions, like converting ticks to seconds. Remember that JavaScript code inside line nodes does not need XML escaping for special characters—Omni Ocular handles that for you. The built-in holding(), armor(int), isInHotbar(string), and isInInv(string) functions open up even more possibilities, such as displaying information only when a specific item is in your inventory.
Conclusion: A Must-Have for Data Enthusiasts
Omni Ocular transforms the Waila HUD from a simple block identifier into a rich, scriptable data viewer. Its deep integration with NBT data and JavaScript makes it an indispensable tool for mod developers, pack makers, and anyone who loves to understand the inner workings of Minecraft. The learning curve for custom configs is gentle, especially with the pre-configured examples and NBTEdit to guide you. Whether you are troubleshooting a complex mod interaction or simply want to see how many ticks remain on that brewing stand, Omni Ocular delivers the information with style and precision. Install it today and start seeing your world in a whole new light.