WatcherHUD — Changelog

🎉 Version 1.0.0-Beta — First Public Beta

Released: October 12, 2026

Welcome to the first public beta of WatcherHUD!

This mod adds a small, clean HUD in the top of your screen that tells you everything you need to know about the block, entity or container you're looking at — without ever opening a menu.

It's the successor of the "look at a block and see info" idea, rebuilt from scratch for Minecraft 1.20.1 (Forge) with a modern look and a plugin system.

Since this is a Beta, everything works but you might find small bugs. Your feedback is welcome.

✨ What WatcherHUD Does

When you point your crosshair at something, an overlay appears at the top of your screen showing relevant information about it. That's it. No buttons to press, no menus to open — just look and see.

🆕 New in this version

🧱 Blocks

• Name and mod origin — see the block name and which mod it comes from (e.g. minecraft:grass_block or create:mechanical_press)
• Position — the block's XYZ coordinates, plus how far it is from you
• Redstone info — how much redstone power is coming in and going out
• Right tool — the game tells you what tool you need to break the block
• Mining progress — a live percentage while you're breaking the block
• Liquids — water, lava and modded fluids show up with their bucket icon

📦 Containers and machines

• Chests, barrels, shulkers, hoppers, droppers, dispensers — see what's inside without opening them, in a clean 9-per-row grid
• Double chests — the two halves of a double chest are merged into one big view
• Ender chests — see your own Ender chest content
• Furnaces — input, fuel and output slots in real time
• Brewing stands — see the fuel and what potions are brewing
• Beehives — count of bees inside + honey level (out of 5)
• Jukeboxes — see which music disc is playing
• Note blocks — see the note and the instrument
• Command blocks — see the stored command
• Spawners — see which mob it spawns

🐄 Entities (animals, monsters, NPCs)

• Name and mod origin
• Live 3D preview — actually see the entity, rendered inside the tooltip
• Health and armor — hearts and armor value
• Potion effects — active effects with their remaining time
• Baby timer — how long until the baby grows up
• Horses — jump height and movement speed
• Llamas — their strength value
• Villagers — their job and level
• Your pets — the owner's name (yours or another player's)
• Item frames — what item is displayed
• Armor stands — what armor they're wearing
• Chickens — how long until they lay an egg

🎨 Interface

• Clean dark tooltip with a subtle blue accent line
• Auto-scales to fit any screen resolution or GUI Scale — no more tiny text on 4K monitors
• Sneak while looking at a block to reveal extra details
• Drag-and-drop position — move the overlay anywhere on your screen
• All options in one menu — press KP_0 to open the config screen

⌨️ Default Keybinds

You can change any of these in Options → Controls → WatcherHUD.

🔌 Plugin System (for mod developers)

WatcherHUD has a public plugin system so other mods can add their own information to the overlay. This is the same concept used by Jade and WTHIT.

• Other mods can register their own providers
• You can enable or disable each plugin from the config screen
• Each plugin can have its own toggle switches (e.g. "show energy", "show tier")
• Each plugin can have its own keybinds that automatically disable with it
• A plugin can't crash the whole mod — errors are isolated

🧩 Optional Addon — WatcherHUDJEI

Want Just Enough Items integration? Install the optional addon:

The addon works on its own — WatcherHUD will still run perfectly without it.

⚙️ Installation

1. Install Minecraft Forge 47.4.10 for Minecraft 1.20.1
2. Download WatcherHUD-1.0.0-Beta.jar
3. Drop it in your .minecraft/mods/ folder
4. Launch the game

That's it. No setup required.

🌐 Client vs Server

• On your client — the mod is required to see the HUD
• On a server — optional, but recommended

Why install it on a server?
Because of Minecraft's security model, the client can't read the contents of a chest unless the server tells it. So:

• Singleplayer → works out of the box ✅
• Server with WatcherHUD → everything works, including chest contents ✅
• Server without WatcherHUD → the HUD still works for blocks and entities, but chests, shulkers, hoppers and brewing stands will appear empty

This is the same behavior as Jade and other similar mods.

🐛 Known issues in this Beta

These are the things we already know about and plan to fix in a future version:

• Redstone and energy values may lag slightly behind by up to ~200 ms (the tooltip refreshes a few times per second to stay fast)
• Chest contents don't show up on servers without WatcherHUD installed (this is intentional, see "Client vs Server")
• No /watcher command yet for debug or quick reload
• Only tested on Forge 47.4.10 — other Forge versions of 1.20.1 will probably work but haven't been verified
• English and French only for the interface

🔮 What's planned for future versions

Based on what we want to add and what players ask for:

• More entity types — slimes, iron golems, axolotls, custom mobs from other mods
• More container types — Create's basins, Mekanism's machines, Sophisticated Storage
• Cross-version support — Minecraft 1.20.2 through 1.20.6, later 1.21.x
• Command-line debug tools for mod developers
• A real "reload plugins" hotkey
• More languages (Spanish, German, Russian, Chinese)

Nothing is set in stone — future versions depend on feedback from players like you.

💬 Feedback & Bug Reports

If you find a bug or have a suggestion, please report it on the CurseForge project page or on the GitHub repository.

When reporting a bug, please include:

• Your Minecraft version and Forge version
• The full log file (logs/latest.log) — not just the error line
• The exact block or entity you were looking at
• A list of other mods installed
• A screenshot if possible

This helps us fix things much faster. Thank you!

📄 License

All Rights Reserved.

You are free to install and use WatcherHUD for your own gameplay, including on servers and modpacks (see the project page for modpack permissions). You may not redistribute, modify, or repackage the mod without written permission.

© 2026 DiumStream

Thank you for trying the first public Beta of WatcherHUD. Enjoy the view! 🎯