Integrate verified Sanctuary beta.110 with clay workshop, eggs and seasonal snow

docs/catalogue-progression-beta099.md

@@ -0,0 +1,127 @@
+# beta.099 — Progression, catalogue du Métabli et gestes K
+
+Contrat de réalisation, 16 septembre 2026. Branche `codex/catalogue-progression-beta099`.
+
+- Compétences en haut de la colonne gauche, arbre des progrès Minecraft intégré
+  dessous ; aptitudes à droite. Prestige et historique sous l’arbre.
+- Catalogue visuel natif : trois derniers plans terminés en accueil, statues,
+  machines, bâtiments, infrastructures, décoration et bibliothèque. Même format
+  de fiches (aperçu, nom, dimensions, description et sélection).
+- Historique personnel local de trois plans terminés, sans autorité sur le monde :
+  aucun choix de plan n’est compté comme construction et chaque placement reste
+  contrôlé par le serveur. Le stockage est distinct des sauvegardes Minecraft.
+- Palette de statue étendue aux blocs ayant un objet utilisable, échantillonnée
+  depuis le pack actif. Pas de blocs techniques sans objet ni de commandes.
+- Clé dorée : modèle plat d’outil Minecraft. Texture provisoire vanilla, à
+  remplacer par la texture que le créateur fournira ; aucune texture dessinée
+  à sa place.
+- K bref ancre au bloc visé ; rappuyer sur le même point tourne de 90 degrés.
+  K maintenu ouvre le cockpit. Viser le vide ne repositionne pas le projet.
+
+## Contrat de génération et de compatibilité
+
+Le module EXPANSION_HALL conserve sa géométrie, ses appuis, son piédestal et son
+identifiant. Les nouvelles pièces natives de la salle indépendante portent un
+champ optionnel `SanctuaryMetatable099=true` : neuf parties de Métabli assemblées
+sont posées au centre, un bloc au-dessus du piédestal. Une pièce enregistrée sans
+ce champ conserve son comportement ancien (aucun ajout), même si un de ses chunks
+n’était pas encore décoré. Le champ ne modifie ni le journal ni la graine ni les
+identifiants de génération. Aucune régénération ou écriture dans un monde
+personnel existant. Les nouvelles salles générées après cette version reçoivent
+l’exemple ; les salles déjà enregistrées ne sont pas modifiées.
+
+Une fois généré, le Métabli suit les règles normales : le casser le désassemble,
+et le reconstruire exige la clé dorée. Pas de réparation automatique au chargement.
+Vérification prévue sur nouvelles sauvegardes de développement et round-trip NBT
+avec et sans le champ optionnel, génération en plusieurs ordres de chunks.
+
+## Validation
+
+Deux essais natifs sur Minecraft **26.3 finale**, nouveaux mondes de développement :
+
+- `Catalogue099ClientChecks` : **réussi en 1 min 33 s**. Génération et construction
+  d’une statue de Creeper de 32 blocs (1 542 cellules) avec la palette étendue ;
+  construction des plans Fourneau et Abri, confirmation/annulation, retrait du
+  créatif pendant la confirmation et refus d’un envoi falsifié en survie. Pose
+  manuelle via le contrôleur Minecraft consommant exactement un bloc. Trois plans
+  terminés mémorisés, conservés au changement de monde, écrits sur disque et
+  décodés. Catalogue physique, catégories, aperçus, import/export, abandon et
+  destruction du Métabli ; K bref/rotation/visée vide/maintien. Arbre des progrès
+  sous les compétences, clic droit passant par l’écran et activant réellement le
+  suivi. Interfaces FR/EN, échelles 2 et 3, petite fenêtre et fenêtre 1280 × 800.
+- `Temple097ClientChecks`, étendu à la salle : **réussi en 4 min 48 s**, graine
+  **-4700804240597771092**, génération racine `sanctuary:island_v24`. Origine des
+  neuf parties du Métabli : **(-56, 169, -117)**, sur le piédestal de pierre lisse.
+  Les neuf états `part=0..8` sont présents après génération puis après sauvegarde
+  et réouverture du monde de développement. Aller-retour NBT du nouveau champ ;
+  ancien tag sans champ restant sans champ. Régression des deux temples natifs,
+  coffres, pièges et cache de planification réussie.
+
+Les captures d’interface vérifiées sont dans `build/catalog099-evidence/`.
+Journaux : `build/catalog099-client.log` et `build/catalog099-hall.log`.
+La capture de la salle prise immédiatement après téléportation précédait le
+rendu des chunks et n’est pas utilisée comme preuve visuelle ; les assertions
+sur les blocs, appuis et sauvegardes constituent la validation de sa génération.
+
+Les premiers passages ont détecté deux problèmes corrigés : les petits blocs
+(fleurs) favorisés par une comparaison de couleur seule, et la protection native
+des vestiges refusant l’ajout du Métabli hors de leur contexte de génération.
+Des clics automatisés immédiatement après redimensionnement donnaient aussi un
+rayon de caméra périmé : les interactions physiques répétées du test passent
+maintenant par le contrôleur client Minecraft et son protocole normal, avec
+contrôle serveur de la consommation et de l’ouverture. Les gestes K et le suivi
+des progrès restent testés par les événements d’entrée natifs.
+
+`check build assemblePack assembleTestPack` : **réussi en 3 min 7 s**, 124 tâches.
+Le GameTest sur serveur dédié est exclu ; les tests client natifs ci-dessus
+utilisent uniquement les mondes de développement.
+
+Les deux exports packwiz sont vérifiés : version, sources Java, contenu du JAR,
+absence des classes de test et conservation des archives beta.098. Reçu complet :
+`build/beta099-artifact.json`.
+
+| Archive | Octets | SHA-256 |
+| --- | ---: | --- |
+| `Sanctuary-beta.099.mrpack` | 9 908 941 | `9722e2410e18bba34cf5db835facec4bb29fc3bd7f071942e7c8321a60d955ed` |
+| `Sanctuary-Test-beta.099.mrpack` | 9 927 866 | `7ce02718c2e4c780197f9984b1ac7bc7a443f78eaa3e7d8ea248aa6b2e75745a` |
+
+Aucune publication du canal ni installation personnelle effectuée.
+
+## Détails du catalogue
+
+Les vignettes de plans utilisent les quads, UV et textures du pack actif.
+Les blocs rendus par un moteur spécial sans quads (certains conteneurs) ont une
+silhouette issue de leur forme. Les vignettes sont mises en cache (48 au maximum),
+invalidées lors d’un rechargement du pack. Les échantillons sont bornés à 64 × 64
+par texture et prennent la première image des textures animées.
+Les statues du catalogue affichent le modèle natif adulte ; le choix ouvre les
+réglages de hauteur et de palette avant génération. Sur les petites fenêtres,
+la description et les dimensions passent dans l’infobulle pour garder le choix
+visible sous la vignette.
+
+La palette « Tous les blocs » parcourt les blocs enregistrés ayant un objet,
+sans inclure les blocs techniques sans objet ou les blocs de commande. La
+comparaison de couleur utilise Oklab ; un coût de forme favorise les volumes
+pleins, et les blocs soumis à la gravité sont moins favorisés. Les feuilles
+utilisent leur état persistant, comme après une pose par un joueur. Les palettes
+mixte, laine et béton restent disponibles.
+
+L’historique `schematics/sanctuary/recent-completed.nbt` contient au maximum
+trois plans distincts, écrits atomiquement hors du fil de rendu. Il enregistre
+une transition d’incomplet à complet observée dans le monde, en créatif ou en
+survie. Sélectionner un plan, l’apercevoir ou l’envoyer au serveur ne suffit pas.
+Il s’agit d’un historique personnel de cette installation, pas d’un catalogue
+partagé par le serveur. Aucun inventaire ou entité n’est enregistré.
+
+K bref utilise un rayon de 96 blocs sur les blocs du monde. La case adjacente à
+la face visée sert de centre d’ancrage horizontal. Une seconde pression sur ce
+même point tourne autour de cet ancrage ; déplacer le regard vers un autre
+point déplace le plan. Le maintien de 10 ticks ouvre les commandes sans exécuter
+le geste bref à la relâche. Les raccourcis remappés utilisent la même logique.
+
+## Texture de la clé
+
+Le modèle est `minecraft:item/handheld` ; la texture provisoire est une copie
+de la pioche dorée vanilla. Le créateur pourra remplacer uniquement
+`mods/sanctuary/src/main/resources/assets/sanctuary/textures/item/golden_wrench.png`
+par son propre PNG. Aucune illustration personnalisée n’a été créée à sa place.