sanctuary-beta/docs/notifications-beta034.md

# HUD-034 — découvertes et suivi natif

Branche `codex/notifications-beta034`, base beta.033.

## Contrat retenu

Le créateur confirme un **style F3 visible pendant le jeu normal**, en bas à droite.
Les premières observations de blocs, possessions de blocs et découvertes d’objets
ou recettes produisent des messages courts qui s’empilent puis s’effacent.
Les lots de recettes se regroupent ; la file et le nombre de lignes sont bornés.
Les acquisitions répétées et la reconnexion ne rejouent pas l’historique.

Les petites barres utilisent les sprites natifs d’expérience. Elles décrivent les
collections réelles, sans attribuer d’XP supplémentaire. Le suivi des advancements
Minecraft affiche les objectifs visibles déjà commencés, avec leurs critères natifs.
Il utilise les données reçues du serveur, sans modifier les récompenses ni les toasts.

Options client persistantes : fil de découvertes, barres de collections, suivi des
advancements et durée de lecture. Les menus et F1 masquent le HUD ; les messages
attendent la fermeture du menu. Les inconnus ne sont pas révélés par ces messages.

Quêtes, bounties, rubis/saphirs et panneaux ne sont pas ajoutés dans ce ticket.
Le centre sépare messages temporaires et suivis persistants pour accueillir leurs
futurs événements confirmés par le serveur. Aucun faux objectif n’est affiché.
Les règles de progression, sauvegardes et générations existantes restent inchangées.

## Retours intégrés pendant le ticket

Les boutons Factions et History sont retirés du menu pause, à la demande du
créateur. Ils restent accessibles par Progression → Prestige.

La hotbar de l’inventaire personnel utilisait une texture de 182×22 comprimée
sur 164×22. Elle reprend le sprite natif du HUD en **182×22**, neuf cases espacées
de **20 pixels**, et des objets rendus en **18×18** au lieu de 16×16. La rangée
sélectionnée réserve sa hauteur lorsqu’elle se déplace ; les autres rangées,
l’équipement et les index de sauvegarde restent inchangés. Clics, Maj-clics,
balayage et tri utilisent les mêmes surfaces agrandies. Les interfaces de
conteneurs conservent leur grille compacte et leurs emplacements natifs.

Les objets au sol visibles à huit blocs maximum alimentent aussi la connaissance
des objets existante, avec occultation par les blocs et sans acquisition simulée.

## Utilisation

**Options → Notifications** permet de désactiver séparément les messages de
découverte, leurs trois barres de collection et le suivi des progrès Minecraft.
La durée se règle entre 3 et 15 secondes, avec 5 secondes par défaut. Les choix
restent dans `config/sanctuary-notifications.json`, propres à chaque installation.
Les barres de collection accompagnent le fil temporaire ; jusqu’à deux objectifs
Minecraft incomplets restent suivis après sa disparition. Les sous-titres activés
réservent une marge supplémentaire en bas de l’écran.

Les messages affichent au plus cinq entrées. Le serveur regroupe les nouveautés
toutes les dix ticks, à raison de 32 entrées maximum par envoi. Le compteur de
recettes disponibles vient du serveur : le registre des recettes complet n’est
pas exposé par le registre client de Minecraft 26.3-pre-2. Le titre d’une recette
déjà découverte utilise le catalogue chargé de JEI, avec un libellé de secours.
Les objectifs lisent les données natives une fois par seconde ; le dessin du HUD
ne relance aucun parcours du monde ou du catalogue de recettes.

Pour essayer : observer un nouveau bloc, ramasser un nouvel objet puis découvrir
une famille de recettes. Reprendre le même objet ne doit pas rejouer sa première
acquisition. Ouvrir l’inventaire met le fil en attente ; sa hotbar agrandie reste
cliquable jusqu’au bord de la neuvième case, et Tab la déplace toujours de rangée.

## Vérification graphique

Le parcours client natif sur monde plat valide les notifications, les lots de
recettes, leur expiration, les masquages F1/menu, le suivi d’un advancement
Minecraft partiellement accompli, les options persistantes en FR/EN et les
échelles GUI 1 à 4 de l’écran d’options. Il vérifie aussi l’absence de Factions et
History dans Échap, et leur accès par Progression → Prestige.

La hotbar est vérifiée à une et six rangées, puis après son déplacement. Les
clics et Maj-clics au bord agrandi de la neuvième case sont exercés en client
natif, ainsi que le défilement entre rangées, la sélection de case et les offres
du villageois. Les captures sont conservées dans `build/notifications034-evidence`.

## Livraison vérifiée

Minecraft **26.3-pre-2**, Fabric Loader **0.19.5**, Fabric API **0.160.0+26.3**.
`check build assemblePack assembleTestPack` réussit, avec la sélection native
`notifications,menus,recipes,progression,inventoryflow` : **22 tests serveur**,
dont première observation/possession, absence de répétition, isolation entre
joueurs, lots bornés et occultation des objets par les murs. Le test de file
exerce aussi une rafale de 10 000 événements, les priorités et l’expiration.
Le parcours client décrit ci-dessus réussit séparément.

- [Pack normal beta.034](../build/Sanctuary-beta.034.mrpack).
- [Pack test rapide beta.034](../build/Sanctuary-Test-beta.034.mrpack) : monde plat,
  fiche d’habitant conservée et cinématique passée automatiquement.

Les ZIP, métadonnées, 1 320 classes Sanctuary, trois classes du module test,
ressources et dépendances imbriquées sont vérifiés. Le second pack ne diffère
du premier que par son nom et l’ajout du module facultatif de test. JEI reste
en `30.32.0-sanctuary.2`. Les anciennes archives beta.032 et beta.033 sont
inchangées ; aucun monde, canal packwiz ou instance Prism personnelle n’a été
modifié. Client et serveur doivent utiliser ensemble beta.034.

SHA-256 normal : `df0a0c2ab937ccec4361bd37a07a551a592b3d5819ade1f289fa9fb428c355e5`.
SHA-256 test : `cf41d20a118128afd044556e6dee44804852ea7232f2b13623020ec471c3b4fc`.
Reçu : `build/notifications034-artifact.json`. Journaux :
`build/notifications034-check-final.log` et `build/notifications034-client-final.log`.