Builder's Materials HUD

## ResourceHUD v2.12 — EN

This release bundles the fixes from 2.11 (never published on its own) and 2.12.

**Security — MineColonies research start**

- The HUD's "start research" button did not check colony permissions. On a server, a player could start a research in a colony that wasn't theirs.
- It now requires the same permission as the University window (hut management). **Recommended update for every multiplayer server.**

**Fix — stock mixed across colonies**

- On a server with several colonies, the displayed stock added up the warehouses and couriers of **every** colony, not just yours: wrong quantities, and neighbouring warehouses' contents exposed.
- Only colonies you have access to are counted now.

**Fix — builders mixed up**

- Server-side, the HUD could not tell apart the builders of the same colony: the inventory and progress shown could belong to another builder.
- Each build site now shows its own builder.

**Performance — no more chunk loading**

- The warehouse scan could force-load the chunks holding the racks, on the server's main thread, every few seconds. On servers with distant colonies this caused lag spikes.
- Racks in unloaded areas are now skipped until the area is loaded again.
- Server-side debug logging has also been cut down heavily.

**MineColonies 1.1 compatibility**

- Citizen name, citizen status and builder highlighting on click had stopped working since MineColonies 1.1: several methods had been renamed, with no visible error.
- The **Storage** tab no longer refreshed when the colony was out of range.
- Available stock is now read through MineColonies' public API, which makes it more robust to updates.
- Tested with MineColonies 1.1.1392 and NeoForge 21.1.249. Minimum NeoForge version is still 21.1.219.

**Server side**

This mod is not client-only: the security and performance fixes above only take effect once **the server** is updated.

The network format hasn't changed since 2.10: a 2.10 or 2.11 client works with a 2.12 server, and vice versa. Updating a server carries no risk of breaking connections.

## ResourceHUD v2.12 — FR

Cette version regroupe les correctifs de la 2.11 (jamais publiée séparément) et de la 2.12.

**Sécurité — lancement de recherche MineColonies**

- Le bouton de lancement de recherche du HUD ne vérifiait pas les permissions de la colonie. Sur un serveur, un joueur pouvait démarrer une recherche dans une colonie qui n'était pas la sienne.
- Il faut désormais la même permission que dans l'interface de l'University (gestion des huts). **Mise à jour recommandée pour tous les serveurs multijoueurs.**

**Correction — stocks mélangés entre colonies**

- Sur un serveur avec plusieurs colonies, le stock affiché additionnait les entrepôts et les livreurs de **toutes** les colonies, pas seulement la vôtre : quantités fausses, et contenu des entrepôts voisins visible.
- Seules les colonies auxquelles vous avez accès sont maintenant prises en compte.

**Correction — mélange entre builders**

- Côté serveur, le HUD ne savait pas distinguer les builders d'une même colonie : l'inventaire et la progression affichés pouvaient être ceux d'un autre builder.
- Chaque chantier affiche maintenant son propre builder.

**Performance — plus de chargement de chunks**

- Le scan des entrepôts pouvait forcer le chargement des chunks où se trouvaient les racks, sur le thread principal du serveur, toutes les quelques secondes. Sur les serveurs aux colonies éloignées, cela provoquait des pics de lag.
- Les racks situés dans une zone non chargée sont désormais ignorés jusqu'à ce qu'elle le redevienne.
- Les logs de debug côté serveur ont aussi été fortement allégés.

**Compatibilité MineColonies 1.1**

- Le nom du citoyen, son statut et la surbrillance du builder au clic ne fonctionnaient plus depuis MineColonies 1.1 : plusieurs méthodes avaient été renommées, sans aucune erreur visible.
- L'onglet **Storage** ne se rafraîchissait plus quand la colonie était hors de portée.
- La lecture du stock disponible passe maintenant par l'API publique de MineColonies, ce qui la rend plus robuste aux mises à jour.
- Testé avec MineColonies 1.1.1392 et NeoForge 21.1.249. La version minimale de NeoForge reste 21.1.219.

**Côté serveur**

Ce mod n'est pas client-only : les correctifs de sécurité et de performance ci-dessus ne prennent effet que si **le serveur** est mis à jour.

Le format réseau n'a pas changé depuis la 2.10 : un client 2.10 ou 2.11 reste compatible avec un serveur 2.12, et inversement. Pour un serveur, la mise à jour est donc sans risque de rupture.