Add alpha.17 experimental forgotten structure networks

docs/testing-alpha17.md

@@ -0,0 +1,95 @@
+# Alpha.17 — réseaux oubliés, prototype réversible
+
+**État : code et artefacts vérifiés ; publication en cours.** Ticket WG-20, branche
+`codex/structures-experiment-alpha17`. Minecraft 26.3-pre-2, mêmes dépendances
+que l’alpha.16. Cet essai porte sur les lieux et leur génération.
+
+## Contrat
+
+Créer un **nouveau monde Sanctuary**, puis **Personnaliser** : Petit 512,
+Moyen 724 par défaut, Grand 1 024 et **Structures expérimentales** (activées par
+défaut). Le choix est enregistré dans le générateur 17, avec la taille. Désactiver
+l’option pour un autre nouveau monde permet de comparer avec le socle urbain 16.
+Ce bouton ne supprime ni ne rajoute de structures dans une sauvegarde existante.
+
+Les anciens mondes gardent leurs codecs, rendus, pièces et futurs chunks. Le
+preset 16 historique est conservé à l’identique et caché à la création. Le 17
+possède son propre journal ; aucune conversion ni rétrogradation de sauvegarde
+n’est proposée. Le retour au binaire 16 concerne seulement les mondes 16 et
+antérieurs, jamais un monde 17.
+
+Les nouvelles structures sont recherchées sur l’île initiale uniquement, hors
+ville et eaux protégées. Trois petits réseaux distincts : mines et ateliers,
+salles étranges, installations techniques abandonnées. Salles et couloirs se
+raccordent à des accès de surface. Les fondations reposent sur le terrain ou sur
+des appuis courts certifiés. La présence dépend des emplacements trouvés dans
+un budget borné. Les jonctions entre familles restent une étape suivante.
+
+Les établis, fourneaux et outils vanilla donnent des usages aux installations ;
+rails, soutènements et chantiers interrompus suggèrent les anciens occupants.
+Les lieux étranges sont physiques dans l’île, distincts de la future dimension
+Backrooms. Aucun réacteur, progression, relique collective, récompense personnelle
+ou nouveau spawner n’est ajouté par ce prototype. Les coffres éventuels utilisent
+les tables de butin vanilla.
+
+## Vérification et essai
+
+Le monde **Moyen, graine 0**, option expérimentale activée, reçoit trois réseaux
+avec cinq pièces chacun. Les contrôles natifs portent sur **15 pièces**, **7 639
+blocs**, **13 chunks FULL**, **12 appuis**, **49 cibles de parcours** et **3 coffres
+à butin différé**. Les empreintes des starts, le plan et un bloc d’or témoin sont
+conservés après réouverture dans une seconde JVM. Les trappes sont ouvertes pour
+vérifier le parcours réel d’un joueur, puis refermées avant la sauvegarde.
+
+| Réseau | Entrée X / Y / Z |
+| --- | --- |
+| Mine et atelier | **78 / 252 / 179** |
+| Salles étranges et archives | **−194 / 254 / −22** |
+| Locaux techniques | **116 / 253 / −157** |
+
+Avec les commandes autorisées :
+
+```text
+/locate structure sanctuary:forgotten_networks
+```
+
+La commande donne une entrée de surface. Le prototype recherche les trois
+familles, sans les garantir sur chaque graine. Les neuf types de salles et
+couloirs plus l’accès sont testés sur des dimensions et ouvertures variées ;
+les plafonds, appuis de mobilier, orientations et chemins sont contrôlés.
+
+Les trois smokes dédiés passent. Les huit contrôles moteur du socle passent,
+avec conservation des cavités et eaux naturelles. Les trois tailles et les deux
+valeurs de l’option passent le stockage réel des paramètres sur disque.
+
+La planification des réseaux prend environ une seconde après celle de la ville
+sur le témoin 0 de ce Mac : 915 colonnes lues et 11 974 sondages, pour des plafonds
+respectifs de 5 000 et 250 000. Cela ne mesure ni le rendu client ni le chargement
+complet sur une autre machine. Rapports locaux ignorés :
+`build/alpha17-evidence/ruins17-create.json` et `ruins17-reload.json`.
+Logs : `build/alpha17-native-create-final.log`, `alpha17-native-reload.log`,
+`alpha17-first-native-base.log`, `alpha17-planner-piece-smokes.log`.
+
+L’essai natif avec **Structures expérimentales désactivées** passe : plan vide,
+zéro sondage expérimental et booléen conservé. Rapport :
+`build/alpha17-evidence/ruins17-disabled.json`, log `build/alpha17-native-disabled.log`.
+La création et la réouverture actives utilisent les processus 32029 et 32123 ; le
+cas désactivé utilise 32176. Aucune sauvegarde personnelle n’a été ouverte.
+
+La création et la réouverture des mondes de génération **16** passent sous le
+binaire 17 : les 71 pièces de la ville initiale et du continent témoin gardent
+leurs empreintes natives, ainsi que le journal, les paramètres et le bloc d’or
+témoin de la version publiée. Rapports :
+`build/alpha17-evidence/legacy16-create.json` et `legacy16-reload.json`.
+Le preset 16 historique est également identique octet par octet. La comparaison
+avec les reçus publiés est consignée dans `legacy16-comparison.json` :
+création sous 17 dans le processus 32244, réouverture dans 32429.
+
+`./gradlew check build assemblePack` passe : 52 tâches, huit GameTests moteur
+et les trois smokes du prototype. Le JAR de production exclut les classes de
+test ; les versions, les hashes du pack, le MRpack et le ZIP d’amorçage Prism
+sont vérifiés. Journal final : `build/alpha17-final-check-build-pack.log`.
+
+La publication et la synchronisation de l’instance sont en cours. Aucun essai
+Windows natif ni revue visuelle dans le client n’est revendiqué ; le prochain
+essai de Koka validera l’ambiance.