Builder's Materials HUD

## ResourceHUD v1.0 — NeoForge 1.21.1

A client-side HUD overlay for MineColonies that displays builder resource

requirements directly on screen — no need to keep reopening the Resource Scroll.

### Features

- **Auto-reads the Resource Scroll** — open it once, the HUD stays on screen

- **Color-coded status** — ✔ complete · ~ partial · ✘ missing · ⚒ manual

- **Aligned quantity columns** — have/needed values properly aligned like a table

- **Warehouse stock indicator** ⊕ — shows when items are available in your warehouse

- **In-transit indicator** ↑ — shows items currently being delivered by couriers

- **Progress bar** — global % of resources delivered

- **Multi-builder support** — navigate between builders with ◄/► arrows

- **Draggable & resizable** — drag to reposition, drag bottom-right corner to resize

- **Mouse scroll to paginate** — when resource list exceeds row limit

- **Configurable key bindings** — toggle HUD, cycle row limit (5/10/15/∞), cycle scale

- **Marquee scrolling** — long resource names scroll automatically

- **Persistent config** — position, scale, and visibility saved between sessions

### Client-side vs Server-side

This mod works **client-only** — install it only on your client and it will:

- Display builder resource lists from the Resource Scroll ✅

- Track items in your player inventory ✅

- Show all status colors and HUD controls ✅

For warehouse stock (⊕) and in-transit arrows (↑), the mod also needs to be

installed on the server. It uses **optional channels** — the mod will never

disconnect you from servers that don't have it installed.

### Requirements

- NeoForge 1.21.1

- MineColonies (any recent version for 1.21.1)

### Key Bindings (configurable in Options > Controls)

- **Toggle HUD** — show/hide the overlay

- **Cycle Row Limit** — 5 → 10 → 15 → ∞

- **Cycle Scale** — 75% → 87% → 100% → 125% → 150%