worldgen: sober palettes and connected industrial galleries for alpha21

docs/testing-alpha21.md

@@ -0,0 +1,138 @@
+# Alpha.21 — contrat et vérification
+
+Ticket WG-24, branche `codex/palettes-reseaux-alpha21`.
+Minecraft 26.3-pre-2, Fabric Loader 0.19.5, Fabric API 0.160.0+26.3,
+Java 25. Les dépendances restent celles de l’alpha.20.
+
+## Résultat recherché
+
+La ville reprend une palette de pierre lisse, pierre, briques de pierre,
+andésite et chêne. Les plans intérieurs sont conservés ; les corrections
+portent sur les matériaux, les appuis et les couvertures. Chaque infrastructure
+emploie un bois cohérent. Le tuf reste surtout au sol et dans les sous-sols.
+
+La ville peut accueillir deux petits quartiers supplémentaires reliés à son
+cœur, avec du terrain naturel entre eux. La réserve centrale existante n’est
+pas agrandie. Les infrastructures reçoivent davantage de chemins entre des
+entrées réelles. Les recherches respectent des budgets de colonnes et refusent
+un quartier si sa liaison entière ne peut pas être construite.
+
+Les galeries industrielles expérimentales ont cinq blocs de chaussée et un
+trottoir de chaque côté, des salles de maintenance et deux accès par escaliers.
+Le plan est recherché après les structures précédentes et évite leurs volumes,
+l’hydrologie. Un tablier continu peut franchir une cavité entre ses appuis ;
+les travées sans appuis complets sont limitées à 34 blocs, avec des piliers
+locaux d’au plus 16 blocs et deux couches de roche intacte sous les appuis. Chaque tronçon a une pièce native
+locale ; aucun démarrage de structure ne charge toute l’île.
+
+## Sauvegardes et comparaison
+
+Créer un **nouveau monde Sanctuary**, taille **Moyen**, graine **0**, avec
+**Structures expérimentales** activées. Petit 512, Moyen 724 et Grand 1024 restent
+les tailles proposées par le bouton natif **Personnaliser**.
+
+Le nouveau codec est `sanctuary:island_v21`. Les codecs et pièces 20 et
+antérieurs restent disponibles, sans modifier leurs rendus. Le journal 21
+réutilise le schéma de persistance existant avec une génération distincte ;
+les ouvertures entre versions incompatibles sont refusées. Aucune conversion
+ni rénovation automatique des mondes précédents n’est effectuée.
+
+Pour comparer sans les infrastructures, créer un autre monde avec l’option
+expérimentale désactivée. Une sauvegarde 21 nécessite le binaire 21 ou un futur
+binaire compatible ; elle ne se rétrograde pas en remplaçant simplement le JAR.
+
+## Compatibilité vérifiée
+
+373 fichiers de production historiques sont identiques au commit de publication
+20 (`0edac29`). Le preset caché `sanctuary_v20` est une copie exacte de son
+ancien preset public. Création et réouverture natives de la génération 20 donnent
+les mêmes plans, structures, appuis, accès et coffres que les rapports publiés.
+La comparaison ignore seulement l’identifiant du processus, le chemin du monde
+et deux nouveaux compteurs de détail ajoutés à l’oracle de connexion des tests.
+
+## Galeries vérifiées dans Minecraft
+
+Moyen, graine 0 : 23 modules dont deux accès et une salle, sur un axe de 340 blocs.
+Les entrées sont `-135 253 -178` et `-135 249 162` ; chaussée à Y 216. La portée
+sans appuis complets la plus longue du témoin est 17 blocs. Le plan emploie
+8 686 colonnes de bruit, avec un budget maximal de 12 000 ; cette recherche prend
+environ 11 secondes sur la machine de développement, hors reste du monde.
+
+La création et la réouverture dans deux JVM distinctes passent : 34 chunks
+FULL, 57 635 blocs vérifiés, mêmes pièces natives, mêmes coffres différés et
+modification témoin conservée. L’oracle de collision de Minecraft vérifie un
+corps de 0,6×1,8 bloc, 74 cibles et 520 pas entre les deux portiques ; il utilise
+les vrais escaliers et les demi-marches des trottoirs.
+
+Une alcôve d’excavation inachevée ouvre le parement de la salle sur une paroi
+irrégulière de tuf, pierre et deepslate. Certains tronçons exposent de petits
+filons ordinaires. Le témoin contient cinq minerais de charbon, dix-neuf de
+fer, cinq de redstone, un de diamant et un d’émeraude ajoutés dans ces fronts.
+Cuivre, or et lapis font aussi partie des variantes possibles. Ce sont des
+blocs finis, sans mécanisme de réapparition après minage. Ces quantités excluent
+les minerais naturels de l’île et ne constituent pas une garantie par graine.
+
+## Autres vérifications
+
+La création et la réouverture natives de la ville passent. Le témoin possède
+un cœur et deux quartiers reliés, 65 pièces de rue, trois immeubles de logements,
+un hôtel, une bibliothèque, un jardin et une place. La réserve centrale n’est
+pas étendue. Les deux nouveaux chemins sont longs de 51 et 38 cellules. Une
+expansion de test distincte est également vérifiée ; aucune expansion personnelle
+n’est activée.
+
+La piscine couverte, le garage, la salle d’expansion, leurs accès et les égouts
+restent présents. Les contrôles natifs vérifient les bassins et sorties après
+exécution observée de la simulation des fluides.
+
+Les quatorze types de lieux patrimoniaux apparaissent sur Moyen, graine 0,
+avec douze liaisons et 127 segments. Leur création native passe : 141 pièces,
+91 271 blocs, 140 chunks FULL et quatorze coffres différés. Les trois réseaux
+oubliés sont également parcourus. Les chemins rejoignent deux entrées de ville.
+L’observatoire et le quai du vide restent isolés sur ce témoin : leurs chemins
+n’ont pas trouvé de tracé admissible dans le budget. La commande `/sanctuary structures` indique leurs entrées ; aucun raccord
+construit complet n’est revendiqué.
+
+Les smokes des renderers, plans, pièces enregistrées et raccords passent.
+La réouverture des lieux patrimoniaux conserve également le plan, les pièces,
+les coffres et la modification témoin. L’option expérimentale désactivée passe :
+elle ne publie aucun module de galerie. `check build assemblePack` passe, avec les huit GameTests généraux. Le
+MRpack, son index et le JAR embarqué sont vérifiés ; la publication et la
+synchronisation restent à consigner.
+
+Les chemins de quartier regroupent leurs pentes à l’intérieur de rectangles ;
+leurs frontières et raccords sont des paliers plats. Les structures restent
+conditionnées par le terrain admissible, dans un budget borné. La traversée
+industrielle ne relie pas encore tous les réseaux souterrains historiques.
+
+Les vues de modèles éventuelles ne remplacent pas une inspection dans le client.
+Aucune validation Windows native ni charge multijoueur n’est revendiquée.
+
+
+## Reproduire les contrôles
+
+Depuis ce dépôt, avec Java 25, les mondes de test restent sous `mods/sanctuary/build/`.
+Pour chaque scénario, exécuter la création puis sa réouverture avant tout autre
+scénario qui nettoie ce monde de développement :
+
+```sh
+./gradlew :sanctuary:runGameTest -PsanctuaryTransit21Tests=true -PsanctuaryResourceSurvey=off -PsanctuaryDensityMaps=false --max-workers=1
+./gradlew :sanctuary:runGameTest -PsanctuaryTransit21Tests=true -PsanctuaryExpansionReload=true -PsanctuaryResourceSurvey=off -PsanctuaryDensityMaps=false --max-workers=1
+```
+
+Remplacer `sanctuaryTransit21Tests` par `sanctuaryLostCity21Tests` pour la ville
+ou `sanctuaryHeritage21Tests` pour les infrastructures. Le cas OFF ajoute
+`-PsanctuaryExperimentalStructures=false` à une création du scénario transit.
+Les rapports de cette livraison sont conservés localement dans
+`build/alpha21-evidence/`. `./gradlew check build assemblePack` constitue la
+vérification complète avant export.
+
+## Artefacts vérifiés
+
+MRpack : `Sanctuary-0.1.0-alpha.21.mrpack`. Son JAR est identique au JAR du build.
+Les versions et hashes de l’index packwiz sont contrôlés, ainsi que le ZIP
+d’amorçage Prism. SHA-256 du JAR :
+
+```text
+e528e42d99f9e1ea221f780ea089b49b42a1a4e9e24e4ddd001d045183202c21
+```