sanctuary-beta/docs/alpha13-worldgen.md

Alpha.13 — un monde Sanctuary unifié

Publiée et synchronisée dans la même instance Prism. Cette version réunit l’île de départ complète et les outils d’expansion du laboratoire. Validation décrit les preuves disponibles et Distribution indique la version effectivement publiée.

La cible reste Minecraft 26.3-pre-2 / Fabric. Ce guide concerne un nouveau monde alpha.13. Les anciens mondes conservent leur génération.

Créer son monde

1. Créer un nouveau monde, puis sélectionner le type Sanctuary.
2. Ouvrir le bouton natif Personnaliser.
3. Choisir la taille, puis cliquer sur Terminé avant de créer le monde.

Taille	Diamètre nominal de l’île initiale
Petit	512 blocs
Moyen, choix par défaut	724 blocs
Grand	1 024 blocs

Annuler revient sans appliquer le changement. La hauteur reste de 384 blocs, de Y=0 à Y=383. Le diamètre est une référence pour la forme : trous, surplombs, fragments et contour irrégulier dépendent de la graine. Il ne mesure pas une surface entièrement constructible et ne fixe pas un nombre de joueurs.

La liste des types de monde contient un seul choix Sanctuary ; les types Minecraft habituels restent disponibles. Petit, Moyen et Grand sont des réglages de ce même choix. L’ancien Grand alpha.11, de 724 blocs, correspond au diamètre nominal du nouveau Moyen.

Sur un serveur neuf, le preset suivant crée un monde de taille Moyen :

level-type=sanctuary:sanctuary
level-name=sanctuary-dev
level-seed=42

Choisir un dossier de monde neuf pour un essai. Le bouton Personnaliser configure la création en solo ; il ne modifie pas les fichiers d’un serveur existant. Installer le mod ou changer level-type ne transforme pas une partie.

L’île de départ

Le nouveau monde reprend le générateur complet de l’île initiale : forêts de chênes et de bouleaux, clairières, affleurements, strates rocheuses et corniches intérieures. Son relief flottant conserve les trous et les surplombs, sans ajouter de noyau cylindrique pour garantir un terrain à l’origine.

Les plans hydrologiques de Population sont repris : étangs et lacs, recherche de rivière, bassins étagés et leurs débordements, sources et cascades, poche et coulées de lave. Le placement dépend des supports réellement présents dans la roche. Un plan qui ne trouve pas de site admissible reste absent ; aucune rivière, terrasse ou ressource n’est garantie sur chaque graine. Les eaux en terrasses permettent la nage verticale sans ajouter de culture de riz.

Les poches souterraines natives du laboratoire rejoignent cette île : cavités luxuriantes, à spéléothèmes ou soufrées, avec leurs décorations Minecraft. Il s’agit toujours des profondeurs de l’Overworld, pas de la dimension des cavernes prévue dans la vision. L’île garde sa palette tempérée en surface ; Dappled Forest reste disponible dans les expansions au climat automnal.

L’intégration protège les volumes déclarés par les plans d’eau et de lave contre les écritures de décoration suivantes. Cette protection concerne les plans de génération, sans mettre les blocs à l’abri des actions des joueurs. Les preuves moteur et leurs limites sont suivies dans Validation.

Ajouter une île

Les commandes demandent les commandes autorisées en solo ou la permission opérateur sur le serveur. Elles reprennent les outils alpha.12.1 dans le nouveau monde Sanctuary. L’économie, les recherches et les contributions collectives ne conditionnent pas encore leur utilisation.

/sanctuary expansion quick north autumn 128 peaks
/sanctuary expansion list
/sanctuary expansion visit island_1
/sanctuary expansion create oasis island_1 east arid 64 natural 2048

quick ouvre une île depuis Sanctuary et lui attribue un identifiant island_N. L’exemple de visite suppose qu’il s’agit de la première réservation ; list indique l’identifiant et l’état réels. La visite attend que l’île soit prête. create choisit un nom et un parent déjà prêt pour prolonger une branche. La création ne téléporte personne implicitement.

Les nouveaux continents choisissent leur propre direction, climat, diamètre 64/128/256/512 et relief natural/peaks/canyon/volcano. La direction ne contraint pas le climat. L’autocomplétion fournit les huit directions et les douze profils : temperate, boreal, glacial, cold_humid, humid, tropical, warm, arid, dry, cold_dry, autumn, cherry.

Le dernier nombre facultatif est une distance minimale entre les centres du parent et de l’enfant, entre 0 et 100 000 blocs. Une valeur de 0 ou son omission laisse le placement automatique. Les marges et l’alignement sur les chunks peuvent éloigner le centre retenu.

Si le premier site est occupé, la recherche continue plus loin dans la même direction : au plus 32 positions et 30 secondes de lecture au total. Même du vide déjà généré compte comme occupé. Une erreur disque arrête la demande ; elle n’autorise pas à remplacer les chunks concernés.

/sanctuary expansion preview glacier sanctuary northeast glacial 256 canyon 2048
/sanctuary expansion resume island_1

preview calcule une proposition géométrique sans activer l’île et sans vérifier l’occupation ou les fondations. resume reprend une réservation interrompue, avec sa graine et ses paramètres conservés. Le système ne fournit aucune commande de régénération des régions déjà créées.

Les îles ajoutées gardent la génération d’expansion alpha.12 : leurs climats, reliefs, décorations et structures compatibles. Elles ne reçoivent pas systématiquement la grande rivière ou les terrasses de l’île initiale. Villages, temples, cabanes de marais et camps abandonnés dépendent du biome, du diamètre et des fondations ; aucune présence n’est garantie. Les règles de progression futures restent décrites dans Expansion.

Correctif alpha.13.1 — expansions sous Windows

L’erreur AccessDeniedException visant le dossier data/sanctuary-world-v13, depuis ExpansionJournal.persist, vient de la synchronisation du répertoire après l’écriture du journal. Java sous Windows ne permet pas cette ouverture avec FileChannel ; ce message ne signifie pas à lui seul que le joueur manque de droits sur sa sauvegarde.

1. Fermer Minecraft pour arrêter la session dont les expansions sont bloquées.
2. Mettre l’instance Prism existante à jour vers 0.1.0-alpha.13.1 via son canal packwiz, puis relancer le jeu.
3. Rouvrir le même monde et consulter /sanctuary expansion list.

Si l’instance Windows a été importée depuis le MRpack sans auto-update, fermer Minecraft puis remplacer seulement sanctuary-0.1.0-alpha.13.jar par le JAR sanctuary-0.1.0-alpha.13.1.jar de la release dans son dossier mods. Conserver un seul JAR Sanctuary actif ; les autres mods et les sauvegardes restent dans la même instance. Le raccordement au canal stable est décrit dans Distribution.

Le remplacement du journal ayant précédé cette erreur, l’expansion demandée peut déjà être enregistrée comme reserved. Au chargement, les réservations valides reprennent automatiquement avec leur identifiant, leur graine et leur position. Il n’est pas nécessaire de recréer le monde ou de supprimer le dossier du journal. La commande resume seule ne débloque pas une session dont le journal a été déclaré indisponible : sa relecture exige de rouvrir le monde.

Le correctif conserve le format et le contenu du journal existant ; il ne migre ni ne régénère les chunks. La validation ciblée distingue les contrôles locaux de l’essai Windows natif restant à effectuer.

Paramètres et sauvegardes

Le preset public sanctuary:sanctuary utilise le nouveau codec de générateur sanctuary:island_v13. Sa source de biomes est également enregistrée sous sanctuary:island_v13. Le générateur sérialise initial_diameter, limité à 512, 724 ou 1 024 ; une valeur absente prend 724. Ce champ appartient à la sauvegarde créée, et ne suit pas les changements ultérieurs de défaut du pack.

Pour l’île initiale, les réglages internes sanctuary:unified_5, sanctuary:unified_10 et sanctuary:unified_20 correspondent respectivement aux diamètres 512, 724 et 1 024. Les suffixes sont des références de calcul, pas des capacités affichées. Ils reprennent la densité Population et son hydrologie avec le générateur et le RandomState propres à l’origine.

La source combine la palette Population de départ et le sélecteur de cavités natives du laboratoire, avec les mêmes conditions de sélection de ces poches. Les îles enfants conservent le sélecteur climatique du laboratoire. Les 34 biomes natifs de cette palette et les dix biomes Population sont déclarés avant la première expansion ; TerraMix n’est pas une dépendance téléchargée.

Le nouveau journal est enregistré dans le dossier du monde :

data/sanctuary-world-v13/expansions.json

Son schéma reste 1, avec une racine de génération 13 et des extensions de génération 12. Les identifiants, parents, graines, paramètres, positions et états d’ouverture sont conservés côté serveur. La racine et le diamètre initial ne sont pas modifiables par une commande d’expansion.

Les mondes du laboratoire alpha.12/12.1 gardent leur codec et leur journal data/sanctuary-expansion-v1/expansions.json. Les générations Population et les autres générations antérieures gardent leurs paramètres enregistrés. Les presets historiques sont conservés mais cachés dans la création publique. Aucun monde n’est converti, agrandi, réduit ou régénéré par l’alpha.13. Le guide alpha.12 est une référence historique, pas une instruction de sélectionner à nouveau le laboratoire pour cette version.

Contrôles de développement

./gradlew check build assemblePack et :sanctuary:runGameTest sélectionnent par défaut la suite unifiée. Son diamètre de test se choisit avec -PsanctuaryTestDiameter=512, 724 ou 1024 ; il ne change pas le défaut public.

Les suites Population historiques demandent -PsanctuaryUnifiedTests=false, avec leur profil -PsanctuaryTestPlayers=5, 10, 20 ou 100. Les essais du laboratoire historique utilisent aussi ce drapeau, avec -PsanctuaryExpansionTests=true. Ces processus travaillent dans les dossiers de développement ignorés, jamais dans les sauvegardes personnelles.

Les validations et mesures des alpha.11, .12 et .12.1 restent historiques. Elles ne prouvent ni les temps de chargement ni le rendu de cette intégration. Les trois tailles, l’interface native et les expansions/rechargements passent les contrôles alpha.13. Moyen atteint 63,66 s pour créer le monde puis charger 289 chunks FULL sur la graine 0 ; voir Validation pour le protocole et ses limites. La release, le MRpack et le canal packwiz sont publiés ; deux synchronisations dans la même instance Prism conservent les 601 fichiers personnels et réglages suivis. Voir Distribution.