# Pack Sanctuary et Prism Launcher

Ce dossier contient le manifeste packwiz source et Fabric API, avec une version
exacte de Minecraft et du chargeur Fabric. Le JAR Sanctuary embarque Demeure
et le port expérimental de JEI ; les autres intégrations sont vérifiées par ticket.

Depuis la racine :

```sh
./gradlew check build assemblePack
```

Le dossier `build/packwiz/` contient le pack complet de développement : manifeste,
index, dépendances distantes et JAR Sanctuary construit localement. Les sources
dans ce dossier `packwiz/` ne contiennent jamais de JAR Sanctuary généré.

## Une instance Prism qui se met à jour

Le canal de distribution de Sanctuary Beta est :

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

Le [guide de distribution](../docs/packwiz.md) décrit sa publication et le passage
d'une instance existante à packwiz. Le fichier `packwiz/pack.toml` de la branche
source ne suffit pas pour jouer : il manque la référence du mod compilé, ajoutée
au moment de la livraison.

Pour préparer une instance importable dans Prism :

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

Importer `build/Sanctuary-Prism-auto-update.zip` dans Prism, via **Ajouter une
instance → Importer**. Conserver ensuite cette même instance : packwiz vérifie
les mises à jour avant chaque lancement. Java 25 doit être disponible dans Prism.
La génération du ZIP ne publie pas le pack et ne modifie aucune instance locale.

## Pack local et export ponctuel

Pour le servir à un installateur packwiz depuis cette machine :

```sh
cd build/packwiz
packwiz serve
```

Pour produire un fichier importable par un lanceur compatible Modrinth :

```sh
cd build/packwiz # depuis la racine du dépôt
packwiz modrinth export --output ../Sanctuary-beta.092.mrpack
```

L’exemple vise `beta.092` et nécessite son build local vérifié.
Les versions suivent la [convention commune au mod et au pack](../docs/versioning.md).
L'export contient le JAR Sanctuary local et la référence vérifiée de Fabric API.
Il ne publie rien sur Modrinth.
Cet export reste destiné aux imports ponctuels ; les instances déjà raccordées
reçoivent les livraisons après publication sur le canal packwiz, sans nouvelle
importation. La préparation locale de la bêta ne met pas ce canal à jour.

Utiliser l'URL HTTP affichée de `pack.toml` dans packwiz-installer. Le serveur
local doit rester actif pendant l'installation. Ce n'est pas une publication
hébergée permanente. Une installation manuelle reste possible : copier le JAR
Sanctuary construit et Fabric API dans `mods/` d'une nouvelle instance
Minecraft 26.3 / Fabric 0.19.5 / Java 25.

Pour modifier les dépendances, utiliser packwiz ici puis `packwiz refresh`.
La cible Minecraft, Fabric et Fabric API doit rester synchronisée avec
`gradle.properties`. Le build vérifie versions et hashes de l'index.

Les resource packs et shaders en préparation restent dans leurs dossiers de
sources tant que leur ticket de distribution n'est pas terminé.