213 lines
11 KiB
Markdown
213 lines
11 KiB
Markdown
# 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](testing.md) décrit les preuves disponibles et
|
||
[Distribution](packwiz.md) 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 :
|
||
|
||
```properties
|
||
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](testing.md).
|
||
|
||
## 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.
|
||
|
||
```text
|
||
/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.
|
||
|
||
```text
|
||
/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](expansion.md).
|
||
|
||
## 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](packwiz.md#raccorder-linstance-prism-existante).
|
||
|
||
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](testing.md#correctif-alpha131--journal-dexpansion-sous-windows)
|
||
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 :
|
||
|
||
```text
|
||
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](alpha12-laboratory.md) 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](testing.md) 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](packwiz.md).
|