WatcherHUD

# 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

| Key | What it does |
|---|---|
| **KP_0** | Open the WatcherHUD config screen |
| **KP_1** | Turn the overlay on or off |
| **KP_2** | Show or hide liquid info |
| **KP_5** | Read the current target out loud (for accessibility) |

*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:

| Key | What it does |
|---|---|
| **KP_3** | Open JEI recipes for the block you're looking at |
| **KP_4** | Open JEI uses for the block you're looking at |

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! 🎯