Add living caverns and connected water terraces for alpha.9

docs/worldgen.md

@@ -5,10 +5,11 @@ entourée de vide sans répétition d'îles à grande distance. C'est une premi
 tranche de génération pour Minecraft **26.3-pre-2 / Fabric**, pas encore le
 système d'expansion collective.
 
-L’alpha.8 utilise les paramètres `sanctuary:sanctuary_rift`. Ses contrôles
-dans les vrais chunks passent sur les trois graines de référence, avec
-1 800 ticks de fluides. Les observations et limites de cette version sont
-consignées séparément des générations précédentes dans [Validation](testing.md).
+L’alpha.9 utilise les paramètres `sanctuary:sanctuary_cavern`, pour de nouveaux
+mondes uniquement. Sa validation moteur passe sur les trois graines de référence. L’alpha.8 conserve
+`sanctuary:sanctuary_rift` et ses résultats sur trois graines avec 1 800 ticks
+de fluides ; ils ne valident pas la génération v9. Les observations de chaque
+version restent séparées dans [Validation](testing.md).
 
 ## Créer un monde
 
@@ -27,7 +28,10 @@ La seed est libre. Modifier `level-type` ne convertit pas un monde existant :
 utiliser un nouveau `level-name` pour tester une autre génération. Les fichiers
 de test et les sauvegardes personnelles doivent rester distincts.
 
-## Ce qui est généré
+## Socle de génération conservé
+
+Les points suivants décrivent le socle livré jusqu’à l’alpha.8. Les évolutions
+alpha.9 et leur état de validation sont précisés dans la section v9 ci-dessous.
 
 - Le générateur reste celui de Minecraft, `minecraft:noise`.
 - La forme reprend le champ de bruit flottant actif en 26.2 : `old_blended_noise`
@@ -59,8 +63,10 @@ de test et les sauvegardes personnelles doivent rester distincts.
   Dappled Forest est réservé aux futurs continents. Leur végétation et leurs animaux proviennent
   de Minecraft 26.3-pre-2. Les nouveaux identifiants ne reprennent pas les tags
   de structures vanilla, afin de ne pas placer leurs structures dans le vide.
-- Les carvers, géodes, donjons, grands lacs de lave et sources vanilla sont
-  retirés. L’eau de Sanctuary suit son propre plan de surface et de niches
+- Jusqu’à l’alpha.8, les carvers, géodes, donjons, grands lacs de lave et sources
+  vanilla sont retirés. L’alpha.9 ajoute une intégration bornée de géodes et
+  de geysers, sans réactiver l’ensemble de la décoration souterraine vanilla.
+  L’eau de Sanctuary suit son propre plan de surface et de niches
   rocheuses. Les arbres et les petits filons ont besoin du terrain existant.
   Aucun mod de biomes externe n’est nécessaire.
 
@@ -71,6 +77,103 @@ chaque seed. L’accès à chaque progression vanilla et les ressources renouvel
 nécessitent des vérifications concrètes. Les stocks réels sont relevés après la
 génération, sans corriger une île pour atteindre un quota.
 
+## Cavités et terrasses d’eau — génération v9
+
+Le nouveau réglage est `sanctuary:sanctuary_cavern`, avec le biome source
+`sanctuary:cavern_island` et la règle de matière `sanctuary:cavern_island`.
+La densité réutilise `sanctuary:final_density_rift` sans changer cet identifiant
+historique. Ses nouvelles données et traitements
+doivent rester distincts de `sanctuary:sanctuary_rift` et de toutes les
+générations précédentes. Le preset sélectionne la nouvelle génération à la
+création ; une mise à jour du JAR ne convertit pas une sauvegarde ni ne
+régénère ses chunks. Les cavités restent dans l’Overworld sur 384 blocs de
+hauteur ; la dimension des cavernes décrite dans la vision n’est pas ajoutée.
+
+### Ambiances et ressources
+
+Le ticket conserve les forêts de surface et ajoute des cavités luxuriantes
+éclairées par leur végétation, des secteurs à spéléothèmes et des géodes
+d’améthyste sur des emplacements compatibles. Les sols, plafonds, coquilles
+et ouvertures doivent être observés après la décoration réelle : une valeur
+de biome ne prouve ni le décor ni son éclairage. L’objectif est d’utiliser
+les volumes naturels de l’île, sans remplir ses trous pour accueillir une
+structure.
+
+Les dix biomes ont leurs propres identifiants : `cavern_oak_forest`,
+`cavern_birch_forest`, `cavern_clearing`, `cavern_dry_woodland`,
+`cavern_rocky_heath`, `cavern_dark_grove`, `cavern_bamboo_grove`,
+`cavern_sulfur_depths`, `cavern_lush_caves` et `cavern_dripstone_caves`, dans
+le namespace `sanctuary`. Les deux nouvelles ambiances luxuriantes et à
+spéléothèmes sont limitées à Y<184 par la palette ; leur décoration recherche
+des sols entre Y=40 et Y=182, avec trois blocs naturels de support et un
+plafond situé de 6 à 48 blocs au-dessus.
+
+Dans les cavités luxuriantes, la mousse remplace le sol compatible et de
+petites plantes l’accompagnent. Les vraies lianes `cave_vines` et
+`cave_vines_plant` pendent sur 3 à 8 blocs ; leurs baies émettent de la lumière
+et restent récoltables. Ce décor n’ajoute pas d’eau. Les spéléothèmes utilisent
+les blocs `pointed_dripstone` orientés, sur un appui de `dripstone_block`
+remplaçant de la roche existante, avec une longueur de 1 à 4 blocs selon
+l’espace disponible.
+
+La géode utilise une configuration vanilla compacte avec améthyste,
+améthyste bourgeonnante, calcite et basalte lisse. Son enveloppe doit tenir
+dans la roche préexistante et un passage de deux blocs de haut la relie à
+la cavité, en préservant l’améthyste bourgeonnante et les cristaux attachés.
+Un chunk sur huit est candidat ; au plus une pose réussie est retenue par
+chunk candidat. Cela ne garantit pas de géode sur une graine.
+
+Le soufre devient admissible dans une bande climatique plus étroite sous
+Y=176. La réduction de cette sélection peut être testée indépendamment du
+terrain ; seule une comparaison des vrais blocs sur un périmètre commun
+mesure sa diminution dans l’île. Un geyser éventuel creuse un seul bloc de
+sol pour sa source d’eau, avec `potent_sulfur` dessous et `magma_block` encore
+en dessous. Le fond, les quatre parois et la hauteur libre sont contrôlés.
+Le cycle du geyser reste celui de Minecraft ; ce décor est distinct des
+bassins hydrologiques et son eau doit être comptée séparément.
+
+Leur présence, leur activité, l’éclairage et la cohabitation avec les eaux
+et la végétation sont contrôlés dans les mondes de test. Les preuves de ces
+éléments sont cumulées sur les trois graines. Un site incompatible peut
+être rejeté ; aucun geyser ni stock n’est garanti pour chaque graine.
+
+### Lacs et bassins étagés
+
+Le plan hydrologique conserve la recherche de rivière de
+l’alpha.8 et vise de plus grands lacs de surface. Les cibles actuelles sont
+de l’ordre de **700 à 1 100 colonnes** par grand lac, jusqu’à **7 à 8 blocs**
+de profondeur intérieure et une incision limitée à **12 blocs**. Ce sont des
+bornes de recherche ; les dimensions réelles sont relevées séparément, sans quota d’eau à
+remplir. Les fonds, les parois et les dépôts exigent du terrain naturel.
+
+Les terrasses sont recherchées dans des cavités entre **Y=56 et Y=208**,
+avec deux paliers par groupe et jusqu’à deux groupes facultatifs.
+Un palier vise environ **40 à 180 colonnes**, une profondeur de **1 à 3 blocs**
+et une incision d’au plus **5 blocs**. Le fond doit conserver trois couches
+de sédiments et deux couches de support naturel ; le plafond et l’espace
+disponible sont vérifiés. Les mesures moteur précisent les sites effectivement retenus.
+
+La recherche suit le choix de pente de l’eau vanilla : parmi les passages
+libres, elle privilégie ceux qui rejoignent la chute la plus proche. Un
+bassin inférieur doit intercepter ce trajet réel, sans détour creusé pour
+le rejoindre. Les sorties entre paliers sont déclarées et les cascades sont formées par les
+ticks de fluides Minecraft. Le premier débordement doit atteindre le second
+bassin. Celui-ci peut avoir un exutoire terminal qui s’écoule sur les roches
+ou vers le vide, sans troisième bassin ajouté. Le générateur ne doit ni peindre une colonne
+d’eau jusqu’au vide ni colmater un trou pour retenir un bassin. Les volumes
+retenus et les liaisons réelles sont vérifiés séparément après décoration
+et simulation, y compris aux frontières de chunks. Les cascades peuvent
+servir à monter ou descendre selon la nage vanilla ; aucune mécanique
+d’ascenseur supplémentaire n’est prévue. « Rizières » décrit seulement
+l’aspect du paysage en terrasses, sans ajouter une culture de riz.
+
+**Validation moteur au 9 septembre 2026 :** les trois graines de référence
+passent les contrôles après 1 800 ticks, avec preuves cumulées des terrasses
+connectées, geysers actifs, baies lumineuses, spéléothèmes et améthyste
+bourgeonnante. Le build complet réussit. Les résultats et leurs limites sont
+consignés dans [Validation](testing.md). Aucune présence universelle n’est
+garantie ; la distribution est vérifiée séparément selon le guide packwiz.
+
 ## Failles, géologie et ressources — génération v8
 
 Les nouveaux mondes utilisent `sanctuary:sanctuary_rift`, la densité