Add contained surface hydrology to Sanctuary Island

docs/worldgen.md

@@ -34,7 +34,8 @@ de test et les sauvegardes personnelles doivent rester distincts.
 - Le terrain naturel reste libre de laisser un trou à l'origine, de former des
   surplombs ou de se séparer en fragments. **Aucun noyau ellipsoïdal, cylindre ou
   plateforme de départ n'est ajouté.** Au-dessus de `Y=144`, le relief de la
-  génération précédente est conservé, simplement relevé de 64 blocs.
+  génération précédente est conservé dans la densité, simplement relevé de 64
+  blocs. L’hydrologie v4 creuse ensuite localement les lits de surface.
 - Le pourtour est sculpté par retrait de matière à partir du rayon **128 blocs**.
   Le contour de référence de 256 blocs est déformé par les bruits, entre 204 et
   288 blocs ; il indique la fin de l'érosion, pas un mur de roche.
@@ -46,7 +47,7 @@ de test et les sauvegardes personnelles doivent rester distincts.
   Il n'y a ni plancher de bedrock,
   ni mer globale, ni reprise du terrain à distance. Le Nether et l'End restent
   ceux de Minecraft.
-- `sanctuary:starter_forest` reprend végétation, minerais et animaux de la forêt
+- `sanctuary:starter_forest_hydrology` reprend végétation, minerais et animaux de la forêt
   vanilla 26.3. Ses blocs sont exclusivement vanilla. C'est un biome distinct
   pour ne pas hériter des tags de structures vanilla et de leurs apparitions
   possibles dans le vide.
@@ -54,9 +55,9 @@ de test et les sauvegardes personnelles doivent rester distincts.
   forêt initiale. Les minerais remplacent la roche existante et les arbres ont
   besoin de sol. Aucun mod de biomes externe n'est nécessaire.
 
-Ce premier prototype ne fournit pas encore d'eau : hydrologie, répartition
-complète des ressources de survie et variété de biomes constituent le prochain
-ticket de terrain. Les minerais vanilla conservent leurs plages d'altitude ;
+L’hydrologie v4 fournit les premières eaux de surface décrites ci-dessous. La
+répartition complète des ressources de survie et la variété de biomes restent
+à développer. Les minerais vanilla conservent leurs plages d’altitude ;
 leur abondance n'est donc pas encore équilibrée pour une île flottante.
 
 ## Sculpture du pourtour — conservée depuis la génération v2
@@ -134,6 +135,49 @@ ou régénéré. Il n'existe pas de migration automatique des anciens mondes ver
 dimension de 384 blocs. Changer manuellement leurs références de générateur ou
 de dimension sort de ce contrat de compatibilité.
 
+## Hydrologie de surface — génération v4
+
+La version **0.1.0-alpha.4** conserve la densité, la hauteur et le ciel de
+l’alpha.3. Les nouveaux mondes sélectionnent les paramètres
+`sanctuary:sanctuary_hydrology` et le biome `sanctuary:starter_forest_hydrology`.
+Le type de dimension reste `sanctuary:sanctuary_384`. Les anciens paramètres et
+le biome `sanctuary:starter_forest` restent disponibles et inchangés : ils
+n’activent pas cette hydrologie dans les sauvegardes antérieures.
+
+Un plan calculé depuis le relief et la graine recherche des emplacements de
+surface pour des étangs, des petits lacs et un premier cours d’eau calme.
+Le lit peut être légèrement creusé dans la roche existante. Avant d’accepter
+un emplacement, le plan vérifie le fond et les parois en trois dimensions ainsi
+que l’ouverture vers le ciel. Un trou profond dans la carte de hauteur ne suffit
+pas à constituer un lac. Aucune digue ni masse de roche n’est ajoutée pour
+boucher une fuite, et aucun bassin souterrain n’est rempli.
+
+Les fonds alternent sable, gravier et argile ; les berges basses peuvent recevoir
+du sable. Dans ce nouveau biome, les disques de sédiments vanilla et les veines
+de gravier sont remplacés par ces dépôts de rive et de fond : une feature
+ultérieure ne doit pas transformer leur support en gravier instable. Les
+sources de magma sous-marines sont également absentes. Après les arbres et la
+végétation, de la canne à sucre peut pousser sur
+les rives qui respectent ses règles de placement vanilla. Le nombre de sites,
+leur eau et leurs ressources dépendent du terrain : le générateur ne complète
+pas une graine pour atteindre un quota économique.
+
+Le plan est indépendant des chunks chargés. Chaque chunk applique uniquement
+ses propres colonnes après le terrain et avant la décoration, ce qui permet de
+raccorder un même plan d’eau aux frontières des chunks. Les anciens chunks ne
+sont jamais retouchés, et aucun travail hydrologique ne se déclenche au simple
+chargement d’une sauvegarde.
+
+Cette première version vise de petites eaux retenues et des cours d’eau calmes
+sur les plateaux. Le cours d’eau est un chenal à niveau constant reliant des
+plans d’eau ; il ne simule pas encore une pente vers l’aval ou un débit. Les
+tracés peuvent passer par les diagonales, mais leur eau reste connectée de
+bloc en bloc. L’excavation est limitée à six blocs, l’eau à quatre blocs de
+profondeur, avec un fond plein sur trois blocs d’épaisseur, dont deux blocs naturels sous
+le sédiment. Les grandes rivières en pente, cascades, océans, aquifères,
+climats multiples et continents restent des incréments distincts.
+**Créer un nouveau monde Sanctuary pour tester cette hydrologie.**
+
 ## Apparition commune
 
 Une injection limitée à la création initiale cherche du sol naturel depuis
@@ -142,7 +186,8 @@ une surface stable de 3 × 3 blocs, avec deux blocs libres en hauteur. En
 l'absence d'une telle surface, elle retient une colonne de sol praticable ; si
 aucun emplacement naturel sûr n'existe, la création signale la seed concernée
 plutôt que d'ajouter une plateforme. Elle ne s'applique qu'à l'Overworld
-utilisant les paramètres `sanctuary:sanctuary`.
+utilisant les paramètres `sanctuary:sanctuary`, `sanctuary:sanctuary_384` ou
+`sanctuary:sanctuary_hydrology`.
 Elle enregistre le spawn partagé dans la sauvegarde et ne le réinitialise pas
 au redémarrage : les modifications administratives de `/setworldspawn` restent
 conservées. Les lits et la dispersion habituelle du spawn suivent encore les