feat(worldgen): add persistent aerial Sanctuary sites for alpha.24

docs/generation-alpha24.md

@@ -0,0 +1,90 @@
+# Alpha.24 — les lieux suspendus de Sanctuary
+
+## Contrat
+
+Le nouveau codec `sanctuary:island_v24` ajoute cinq lieux au monde initial :
+une montgolfière, deux bateaux de fret et deux îlots minéraux. Ils sont planifiés
+à la création et construits seulement lorsque leurs chunks sont générés.
+La génération de terrain reste celle de l’alpha.23.1 : mêmes trois tailles
+512 / 724 / 1 024, Moyen par défaut, bouton Minecraft **Personnaliser**,
+secrets minéraux, voies abandonnées, structures vanilla, océans d’expansion,
+registre et admission d’au moins une structure adaptée par expansion acceptée.
+
+Les cinq sites cherchent la périphérie, hors de l’emprise du terrain initial.
+Chaque site possède un point de rivage vérifié, à moins de 512 blocs, et un
+segment de vue dégagé dans le relief et hors des volumes des secrets déjà
+planifiés. Les distances de rendu du client et du
+serveur déterminent sa visibilité en jeu ; les arbres ultérieurs peuvent
+masquer une partie de cette vue. Le relief n’est pas prolongé vers les sites.
+Aucun pont, quai, pilier jusqu’au sol ou accès automatique n’est fourni.
+
+## Formes et ressources
+
+La montgolfière possède une enveloppe arrondie de laine claire, un accent,
+une nacelle en chêne et des suspentes attachées. Elle reste sous Y350.
+Les deux navires ont une coque biseautée, des voiles, un pont protégé,
+une cabine et une cale. Le navire de vivres accueille un fermier adulte ;
+celui de matériel, un outilleur adulte. Leurs postes de travail sont vanilla.
+Il faut construire pour atteindre les lieux et ramener les villageois.
+
+Les îlots ont une roche irrégulière, une base effilée et des filons connectés.
+Leur surface reçoit une couverture de terre et d’herbe majoritaire, des fleurs,
+des herbes et quelques petits chênes ou bouleaux. Le volume réservé comprend
+les couronnes ; l’épaisseur rocheuse reste de 20 à 35 blocs.
+Leur profondeur relative détermine les minerais : charbon, fer et cuivre
+abondants ; poches d’or, lapis, redstone, diamant et émeraude. Ces réserves
+sont finies. Le recensement existant compte les blocs dans les chunks
+observés, sans charger toute la région ni lire le butin encore fermé.
+Exactement un îlot possède une source d’eau qui s’écoule suivant les règles
+Minecraft et peut tomber dans le vide.
+
+Chaque lieu contient exactement un coffre dédié. Ceux des îlots sont enterrés
+sous une couverture stable, à l’écart de la cascade. Les tables de butin
+utilisent exclusivement des objets vanilla, sans récompense future ni Anomaly.
+Ni le butin, ni les habitants, ni les blocs détruits ne se renouvellent au
+rechargement d’un chunk déjà généré.
+
+## Persistance et expansions
+
+La recherche est déterministe, limitée à 64 candidats par site et 8 192
+colonnes de terrain mises en cache pour l’ensemble du plan. Les plans des
+secrets racine sont calculés auparavant, puis réutilisés au démarrage ; une
+voûte ou une galerie ne peut ainsi recouvrir le point côtier certifié. Cette
+planification ne demande aucun chunk. Un échec interrompt explicitement la création du plan plutôt que
+de livrer un monde avec un satellite silencieusement manquant.
+
+Le manifeste immuable est écrit dans `data/sanctuary-aerial-v24/` avant le
+premier journal `data/sanctuary-world-v24/`. Son SHA-256 est lié au journal24.
+Un rechargement relit le plan stocké ; il ne le recalcule pas. Un manifeste
+manquant, altéré ou incompatible bloque la reprise avant toute expansion.
+Ce contrat ne s’applique qu’aux nouveaux mondes24 ; les anciens journaux,
+codecs, profils et terrains restent lisibles sans migration.
+
+Les réservations couvrent exactement les chunks des cinq structures et un
+petit masque local autour de la sortie d’eau, sans marge sur tout le pourtour
+des sites. Elles ne deviennent pas des propriétaires de terrain :
+les biomes du vide et le bruit de génération restent inchangés. L’admission
+d’expansion, le journal et la reprise de vide vérifient ces emprises même si
+aucun joueur n’a encore exploré le site. Les passages entre elles restent libres.
+
+Les départs et pièces sont natifs, enregistrés sous `aerial_balloon`,
+`aerial_merchant_ship` et `aerial_mineral_islet`. Les écritures sont limitées
+au site et au chunk courant. Le registre distingue les sites planifiés,
+les départs acceptés et la génération observée. Les scopes aériens ne servent
+pas à conclure qu’une famille de structures vanilla manque au serveur.
+`/locate structure` et `/sanctuary census structures aerial [site]` les
+référencent sans ouvrir d’expansion ni transformer une consultation en visite.
+
+Les options **Structures expérimentales** et **Générer les structures**
+contrôlent les satellites. Leur désactivation produit un plan vide, sans
+réservations aériennes. Les options sont sauvegardées avec le monde.
+
+## Limites de cette livraison
+
+Minecraft reste en 26.3-pre-2. Les nuages et la hauteur du monde sont inchangés.
+Aucun véhicule pilotable, bateau-poule, temple, commerce Sanctuary, boss,
+portail des Cavernes ou raid n’est ajouté. Deep Dark et cités anciennes
+restent réservés aux futures Cavernes.
+
+Les vérifications réellement exécutées, les témoins et l’état de distribution
+figurent dans [testing-alpha24.md](testing-alpha24.md).