sanctuary-beta/docs/packwiz.md

# Distribution packwiz et Prism

Sanctuary Beta utilise une seule instance Prism, synchronisée avant chaque
lancement par packwiz. Le canal reste à l'adresse :

```text
https://git.botsu.net/koka/sanctuary-beta/raw/branch/packwiz/pack.toml
```

Les sources sont sur la branche de travail du ticket. La branche `packwiz`
contient uniquement les manifestes de distribution produits par le build ; les
JAR Sanctuary sont des pièces jointes de releases Gitea. Aucun JAR de mod ou
dépendance téléchargée n'entre dans l'historique Git. Le canal Beta est distinct
de l'ancien pack 26.2.

## Alpha.24 publiée — 11 septembre 2026

`check build assemblePack` et les essais natifs passent. Le JAR et
`build/Sanctuary-0.1.0-alpha.24.mrpack` sont vérifiés : versions, index,
empreintes et JAR intégré concordent. Minecraft 26.3-pre-2, Fabric Loader
0.19.5 et Fabric API 0.160.0+26.3 sont conservés. Voir
[les vérifications](testing-alpha24.md) et [la génération](generation-alpha24.md).

SHA-256 du JAR :

```text
f045655cef30bbaa93099a24443462f213d7851fecd03b7b00c6ca874c9d9c45
```

La [release alpha.24](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.24)
est publiée depuis le commit source `27d7cba`. Le canal packwiz est au commit
`bd9b4c4`. Le JAR, le
[MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.24/Sanctuary-0.1.0-alpha.24.mrpack)
et le ZIP d’amorçage ont été vérifiés par téléchargement public.

Deux installations isolées, puis deux synchronisations dans la même instance
Sanctuary Beta réussissent. Un seul JAR Sanctuary alpha.24 est actif ; les
**925 fichiers personnels et réglages suivis** conservent leurs empreintes.
Le dossier reste `Sanctuary-0.1.0-alpha.1`. Sauvegarde ciblée :
`sanctuary-backups/before-0.1.0-alpha.24/`, hors de `mods/`.
Reçus locaux : `build/alpha24-artifacts.json`,
`build/alpha24-isolated-validation.json`, `build/alpha24-prism-validation.json`.
Le jeu est fermé pendant la mise à jour ; aucun monde personnel n’est ouvert,
converti ou régénéré. Le lanceur est resté ouvert et ses réglages sont inchangés.

Pour essayer : créer un **nouveau monde Sanctuary**, avec les structures et
l’option expérimentale activées. Les cinq lieux sont référencés dans le
[guide des témoins](testing-alpha24.md). Le ZIP d’amorçage suit le canal stable ;
il ne sert pas à réimporter l’instance existante. Aucun essai Windows natif
n’est revendiqué.

## Alpha.23.1 locale vérifiée — 11 septembre 2026

Le JAR et `build/Sanctuary-0.1.0-alpha.23.1.mrpack` sont construits et vérifiés
après `check build` et `assemblePack`. Les versions Minecraft 26.3-pre-2,
Fabric Loader 0.19.5 et Fabric API 0.160.0+26.3 sont conservées.
Voir [les validations](testing-alpha23.1.md) et
[le contrat de génération](generation-alpha23.1.md).

SHA-256 du JAR :

```text
906fd2e12be4233676a1a561556508eee7412183698c2cac704dc1191324f136
```

**Publication en attente :** le gestionnaire d’identifiants Git ne fournit pas
l’authentification nécessaire. Le canal public reste à l’alpha.22 ; aucune
synchronisation de l’instance Prism n’a été effectuée pour l’alpha.23.1.
Le MRpack local peut être conservé pour les essais. Le ZIP d’amorçage préparé
suit encore le canal public alpha.22 et ne doit pas être présenté comme une
installation publiée de l’alpha.23.1. Les étapes de publication puis de
synchronisation ci-dessous restent à exécuter après rétablissement de l’accès.

## Alpha.22 publiée — 10 septembre 2026

[Sanctuary 0.1.0-alpha.22](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.22)
est publiée depuis le commit source `d6e0c14`. Le canal stable est au commit
`0019178`. Le JAR, le
[MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.22/Sanctuary-0.1.0-alpha.22.mrpack)
et le ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
10d7ef32ac2e81a977ea4854503bafa29e0bc10929984b76df01d6f5f61f9056
```

Les bâtiments de surface recherchent des terrains adaptés ; la grande traversée
et la salle d’expansion restent des éléments de base, indépendants d’une ville.
Les galeries peuvent chercher un détour et de nouveaux accès. Le hall peut
accueillir des égouts ailleurs dans l’île. Les trois tailles natives, le cas OFF,
la réouverture et la comparaison21 passent. `check build assemblePack` passe
avec75 tâches et les huit GameTests généraux. Voir [les essais22](testing-alpha22.md).

Deux synchronisations isolées puis deux dans la même instance Prism réussissent.
Un seul JAR Sanctuary alpha.22 est actif ; les **925 fichiers personnels et
réglages suivis** gardent leurs hashes. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ». Le JAR21 et le suivi
packwiz sont sauvegardés sous `sanctuary-backups/before-0.1.0-alpha.22/`.
Reçus locaux : `build/alpha22-isolated-validation.json` et
`build/alpha22-prism-validation.json`.

Pour tester : **nouveau monde Sanctuary, Moyen, graine0**. Les portiques de la
traversée sont `-170 253 -98` et `170 254 -98` ; la trappe du hall indépendant
est `2 252 0`. `/sanctuary structures` liste les lieux. Les villes et bâtiments
facultatifs peuvent être refusés. Les graines vérifiées ne prouvent pas la
présence des infrastructures sur toutes les graines ; les recherches restent
bornées. Aucun monde personnel n’a été ouvert, converti ou régénéré. Aucun
essai client visuel ni essai Windows natif n’est revendiqué.

## Alpha.21 publiée — 10 septembre 2026

[Sanctuary 0.1.0-alpha.21](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.21)
est publiée depuis le commit source `bb63fab`. Le canal stable utilisait cette version au commit
`8002fce`. Le JAR, le
[MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.21/Sanctuary-0.1.0-alpha.21.mrpack)
et le ZIP d’amorçage Prism ont été vérifiés. SHA-256 du JAR :

```text
e528e42d99f9e1ea221f780ea089b49b42a1a4e9e24e4ddd001d045183202c21
```

Palettes sobres, toitures portées, quartiers reliés, placements patrimoniaux
assouplis et premières galeries industrielles avec fronts rocheux et filons.
Voir le [catalogue](architecture-alpha21.md) et les [essais](testing-alpha21.md).
`check build assemblePack`, les huit GameTests généraux, les créations et
réouvertures natives passent. Le cas expérimental OFF passe. Les fichiers
historiques et les témoins natifs de la génération20 sont conservés.

Deux synchronisations isolées puis deux dans la même instance Prism réussissent.
Un seul JAR Sanctuary alpha.21 est actif ; les **925 fichiers personnels et
réglages suivis** gardent leurs hashes. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ». Le JAR20 et le suivi
packwiz sont sauvegardés sous `sanctuary-backups/before-0.1.0-alpha.21/`.
Reçus locaux : `build/alpha21-isolated-validation.json` et
`build/alpha21-prism-validation.json`.

Pour tester : **nouveau monde Sanctuary, Moyen, graine0**, **Structures
expérimentales** activées dans **Personnaliser**. Entrées des galeries :
`-135 253 -178` et `-135 249 162`. `/sanctuary structures` liste les lieux.
Les raccords dépendent du relief ; certains sites restent isolés et les réseaux
souterrains ne sont pas tous reliés. Aucun monde personnel n’a été ouvert,
converti ou régénéré. Aucun essai Windows natif ni essai visuel client n’est
revendiqué. Une sauvegarde21 nécessite le binaire21 ou un futur binaire compatible.

## Alpha.20 publiée — 10 septembre 2026

[Sanctuary 0.1.0-alpha.20](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.20)
est publiée depuis le commit source `0edac29`. Le canal stable utilisait cette
version au commit `4e0967d`. Le JAR, le
[MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.20/Sanctuary-0.1.0-alpha.20.mrpack)
et le ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
9ea10576e641d83c13e1277960a375448a22d416a98a6b327c4d6d2a204c423a
```

Passe de détails sur six bâtiments de ville, quatorze infrastructures,
espaces publics et réseaux souterrains : palettes propres aux usages,
boiseries, tuf ciselé, corniches, biseaux, verrières et raccords des vitres.
Voir le [catalogue illustré](architecture-alpha20.md).

`check build assemblePack` passe, avec huit GameTests généraux. Les créations
et réouvertures natives conservent les structures, accès, supports et coffres.
Le bassin et les sorties d’égout restent fonctionnels. Les rapports de la
version19 restent identiques à ceux de la release publiée. Le mode désactivé
et une petite île passent ; les quatorze infrastructures sont rencontrées sur
les deux témoins. Les limites des raccords au terrain sont détaillées dans
[les preuves alpha.20](testing-alpha20.md).

Deux synchronisations isolées puis deux dans la même instance Prism Mac
réussissent. Un seul JAR Sanctuary alpha.20 est actif ; les **925 fichiers
personnels et réglages suivis** conservent leurs hashes. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ». Le JAR19 et le suivi
packwiz sont sauvegardés dans `sanctuary-backups/before-0.1.0-alpha.20/`.
Reçus locaux : `build/alpha20-isolated-validation.json` et
`build/alpha20-prism-validation.json`.

Pour voir cette architecture, créer un **nouveau monde Sanctuary, Moyen,
graine 0**, avec **Structures expérimentales** activées dans **Personnaliser**.
`/sanctuary structures` liste les entrées. Petit, graine42, possède la
cartothèque à `-101 251 -25`. L’option désactivée d’un autre nouveau monde
conserve la ville sans les réseaux expérimentaux. Les anciens mondes gardent
leur génération ; aucune sauvegarde personnelle n’a été ouverte, convertie ou
régénérée. Une sauvegarde20 ne se rétrograde pas vers le binaire19.

Les vues du catalogue viennent des modèles et ne sont pas des captures de
partie. Aucun essai client visuel ni essai Windows natif n’a été effectué.
Les nouvelles fonctions de la bêta restent à construire.

## Alpha.19 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.19](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.19)
est publiée depuis le commit source `c23e72b`. Le canal stable utilisait alors
cette version, au commit `ea883b7`. JAR, [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.19/Sanctuary-0.1.0-alpha.19.mrpack)
et ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
a159b00a2778020800e81381e0608495a4d7909f1f853f0b8812cd4017865b0b
```

Première passe de quatorze architectures et de leurs voies de fret ou chemins
abandonnés sur l’île initiale. Les trois tailles sont vérifiées nativement ;
les quatorze types ont chacun été rencontrés et parcourus sur ces témoins.
Créer un **nouveau monde Sanctuary, Moyen, graine 0**, puis garder
**Structures expérimentales** activées dans **Personnaliser** : ce témoin
contient treize lieux et sept liaisons, dont un fret de 499 blocs.
`/sanctuary structures` relève les entrées. La présence des bâtiments et les
raccords dépendent du relief ; voir [les preuves et la carte](testing-alpha19.md).

`check build assemblePack` et les huit GameTests généraux passent.
Création et réouverture natives conservent 112 pièces et 13 coffres ; 68 cibles
sont accessibles. Le mode désactivé passe. Les empreintes de la génération 17
restent identiques aux preuves publiées, y compris après réouverture.

Deux synchronisations isolées puis deux dans la même instance Prism Mac
réussissent. Un seul JAR Sanctuary alpha.19 est actif ; les **767 fichiers
personnels et réglages suivis** conservent leurs hashes. Aucune sauvegarde
personnelle n’a été ouverte, convertie ou régénérée. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ».

Le JAR 17 et le suivi packwiz sont sauvegardés dans
`sanctuary-backups/before-0.1.0-alpha.19/`. Reçus locaux ignorés :
`build/alpha19-isolated-validation.json` et `build/alpha19-prism-validation.json`.

Pour comparer, créer un autre nouveau monde avec l’option désactivée : le socle
urbain demeure, sans les expériences 17/19. Cette option ne supprime pas de
structures dans une sauvegarde existante. Les anciens mondes conservent leur
génération ; une sauvegarde 19 ne doit pas être ouverte avec l’ancien binaire 17.
Les bâtiments préparent les futurs usages, mais mailbox, caméra, réacteur et
progression restent pour la bêta. Aucun essai visuel dans le client ni essai
Windows natif n’a été effectué.

## Alpha.17 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.17](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.17)
est publiée depuis le commit source `0969ed5`. Le canal stable utilisait alors cette
version, au commit `6e0c297`. JAR, [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.17/Sanctuary-0.1.0-alpha.17.mrpack)
et ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
9ab7a9f03a46bc940d6bc014de85c6935eb5ba21f11ceea9b1222a9dae1faaec
```

L’option **Structures expérimentales** de **Personnaliser** ajoute trois familles
de petits réseaux sur les nouvelles îles initiales : mines et ateliers, salles
étranges, installations abandonnées. Le choix est enregistré avec la taille.
Le témoin **Moyen, graine 0**, option activée, possède trois réseaux accessibles
depuis la surface. Voir [les preuves et coordonnées](testing-alpha17.md).

`check build assemblePack`, les huit GameTests et les trois smokes dédiés passent.
Création et réouverture natives conservent 15 pièces, 3 coffres, 12 appuis et le
bloc témoin ; 49 cibles sont accessibles. Le cas désactivé passe. La génération 16
conserve les empreintes de ses structures et de son journal publiés.

Deux synchronisations isolées puis deux dans la même instance Prism Mac
réussissent. Un seul JAR Sanctuary alpha.17 est actif ; les **767 fichiers
personnels et réglages suivis** conservent leurs hashes. Aucune sauvegarde
personnelle n’a été ouverte, convertie ou régénérée. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ».

Le JAR 16 et le suivi packwiz sont sauvegardés dans
`sanctuary-backups/before-0.1.0-alpha.17/`. Reçus locaux ignorés :
`build/alpha17-isolated-validation.json` et `build/alpha17-prism-validation.json`.

Créer un **nouveau monde Sanctuary** pour cet essai. L’option désactivée permet
un autre nouveau monde sans les réseaux supplémentaires ; elle ne retire pas
de blocs d’un monde existant. Les anciennes sauvegardes gardent leur génération.
Ne pas ouvrir une sauvegarde 17 avec le binaire 16. Les connexions entre réseaux,
le réacteur, les reliques et la progression restent à construire. Aucun essai
Windows natif ni revue visuelle dans le client n’a été effectué.

## Alpha.16 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.16](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.16)
est publiée depuis le commit source `98fc13c`. Le canal stable utilisait alors cette
version, au commit `927c862`. JAR, [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.16/Sanctuary-0.1.0-alpha.16.mrpack)
et ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
5504018c46300accf01478dbc8bfb8e216395a5435cf7d7f501005cbc65b8e43
```

`check build assemblePack`, les huit GameTests et les scénarios natifs de
création/réouverture passent. Six reliefs contrôlés possèdent une ville ; les
grands équipements souterrains restent conditionnés par les emplacements
admissibles trouvés dans le budget de génération. Le témoin Moyen, graine 0,
contient la piscine de 50 × 25, huit niveaux de parking, la grande salle sèche
et un égout ouvert avec écoulement vérifié. Voir [les preuves et coordonnées](testing-alpha16.md).

Deux synchronisations isolées puis deux dans la même instance Prism Mac
réussissent. Un seul JAR Sanctuary alpha.16 est actif ; les **767 fichiers
personnels et réglages suivis** conservent leurs hashes. Aucune sauvegarde
personnelle n’a été ouverte, convertie ou régénérée. Le dossier reste
`Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ».

Le JAR15 et le suivi packwiz sont sauvegardés dans
`sanctuary-backups/before-0.1.0-alpha.16/`. Les reçus locaux ignorés sont
`build/alpha16-isolated-validation.json` et `build/alpha16-prism-validation.json` ;
les empreintes avant/après figurent aussi dans la sauvegarde ciblée de l’instance.

Créer un **nouveau monde Sanctuary** pour les nouveautés16. Les mondes publiés
jusqu’à15 gardent leur génération, y compris leurs futurs chunks. La machine
d’expansion, le réacteur et les nouvelles familles de donjons restent prévus.
Aucun accès à l’instance Windows n’a eu lieu pour cette livraison.

## Alpha.15 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.15](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.15)
est publiée depuis le commit source `dd9c795`. Le canal stable utilisait alors cette
version, au commit `6cf54ee`. JAR, [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.15/Sanctuary-0.1.0-alpha.15.mrpack)
et ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
52253f386d30530cc718d4b90ac6953cd4790b2125c78b74599eebff944824f2
```

`check build assemblePack`, les huit GameTests et les scénarios natifs de
création/réouverture passent. Deux synchronisations isolées puis deux dans la
même instance Prism Mac réussissent. Un seul JAR Sanctuary alpha.15 est actif ;
les **767 fichiers personnels et réglages suivis** conservent leurs hashes.
Aucune sauvegarde personnelle n’a été ouverte, convertie ou régénérée.
Le dossier reste `Sanctuary-0.1.0-alpha.1`, affiché « Sanctuary Beta ».

Le JAR d’essai15 ajouté manuellement avant publication est conservé dans
`sanctuary-backups/alpha15-manual-preview/`, hors de `mods/`. Le JAR14 et le
suivi packwiz sont sauvegardés dans `sanctuary-backups/before-0.1.0-alpha.15/`.
Les reçus locaux ignorés sont `build/alpha15-isolated-validation.json` et
`build/alpha15-prism-validation.json` ; les empreintes avant/après figurent
aussi dans la sauvegarde ciblée de l’instance.

Créer un **nouveau monde Sanctuary** pour la ville compacte et ses sous-sols,
y compris après l’essai anticipé15. Les mondes publiés12/13/14 gardent leurs
générateurs. La salle d’expansion est présente lorsque le terrain le permet ;
sa future machine et les cartes préremplies ne sont pas implémentées.
Voir [les preuves, coordonnées et limites](testing-alpha15.md).
Aucun accès à l’instance Windows n’a eu lieu pour cette livraison.

## Alpha.14 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.14](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.14)
est publiée depuis le commit source `1c5c2c2`. Le canal stable utilisait alors cette
version, au commit `dabf57e`. Le JAR, le
[MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.14/Sanctuary-0.1.0-alpha.14.mrpack)
et le ZIP d’amorçage Prism ont été vérifiés par téléchargement public.
SHA-256 du JAR :

```text
1c517a13e1151501c6f4974d1bc00faedf67aaecd9bf58f34ac4a655d09dc6ef
```

`check build assemblePack` et les huit GameTests passent, ainsi que les
scénarios natifs Lost City et reprise du vide après réouverture. Deux
synchronisations isolées puis deux dans la même instance Prism Mac ont réussi.
Le second passage conserve les fichiers gérés à l’identique ; un seul JAR
Sanctuary alpha.14 est actif. Les **713 fichiers personnels et réglages suivis**
conservent leurs hashes. Aucune sauvegarde personnelle n’a été ouverte,
convertie ou régénérée. Le dossier reste `Sanctuary-0.1.0-alpha.1`.

Sauvegarde ciblée dans cette instance :
`sanctuary-backups/before-0.1.0-alpha.14/`. Reçus locaux ignorés :
`build/alpha14-isolated-validation.json` et `build/alpha14-prism-validation.json`.
Voir le [contrat de génération et les preuves](testing-alpha14.md).
La machine Windows n’a pas été accessible pour un essai natif ou une installation.

La livraison conserve la même instance et ses sauvegardes. Pour les nouveautés
Lost City, créer ensuite un **nouveau monde Sanctuary** de génération 14 ;
mettre à jour le pack ne convertit pas les mondes 12/13. Dans ce nouveau monde
uniquement, une expansion réservée sur du vide certifié peut demander de fermer
et rouvrir le monde avant sa préparation. Ce mécanisme ne fait pas partie de
l’installateur packwiz et n’autorise pas à supprimer un monde ou son journal.

## Correctif alpha.13.1 publié — 9 septembre 2026

[Sanctuary 0.1.0-alpha.13.1](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.13.1)
est publié depuis le commit source `b19e93d`. Le canal stable utilisait alors cette
version. Le JAR, le [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.13.1/Sanctuary-0.1.0-alpha.13.1.mrpack)
et le ZIP d’amorçage ont été vérifiés par téléchargement public. SHA-256 du JAR :

```text
b340dfc58f3d2d1a2a375dc527ac6721c61430600622046db26228e0da46061b
```

Deux synchronisations isolées puis deux dans la même instance Prism Mac ont
réussi. Le second passage conserve les fichiers gérés à l’identique ; un seul
JAR Sanctuary alpha.13.1 est actif. Les **713 fichiers personnels et réglages
suivis** conservent leurs hashes. Aucune sauvegarde personnelle n’a été ouverte,
convertie ou régénérée. Dossier de l’instance conservé : `Sanctuary-0.1.0-alpha.1`.
Sauvegarde ciblée : `sanctuary-backups/before-0.1.0-alpha.13.1/` ; reçus locaux
`build/alpha131-isolated-validation.json` et `build/alpha131-prism-validation.json`.

Le correctif évite la synchronisation de dossier non prise en charge sous
Windows. **Aucun nouveau monde requis :** fermer Minecraft, mettre l’instance
à jour puis rouvrir le même monde. Les réservations enregistrées reprennent
après vérification. La machine Windows n’a pas été accessible pour installation
ou essai natif : le [guide](alpha13-worldgen.md#correctif-alpha131--expansions-sous-windows)
décrit aussi le remplacement du seul JAR Sanctuary pour une instance issue du
MRpack sans auto-update. Voir les [preuves et limites](testing.md#correctif-alpha131--journal-dexpansion-sous-windows).

## Alpha.13 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.13](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.13)
est publiée depuis le commit source `78b63be`. Le canal stable utilisait alors
cette version. Le JAR, le [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.13/Sanctuary-0.1.0-alpha.13.mrpack)
et le ZIP d’amorçage ont été vérifiés par téléchargement public. SHA-256 du JAR :

```text
53eb5d8eda54d322250784203824993bd675de1cb90467e74d67589b15769e76
```

Deux synchronisations isolées puis deux passages dans la même instance Prism
ont réussi. Le second passage laisse les fichiers gérés identiques ; un seul
JAR Sanctuary alpha.13 est actif. Les **601 fichiers personnels et réglages
suivis** conservent leurs hashes, notamment les mondes et mods tiers. Aucune
sauvegarde personnelle n’a été ouverte, convertie ou régénérée.

L’instance conserve son dossier `Sanctuary-0.1.0-alpha.1`, sans réimportation.
Sauvegarde ciblée : `sanctuary-backups/before-0.1.0-alpha.13/` dans cette instance.
Reçus locaux : `build/alpha13-isolated-validation.json` et
`build/alpha13-prism-validation.json`.

Pour tester : créer un **nouveau monde**, choisir **Sanctuary**, puis le bouton
natif **Personnaliser** : Petit 512, Moyen 724 par défaut, Grand 1 024.
Le laboratoire n’est plus un choix public ; ses cavités et outils d’expansion
rejoignent le nouveau monde. Les anciennes générations restent chargeables.
Voir [le guide alpha.13](alpha13-worldgen.md) et [les preuves](testing.md).

## Correctif alpha.12.1 publié — 9 septembre 2026

[Sanctuary 0.1.0-alpha.12.1](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.12.1)
est publiée depuis le commit source `332d60b`. Le canal packwiz utilisait cette
version. Le JAR, le [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.12.1/Sanctuary-0.1.0-alpha.12.1.mrpack)
et le ZIP d’amorçage ont été vérifiés par téléchargement public. SHA-256 du JAR :

```text
c9df4da956cfa54581b3fde21de006bf8ac3ec025b8dd0daa5d060bcb70aabd4
```

Deux synchronisations isolées puis deux passages dans la même instance Prism
ont réussi ; le second laisse les fichiers gérés identiques. Un seul JAR
Sanctuary alpha.12.1 est actif, avec **466 fichiers personnels et réglages suivis
conservés**, y compris les mondes et les mods tiers. Aucun monde n’a été ouvert
ou régénéré. La sauvegarde ciblée est dans
`sanctuary-backups/before-0.1.0-alpha.12.1/` de l’instance existante ; reçus locaux
`build/alpha121-isolated-validation.json` et `build/alpha121-prism-validation.json`.

WG-14 ajoute la distance et le contournement automatique des zones occupées.
Les mondes laboratoire alpha.12 restent utilisables sans conversion : le journal
v1 et les descripteurs de génération 12 sont conservés. Voir le [guide](alpha12-laboratory.md).

## Alpha.12 publiée — 9 septembre 2026

[Sanctuary 0.1.0-alpha.12](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.12)
est publiée depuis le commit source `cdfbba0`. Le canal stable utilisait alors
cette version. Le JAR, le [MRpack](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.12/Sanctuary-0.1.0-alpha.12.mrpack)
et le ZIP d’amorçage Prism ont été téléchargés publiquement et vérifiés contre
les artefacts locaux. SHA-256 du JAR :

```text
f2ac2462a03a39ef330cc52143f9753ac5908b606cfe1dd1388ad5caae15e6e9
```

Le véritable installateur packwiz a réussi deux passages dans un dossier de
développement neuf, puis deux dans la même instance Sanctuary Beta. Le second
passage conserve les hashes des fichiers gérés. Un seul JAR Sanctuary alpha.12
est actif ; les **466 fichiers personnels et réglages suivis** conservent
leurs hashes, y compris les sauvegardes, mods tiers et configurations. Aucun
monde n’a été ouvert, converti ou régénéré par cette livraison.

La sauvegarde ciblée est dans `sanctuary-backups/before-0.1.0-alpha.12/` de
l’instance existante. Les reçus locaux ignorés sont
`build/alpha12-isolated-validation.json` et `build/alpha12-prism-validation.json`.
Le [guide](alpha12-laboratory.md) décrit le nouveau preset **Sanctuary — Laboratoire** :
créer un nouveau monde de ce type pour essayer les expansions. Les anciennes
parties et les presets Petit/Grand gardent leur génération.

## Livrer une mise à jour

Livraison précédente, vérifiée le 9 septembre 2026 :
[Sanctuary 0.1.0-alpha.11](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.11),
depuis le commit source `f30a350`. Le JAR, le `.mrpack` et le ZIP d’amorçage
Prism sont publiés et leurs téléchargements publics vérifiés. Le canal stable
pointait alors sur cette version. SHA-256 du JAR :

```text
f075ad8a0b97cd53e4891273adbee5f79f04ab3984442950d5d85f58d2ded589
```

Le véritable installateur packwiz a réussi deux fois dans un dossier de
développement neuf, puis deux fois dans l’instance Sanctuary Beta existante.
Le second passage laisse les fichiers gérés identiques. Un seul JAR Sanctuary
alpha.11 est actif ; les 364 fichiers personnels et réglages suivis conservent
leurs hashes, y compris les fichiers des mods tiers et leurs configurations.
L’ancien JAR et les manifestes locaux sont sauvegardés hors de `mods/`, dans
`sanctuary-backups/before-0.1.0-alpha.11/` de cette même instance.
Aucun monde existant n’a été ouvert, converti ou régénéré par la livraison.
Les reçus locaux ignorés sont `build/alpha11-isolated-validation.json` et
`build/alpha11-prism-validation.json` ; les listes de hashes avant et après
figurent dans le dossier de sauvegarde. Les preuves du build, des deux tailles
et de performance figurent dans [Validation](testing.md).

Après les vérifications, le commit et le push de la branche du ticket, le script
de publication réalise les étapes de release et de canal ci-dessous :

```sh
python3 scripts/publish_pack.py --notes-file chemin/vers/notes.md --asset build/Sanctuary-0.1.0-alpha.12.mrpack
```

Les options sont facultatives. Ce script **publie** sur le Git configuré dans
`origin` ; il exige un arbre propre, un HEAD déjà poussé et un JAR dont la version
correspond aux sources. Il utilise les identifiants du gestionnaire Git en
mémoire, refuse de remplacer une release ou un artefact différent portant la
même version, puis vérifie les téléchargements publics et les métadonnées du
canal. Il préserve l'historique de `packwiz` et n'utilise pas de push forcé. Il
ne lance pas les tests et ne modifie aucune instance de jeu : les vérifications
de livraison restent à exécuter avant cette commande.

La procédure complète, également utilisable manuellement :

1. Modifier ensemble les versions de `gradle.properties` et `packwiz/pack.toml`.
2. Exécuter `./gradlew check build assemblePack` et les vérifications du ticket.
3. Préparer les métadonnées de la livraison, avec l'URL exacte du futur JAR :

   ```sh
   python3 scripts/pack.py release https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.12/sanctuary-0.1.0-alpha.12.jar
   ```

4. Pousser le commit source vérifié. Créer une release Gitea correspondant à ce
   commit et joindre le JAR construit, sans remplacer les artefacts d'une release
   antérieure. Vérifier que le téléchargement public possède le SHA-256 indiqué
   dans `build/packwiz-release/mods/sanctuary.pw.toml`.
5. Publier le contenu de `build/packwiz-release/` à la racine de la branche
   `packwiz` dans un seul commit, puis vérifier les fichiers et hashes depuis
   l'URL publique. Préserver l'historique de ce canal et ne jamais y copier le
   dossier `build/packwiz/`, qui contient le JAR de développement.
6. Tester une installation puis une seconde synchronisation avec le véritable
   `packwiz-installer` dans un dossier de développement neuf. Le second passage
   doit laisser le pack à jour sans dupliquer Sanctuary.

`mods/sanctuary.pw.toml` conserve le même chemin entre versions ; seul son nom de
JAR, son URL et son hash changent. Packwiz peut ainsi retirer l'ancien JAR qu'il
gère quand il installe le nouveau. Une première installation depuis un `.mrpack`
n'a pas encore ce suivi : voir la procédure ci-dessous.

Un ZIP d'amorçage Prism se prépare avec :

```sh
python3 scripts/pack.py prism https://git.botsu.net/koka/sanctuary-beta/raw/branch/packwiz/pack.toml
```

Il contient les versions exactes Minecraft/Fabric, la commande de lancement et
`packwiz-installer-bootstrap` v0.0.3. Le script vérifie le SHA-256 du bootstrap
officiel avant d'écrire `build/Sanctuary-Prism-auto-update.zip`. Ce ZIP est réservé
aux nouvelles installations ; les instances déjà branchées sur packwiz suivent
le canal sans être réimportées.

## Raccorder l'instance Prism existante

Fermer Minecraft avant de modifier ses mods. Fermer également Prism avant de
modifier directement `instance.cfg`, pour éviter que son état en mémoire écrase
les changements. Dans l'instance Sanctuary Beta :

1. Sauvegarder `instance.cfg` et les anciens JAR Sanctuary dans un dossier de
   sauvegarde hors de `mods/`. Vérifier que l'instance utilise Minecraft
   `26.3-pre-2` et Fabric `0.19.5` ; ne pas convertir une instance 26.2.
2. Mettre le bootstrap issu du ZIP dans son dossier `minecraft/` (ou `.minecraft/`
   selon l'installation).
3. Dans **Modifier → Paramètres → Commandes personnalisées**, activer les
   commandes et renseigner la commande avant lancement ci-dessous.
4. Pour une instance issue d'un ancien `.mrpack`, déplacer seulement l'ancien
   JAR Sanctuary non géré dans la sauvegarde préparée, puis faire la première
   synchronisation packwiz. Conserver les autres mods et données personnelles.
   Si la synchronisation échoue, remettre ce JAR et les réglages sauvegardés.
5. Vérifier qu'il reste un seul mod Sanctuary actif et que `packwiz.json` est
   présent dans le dossier Minecraft. Les prochaines mises à jour sont suivies
   par ce manifeste local : ne pas le supprimer entre les versions.

Commande à coller dans l'interface Prism :

```text
"$INST_JAVA" -jar "$INST_MC_DIR/packwiz-installer-bootstrap.jar" --bootstrap-main-jar "$INST_MC_DIR/packwiz-installer.jar" --pack-folder "$INST_MC_DIR" --multimc-folder "$INST_DIR" https://git.botsu.net/koka/sanctuary-beta/raw/branch/packwiz/pack.toml
```

Une modification directe de `instance.cfg` doit échapper les guillemets au format
Qt INI (`\"`) et activer `OverrideCommands=true`. Ces clés et
`PreLaunchCommand` doivent être dans la section **`[General]`**, jamais ajoutées
après la section `[UI]`. Le ZIP préparé le fait déjà. Rouvrir les commandes
personnalisées dans Prism pour vérifier que la commande est effectivement lue.
Une instance importée d'un `.mrpack` peut être marquée `ManagedPack=true` :
dès que packwiz en assure les mises à jour, utiliser `ManagedPack=false` pour
éviter deux mécanismes de gestion sur le même pack.

## Données locales et mondes

Le pack livré possède uniquement les fichiers déclarés dans son index. Il ne
déclare ni `saves/`, ni `options.txt`, `servers.dat`, `screenshots/`, ni les packs
graphiques personnels. L'installation de packwiz et une mise à jour des mods
n'autorisent pas à supprimer ou régénérer un monde.

La hauteur de 384 blocs, le dessous sculpté et le ciel de l'alpha.3 se testent
dans un **nouveau monde** avec le preset **Sanctuary**. Les anciens mondes gardent
leurs identifiants de génération et leurs hauteurs. L’hydrologie de l’alpha.4
nécessite elle aussi un nouveau monde Sanctuary ; la mise à jour de l’instance
n’ajoute pas d’eau aux sauvegardes existantes. Les nouvelles plages, cascades,
biomes et petits filons de l’alpha.5 utilisent à leur tour un identifiant
séparé : créer un nouveau monde Sanctuary pour les découvrir. Les détails des versions de génération sont dans
[Génération](worldgen.md). Les changements de version Minecraft ou de format
de sauvegarde demandent leur propre ticket et contrat de migration.

L’alpha.6 utilise à son tour `sanctuary:sanctuary_layered` pour ses biomes par
altitude et sa nouvelle hydrologie. Créer un nouveau monde Sanctuary ; les
sauvegardes alpha.5 conservent notamment leur palette avec Dappled Forest.

L’alpha.7 sélectionne `sanctuary:sanctuary_woodland` pour ses forêts, ses
roches variées et ses minerais affleurants. Les mondes alpha.6 gardent
`sanctuary:sanctuary_layered` ; aucune régénération de chunks n’est effectuée.

L’alpha.8 sélectionne `sanctuary:sanctuary_rift` pour les failles, les grandes
rivières, les champignons géants et la géologie des profondeurs. Créer un
nouveau monde Sanctuary pour les découvrir. La même instance Prism reçoit
le nouveau JAR par le canal stable ; ses sauvegardes et réglages sont conservés.
Les mondes alpha.7 et antérieurs gardent leurs paramètres de génération.

L’alpha.9 utilise `sanctuary:sanctuary_cavern` pour les cavités luxuriantes,
les géodes, les geysers et les terrasses d’eau. Un **nouveau monde Sanctuary**
est nécessaire pour essayer cet incrément. Les mondes
alpha.8 conservent `sanctuary:sanctuary_rift` ; leur contenu n’est pas retouché
par une mise à jour de la même instance Prism. Les anciennes sauvegardes et
les réglages ont été conservés lors des deux synchronisations de livraison.

L’alpha.10 propose des choix de taille pour 5, 20 et 100 joueurs, avec
20 par défaut. Ils s’appliquent à un **nouveau monde**. Les profils sauvegardés `sanctuary:population_5`,
`sanctuary:population_20` et `sanctuary:population_100` sont séparés des
anciens réglages, notamment `sanctuary:sanctuary_cavern` de l’alpha.9.
La mise à jour de la même instance Prism n’agrandit aucune île
existante, ne modifie pas les paramètres de génération enregistrés et ne
nécessite pas de réimporter le ZIP d’amorçage. Les fichiers de sauvegarde,
captures, packs graphiques et réglages personnels suivis ont conservé leurs
hashes lors des deux synchronisations de livraison.

L’alpha.11 propose deux choix : **Petit** et **Grand**, Grand par défaut.
Le preset `sanctuary:sanctuary` crée un nouveau monde `population_10` ;
Petit garde `sanctuary:sanctuary_5` / `population_5`. Les anciens mondes
20/100 restent chargeables à leur taille enregistrée, alors que leurs formats
sont cachés de la création. Les formats de sauvegarde sont inchangés.

L’optimisation conserve les résultats pour un même réglage. La livraison a
préservé les fichiers personnels suivis, les mods tiers et leurs configurations.
L’instance n’a pas été réimportée et aucun mod tiers n’a été retiré. Les
sauvegardes personnelles sont restées fermées pendant les essais et la synchronisation.

Références officielles : [installation packwiz](https://packwiz.infra.link/tutorials/installing/packwiz-installer/),
[commandes Prism](https://prismlauncher.org/wiki/help-pages/custom-commands/),
[bootstrap v0.0.3](https://github.com/packwiz/packwiz-installer-bootstrap/releases/tag/v0.0.3).