feat: natural Sanctuary secrets and guaranteed expansions for alpha23.1

docs/generation-alpha23.1.md

@@ -0,0 +1,105 @@
+# Alpha.23.1 — île naturelle, secrets et continents
+
+Contrat du ticket **WG-27**, branche `codex/natural-secrets-alpha23`.
+Cette livraison réunit le Blocodex alpha.23 et la génération `sanctuary:island_v23`.
+Les résultats des essais sont consignés dans [le rapport](testing-alpha23.1.md).
+
+## Sanctuary Island
+
+Le point de départ reste naturel. Les quartiers Lost City et les infrastructures
+ordinaires Sanctuary ne sont plus demandés sur l’île initiale. Leur code et les
+anciennes générations sont conservés ; les expansions Lost City restent possibles.
+Les structures vanilla ne sont pas supprimées : leur admission dépend du biome,
+du relief, des appuis et des volumes déjà occupés.
+
+La sélection des lieux Sanctuary conserve l’observatoire, un atelier caché,
+la grande traversée et la salle d’expansion indépendante. La piscine attenante
+est retirée ; les égouts et leurs ouvertures restent possibles. Les anciennes voies
+ferrées peuvent exister sans gare ni bâtiment au bout : leur remise en service
+reste une construction des joueurs.
+
+Le **sanctuaire minéral** est une grande cavité géologique explorable, dominante
+pierre et cobblestone, avec voûtes, piliers, corniches et filons minables. Il peut
+affleurer sur les flancs ou sous l’île avec des attaches rocheuses. L’enveloppe
+maximale est 79 × 73 × 27 ; ce volume ne désigne pas une façade rectangulaire.
+Il ne comporte ni briques, mobilier, machines, ni éclairage manufacturé.
+Le mot laboratoire reste réservé à la future structure des Mooblooms.
+
+Le gardien et le portail des Cavernes ne sont pas activés ici. L’intention de
+progression demeure : vaincre le gardien stabilisera l’accès aux Cavernes pour
+tout le serveur, puis chacun pourra construire son portail. Le Deep Dark et les
+cités anciennes appartiendront à ces Cavernes. Le lieu des raids appartient aux
+expansions et n’est pas construit dans cette livraison.
+
+## Structures natives et garantie d’expansion
+
+Le catalogue s’appuie sur les 52 identifiants de structures présents dans le JAR
+Minecraft 26.3-pre-2 : 47 de l’Overworld, dont la cité ancienne réservée aux Cavernes,
+et cinq propres au Nether ou à l’End. Les petits donjons `monster_room` sont des
+features et font l’objet d’un suivi séparé. Les modèles, identifiants, coffres,
+spawners et comportements natifs sont conservés.
+
+Les placements distinguent surface, sous-sol et milieu aquatique. Les hauteurs
+souterraines vanilla ne sont pas recopiées sous Y=0 : elles sont adaptées à la
+roche de l’île. Les monuments conservent aussi leur hauteur lors du rechargement.
+L’adaptation ne remplace pas les définitions `minecraft:*` du registre.
+Les ruines océaniques et les trésors enterrés conservent leur ajustement fin
+vanilla au fond réel pendant la pose des blocs : leur hauteur peut encore se
+préciser après l’acceptation du départ.
+
+**Correction approuvée après le plan initial : chaque nouvelle expansion 23 avec
+les structures activées doit disposer d’au moins une structure adaptée avant sa
+réservation.** Les familles absentes restent préférées, sans rendre obligatoire
+une famille incompatible. Une recherche infructueuse ne publie pas une île vide
+de structures et ne contourne pas les exigences d’appui. Aucune structure n’est
+ajoutée rétroactivement aux îles déjà enregistrées.
+
+Les yeux de l’Ender, cartes d’exploration et `/locate` recherchent les vrais
+départs dans les îles ouvertes. Une recherche n’active jamais d’expansion.
+Le compteur natif de références cartographiques n’indique pas une visite réelle.
+
+## Océans
+
+Le relief `ocean` est réservé aux expansions 23 de 512 ou 1024 blocs. Les grandes
+expansions rapides sans relief explicite peuvent le choisir dans un tirage
+déterministe d’environ un tiers. Le climat et la taille restent ceux du descripteur.
+
+Le champ océanique commun au terrain, à l’eau et aux biomes produit une mer
+intérieure irrégulière, des hauts-fonds, des côtes et une zone profonde, en
+conservant une majorité de terres. Cible : 30–45 % de surface aquatique nominale,
+profondeurs maximales 32–56 blocs. Une coque rocheuse continue retient l’eau ;
+le reste du vide conserve l’air. Le niveau d’eau est local à l’expansion.
+Ce niveau accompagne aussi les décorations natives, notamment les icebergs ;
+il est rétabli après chaque passe pour ne pas affecter les autres îles.
+
+Les températures utilisent les biomes natifs océan, océan froid, gelé, tiède et
+chaud, avec les variantes profondes disponibles. Il n’existe pas de
+`deep_warm_ocean` natif. Les monuments exigent un océan profond réellement adapté.
+Aucun océan ni Deep Dark n’est ajouté à Sanctuary Island.
+
+## Mémoire serveur et sauvegardes
+
+Le registre des structures est persistant et distinct du census des seuls chunks
+chargés. Il distingue départ accepté, bâtiment partiellement ou complètement
+généré, région encore inconnue et absence confirmée dans une région vérifiée.
+Une démolition ne supprime pas le fait historique de génération. Une erreur de
+lecture ne transforme pas le registre en liste vide.
+
+`/sanctuary census structures` expose les relevés aux opérateurs ; l’option
+`island <id>` précise la région et `dimension <id>` distingue les dimensions natives.
+L’île propriétaire se déduit des descripteurs immuables du journal d’expansion.
+Le suivi automatique ne charge pas la carte et
+ne révèle pas les secrets dans le Blocodex personnel.
+
+Le champ optionnel plat `structure_priorities` d’une nouvelle expansion 23
+contient les familles bonifiées. Il est capturé une fois avant l’inspection,
+figé dans le journal et lié au certificat de réutilisation du vide. Bonus initial
+de sélection : × 4. Une reprise réutilise ce profil même si le registre a évolué.
+Les générations historiques restent neutres, sans champ ajouté à leurs écritures.
+
+Les mondes existants gardent leur codec et leur terrain. Les nouvelles règles
+nécessitent un nouveau monde ; aucune conversion ou régénération n’est effectuée.
+Petit 512, Moyen 724 par défaut et Grand 1024 restent dans Personnaliser. L’option
+expérimentale commande les secrets optionnels et les rails ; le hall et la
+traversée restent dans le socle. Les structures vanilla en sont indépendantes.
+La désactivation générale des structures reste prioritaire.