Add alpha16 inhabited ruins and deep city infrastructure

docs/testing-alpha16.md

@@ -0,0 +1,134 @@
+# Alpha.16 — Sanctuary habitée avant nous
+
+**État : code et artefacts vérifiés ; publication en préparation.** Ticket WG-19,
+branche `codex/sanctuary-ruins-alpha16`. Minecraft 26.3-pre-2, Fabric Loader 0.19.5,
+Fabric API 0.160.0+26.3 et Java 25, comme l’alpha.15.
+
+## Contrat de génération
+
+La génération 16 demande un **nouveau monde Sanctuary**. Le choix public reste
+unique, avec le bouton natif Personnaliser : Petit 512, Moyen 724 par défaut,
+Grand 1024. Les codecs `island_v13`, `island_v14`, `island_v15`, leurs pièces
+natives, journaux, biomes et calculs de chunks futurs sont conservés. Aucun
+monde personnel n’est converti, ouvert par les tests ou régénéré.
+
+Lorsque les structures sont activées, l’île de départ reçoit une ville
+compacte. Une recherche naturelle est suivie, si nécessaire, d’une réservation
+architecturale locale 49 × 49 : rues et bâtiments reliés au-dessus d’un socle
+creux, avec appuis de maçonnerie certifiés. Cette réservation peut dégager le
+terrain et remplacer l’eau dans sa seule emprise, avant le placement des pièces.
+Elle ne modifie pas la densité de toute l’île et ne s’applique pas aux continents.
+Les expansions conservent leur profil et leur placement soumis au terrain.
+
+La passe souterraine comprend une piscine couverte avec bassin de 50 × 25
+blocs et quatre blocs de profondeur, des égouts ouverts et des parkings de
+3, 4, 6 ou 8 plateformes selon les appuis disponibles. Une grande salle sèche
+peut compléter le réseau. Chaque équipement dépend des volumes et appuis
+certifiés sur le terrain ; le tableau
+ci-dessous distingue les témoins natifs des cas de modèle. Les anciens petits
+bassins de la génération 15 restent inchangés.
+
+Les plans des étages alternent réellement. Les sanitaires ont des parois
+complètes, leur porte et leur plafond ; les lits sont adossés aux murs avec
+une rive latérale accessible. Portes, sièges et lanternes conservent leurs
+contrôles d’orientation et d’appui.
+
+## Vérifications
+
+- Les cinq smokes 16 passent : intérieurs, planification, fondation, protection
+  et sous-sols. Ils vérifient notamment les quatre orientations, les plans
+  d’étages, les sanitaires, les lits et les appuis.
+- Matrice de planification moteur : les trois tailles 512/724/1024 × graines 0/1
+  passent. Une ville de 3 à 8 lots, avec rues et entrées reliées dans les six cas.
+  Ces six reliefs trouvent une implantation naturelle ; le recours architectural
+  est couvert séparément par les terrains adverses, le rendu borné et le NBT
+  des smokes. Rapport : `build/alpha16-evidence/planning-matrix.json`.
+- Création native 16, graine 0, taille Moyenne, puis réouverture dans une seconde
+  JVM : **71 pièces, 5 coffres différés, 107 cibles de parcours et 74 appuis**
+  conservés entre l’île et une expansion de 256 blocs. Les hashes des starts,
+  le journal et le bloc d’or témoin restent identiques. Processus 29685 puis 29853.
+  Rapports : `build/alpha16-evidence/final-city-create.json` et
+  `final-city-reload.json` ; logs `build/alpha16-third-city-create.log` et
+  `alpha16-city-reload.log`.
+- Après **120 ticks du monde réellement observés**, la piscine garde ses
+  **4 976 cellules d’eau** ; les deux égouts observés déversent de l’eau au-delà
+  de leur bouche. Dix-neuf témoins temporaires indépendants prouvent l’activité
+  effective du moteur des fluides, puis sont supprimés avant sauvegarde. Les
+  cascades atteignent des corniches : elles ne sont pas toutes libres jusqu’au
+  vide inférieur. Aucun test ne présente une simple attente comme un écoulement.
+- Compatibilité 15 : création puis réouverture sous le mod 16 réussies,
+  76 pièces natives, 5 coffres, 108 cibles de parcours et 5 appuis conservés.
+  Les SHA-256 des deux starts et du journal sont exactement ceux de l’alpha.15
+  publiée. Les fichiers de génération 15 restent inchangés. Le preset caché
+  `sanctuary_v15.json` est identique à l’ancien preset public, SHA-256
+  `6c4a91eede4b9978526d6de6289dbc7394ed4114ebcae9f779fac3ce7e7d887e`.
+  Rapports : `build/alpha16-evidence/legacy15-create.json` et `legacy15-reload.json`.
+- `./gradlew check build assemblePack` passe en 2 min 18 s : huit GameTests,
+  tous les smokes et index du pack vérifiés. Log :
+  `build/alpha16-final-check-build-pack.log`.
+- JAR, MRpack et ZIP d’amorçage vérifiés : même version et même JAR, index et
+  hashes cohérents, aucun code de test embarqué. SHA-256 du JAR :
+  `5504018c46300accf01478dbc8bfb8e216395a5435cf7d7f501005cbc65b8e43`.
+
+### Distribution des sous-sols sur six reliefs
+
+Un second relevé utilise le vrai bruit Minecraft et les protections hydrologiques,
+sans générer les chunks de la ville. Il contrôle les volumes, les fondations et
+les limites de calcul ; les fluides et la persistance restent prouvés par le
+scénario natif ci-dessus. Rapport : `build/alpha16-evidence/underground-matrix.json`.
+
+| Diamètre | Graine | Piscine | Grande salle | Parking | Égout ouvert |
+| --- | --- | --- | --- | --- | --- |
+| 512 | 0 | Absente | Présente | 8 niveaux | Présent |
+| 512 | 1 | Absente | Présente | 8 niveaux | Présent |
+| 724 | 0 | Présente | Présente | 8 niveaux | Présent |
+| 724 | 1 | Absente | Présente | 8 niveaux | Présent |
+| 1024 | 0 | Présente | Absente | 8 niveaux | Présent |
+| 1024 | 1 | Présente | Présente | 8 niveaux | Présent |
+
+La piscine est donc présente dans trois cas sur six, la salle dans cinq cas.
+Les six réseaux ont un accès depuis la surface. Ce petit échantillon ne donne
+pas une fréquence statistique ni une garantie pour les autres graines. Le
+budget souterrain atteint son plafond de 420 000 sondes dans quatre cas ;
+la recherche s’arrête alors en conservant les équipements déjà certifiés.
+Une aile absente ne prouve donc pas l’absence de tout emplacement compatible :
+une autre solution peut se trouver au-delà du budget de recherche.
+La passe souterraine prend 2,9 à 7,0 secondes après la planification de surface
+sur cette machine ; cela ne mesure ni le rendu client ni le chargement complet.
+
+## Repères pour l’essai en jeu
+
+Créer un nouveau monde **Sanctuary, Moyen, graine 0**, structures activées.
+Les coordonnées suivantes proviennent des blocs réellement générés et relus.
+Elles ne constituent pas une migration d’un monde précédent.
+
+| Lieu | Repère X / Y / Z |
+| --- | --- |
+| Entrée de l’immeuble | −30 / 252 / 21 |
+| Trappe depuis la rue | **−19 / 252 / 41** |
+| Promenade de la piscine | −45 / 230 / −11 |
+| Grande salle sèche | −42 / 231 / 20 |
+| Parking, niveau supérieur | 10 / 230 / 20 |
+| Parking, niveau inférieur | 10 / 118 / 20 |
+| Bouche de l’égout inférieur | **−50 / 117 / 20** |
+
+Le bassin remplit X −44 à 5, Y 225 à 228, Z −23 à 1. Les plateformes du
+parking sont à Y 117, 133, 149, 165, 181, 197, 213 et 229. Le réseau est
+accessible depuis la trappe de rue. Sur ce témoin, la cascade atteint une
+corniche à Y 113. L’expansion de référence `city16_0_2`, graine
+9111000990819250332, possède aussi une bouche à 1958 / 202 / −651.
+
+Les équipements restent conditionnés par leurs volumes et appuis ; seule la
+zone de ville initiale est garantie par le recours architectural. Aucun essai Windows natif ni revue visuelle en client n’a été effectué pour
+cet incrément ; les vérifications ci-dessus proviennent du moteur serveur Mac. Le pack doit encore être validé en jeu par Koka.
+
+## Suite validée avec Koka, hors alpha.16
+
+Développer les trois familles : mines et ateliers, lieux étranges,
+infrastructures à réactiver. Plusieurs réseaux distincts se connectent parfois.
+Les installations encore utilisables et les chantiers interrompus racontent
+l’occupation passée par d’autres joueurs. Les back rooms de ces donjons sont
+physiquement dans l’île et restent distinctes de la dimension des objets perdus.
+Le butin combinera des reliques collectives uniques et des récompenses
+personnelles. Les règles d’attribution restent à définir ; aucun réacteur,
+nouveau spawner de donjon ou système de progression n’est ajouté ici.