Builder's Materials HUD

👷‍♂️ Builder's Materials HUD — ResourceHUD
================================================================================
FRANÇAIS
================================================================================
Le compagnon indispensable pour MineColonies ! Affichez la liste de courses de votre bâtisseur directement sur votre écran, sans plus jamais avoir à ouvrir le Parchemin de Ressources toutes les 30 secondes.

──────────────────────────────────────────────────

🧐 COMMENT ÇA MARCHE ?
Ouvrez le Parchemin de Ressources (Resource Scroll) d'un bâtisseur une seule fois : ResourceHUD capture instantanément la liste. Le mod génère alors un overlay compact et élégant sur votre écran indiquant tous les matériaux requis, vos stocks réels (inventaire, entrepôt, livreurs, cabane) et la progression réelle de la construction. Tout s'actualise automatiquement en temps réel !

📌 FONCTIONNALITÉS PRINCIPALES

• 📦 Suivi Précis des Matériaux : Affichage clair des quantités possédées / requises (ex: 8 / 20) avec un code couleur dynamique : Rouge (manquant), Orange (partiel), Vert (complet).
• 🛠️ Masquage Intelligent : Un bouton vous permet de masquer les ressources déjà complétées pour rester concentré sur l'essentiel.
• 📊 Progression Réelle du Chantier : Une barre de progression bleue affiche le véritable avancement de la construction (blocs posés / total), distincte de la barre verte de livraison des ressources (nécessite le mod côté serveur).
• 🏗️ Multi-Bâtisseurs : Suivez plusieurs chantiers simultanément ! Changez de bâtisseur d'un simple clic sur les flèches de l'overlay.
• 🔍 Intégration JEI : Un clic droit sur une ligne de ressource ouvre instantanément sa recette de craft dans JEI.

──────────────────────────────────────────────────

🔍 TOOLTIP DÉTAILLÉ & CHRONIQUE DES STOCKS
Survolez n'importe quelle ligne de ressource pour voir exactement d'où proviennent vos matériaux grâce à des icônes dédiées :
• ⊕ Entrepôt (Warehouse)
• ⊙ Cabane du bâtisseur (Builder Hut)
• ↑ En transit (Transporté par un livreur)
• ✋ Main (Votre inventaire de joueur)

⚙️ PERSONNALISATION GRAPHIQUE
Ouvrez n'importe quel menu en jeu pour configurer l'affichage à la souris :
• Glissez-déposez le HUD où vous le souhaitez sur votre écran.
• Étirez le coin inférieur droit (◢) pour ajuster sa largeur.
• 7 niveaux d'échelle (de 50% à 150%) et 5 niveaux d'opacité du fond.
• Sauvegarde automatique dans le fichier : config/resourcehud.json.

──────────────────────────────────────────────────

⌨️ RACCOURCIS PAR DÉFAUT (Modifiables dans vos contrôles)

• [ H ] ── Afficher / Masquer le HUD
• [ J ] ── Afficher / Masquer l'aide des touches
• [ K ] ── Changer la limite de lignes visibles (5 → 10 → 15 → ∞)
• [ L ] ── Ajuster l'échelle globale du HUD
• [ C ] ── Masquer ou afficher les ressources complétées
• [ O ] ── Modifier l'opacité de l'arrière-plan

🖱️ ACTIONS À LA SOURIS (Lorsqu'un menu est ouvert) :
• Clic Gauche + Drag ── Déplacer le HUD
• Drag sur le coin ◢ ── Redimensionner la largeur
• Molette sur le HUD ── Changer de page (si la liste est longue)
• Flèches ◄ / ►     ── Naviguer entre les pages ou les bâtisseurs
• Clic Droit sur item ── Ouvrir la recette JEI

──────────────────────────────────────────────────

💾 INSTALLATION & CONFIGURATION

• 💻 Côté Client Uniquement : Fonctionne sur TOUS les serveurs, même si le serveur n'a pas installé le mod. Le HUD se basera alors uniquement sur le parchemin et votre inventaire personnel.
• 🔌 Côté Serveur (Recommandé) : Si installé sur le serveur, le mod débloque son plein potentiel en scannant en direct les racks de l'entrepôt, les objets transportés par les livreurs et la progression réelle des ouvriers.

📌 DÉPENDANCES REQUISES :
• NeoForge 1.21.1
• MineColonies (N'importe quelle version récente pour 1.21.1)
• Just Enough Items (JEI) - Optionnel mais fortement recommandé

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

──────────────────────────────────────────────────

🧐 HOW IT WORKS
Open a builder's Resource Scroll once and ResourceHUD captures the resource list. It then displays a compact and elegant 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 in real-time!

📌 KEY FEATURES

• 📦 Material Tracking: Clear display of current vs needed quantities (e.g., 8 / 20) with dynamic color-coding: Red (missing), Orange (partial), Green (complete).
• 🛠️ Smart Toggle: Easily hide completed resources to keep your list clean and focus only on what's left.
• 📊 Real Construction Progress: A blue progress bar displays the actual block-by-block building progress (blocks placed / total), independent of the green resource delivery bar (requires server-side mod).
• 🏗️ Multi-Builder Support: Independently track multiple builders during your session. Easily switch between them using the header arrows.
• 🔍 JEI Integration: Right-click any resource row to instantly open the JEI recipe lookup for that item.

──────────────────────────────────────────────────

🔍 DETAILED STOCK TOOLTIPS
Hover over any resource row to see exactly where each unit comes from with dedicated icons:
• ⊕ Warehouse stock
• ⊙ Builder hut inventory
• ↑ In transit (currently carried by deliverymen)
• ✋ Hand (player inventory)

⚙️ DISPLAY & CUSTOMIZATION
Open any in-game screen/menu to fully customize the HUD with your mouse:
• Drag and drop the HUD anywhere on your screen.
• Drag the bottom-right corner handle (◢) to easily resize its width.
• 7 scale levels (from 50% up to 150%) and 5 background opacity levels.
• All settings are automatically saved to: config/resourcehud.json.

──────────────────────────────────────────────────

⌨️ DEFAULT KEYBINDS (Fully rebindable in Options > Controls)

• [ H ] ── Toggle HUD on / off
• [ J ] ── Toggle keybind hints row
• [ K ] ── Cycle row limit (5 → 10 → 15 → ∞)
• [ L ] ── Cycle HUD scale
• [ C ] ── Toggle hide-complete resources
• [ O ] ── Cycle background opacity

🖱️ MOUSE ACTIONS (When any game menu/screen is open):
• Left-Click + Drag ── Move the HUD anywhere
• Drag ◢ corner     ── Resize HUD width
• Scroll on HUD    ── Change page (for long lists)
• Arrows ◄ / ►     ── Change page or switch active builder
• Right-Click row  ── Open JEI recipe lookup

──────────────────────────────────────────────────

💾 INSTALLATION & CONFIGURATION

• 💻 Client-Only Compatible: Works on ANY server, even if the server doesn't have the mod installed. The HUD will fallback to using your local inventory and the basic scroll data.
• 🔌 Server-Side (Recommended): Installing it on the server unlocks its full potential. It enables live scans of warehouse racks, transit items, builder hut contents, and sends real construction data to the client.

📌 DEPENDENCIES:
• NeoForge 1.21.1
• MineColonies (Any recent build for 1.21.1)
• Just Enough Items (JEI) - Optional but highly recommended