sanctuary-beta/docs/catalogue-progression-beta099.md

# 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.