Builder's Materials HUD

Builder's Materials HUD — ResourceHUD

A MineColonies companion mod that shows your builder's shopping list directly in the HUD — no more opening the Resource Scroll every 30 seconds.

What it does

Open a builder's Resource Scroll once and ResourceHUD captures the resource list. It then displays a compact overlay on your screen with every material needed, how many you already have available (inventory + warehouse + transit + builder hut), and the real construction progress of the current build — all updated automatically.

Features

Resource tracking

• All materials with current/needed quantities (e.g. 8 / 20)
• Color-coded: red (missing), orange (partial), green (complete)
• Toggle to hide completed resources — keep the list focused
• Page navigation with scrollwheel or ◄/► arrows when the list is long

Stock sources — client-side fallback

• Items already counted in the Resource Scroll (delivered to site)
• Items in your player inventory
• Basic totals readable without any server-side component

Stock sources — with server-side mod installed

• Live scan of all warehouse racks
• Items in transit (deliverymen currently carrying goods to the site)
• Items in the builder hut inventory (direct capability scan)
• Full per-source breakdown in tooltip

Detailed tooltip

• Hover any resource row to see exactly where each unit comes from:
  • ⊕ Warehouse, ⊙ Builder hut, ↑ In transit, Hand (player inventory)

Construction progress

• Blue progress bar showing the real MineColonies build progress (blocks placed / total)
• Separate from the green resource delivery bar
• Requires server-side mod to read live work order data

Multi-builder support

• Independently tracks multiple builders during a session
• Switch builders with the ◄/► arrows in the HUD header
• Each builder's progress and resource list are cached separately

JEI integration

• Right-click any resource row → opens the JEI recipe lookup for that item

Display options

• 7 scale levels: 50 % → 66 % → 75 % → 87 % → 100 % → 125 % → 150 %
• Row limit: 5 / 10 / 15 / unlimited
• 5 background opacity levels
• Drag the HUD anywhere on screen (when any menu is open)
• Drag the ◢ corner handle to resize the HUD width
• All settings saved to config/resourcehud.json

Default keybinds (all rebindable in Options > Controls > ResourceHUD)

Mouse (when any screen is open)

Installation

Client-only — works on any server, no server installation required. The Resource Scroll data alone is enough to show the basic list.

Recommended: also install on the server. When the mod is present server-side, it performs a live scan on demand: warehouse stocks, transit items, builder hut contents, and real construction progress are all sent to the client over the network. Without the server mod, only the scroll data and player inventory are available.

Dependencies

• NeoForge 1.21.1
• MineColonies (any recent build for 1.21.1)
• JEI (optional — enables right-click recipe lookup)