release.json est le contrat de version du modpack. pack_version versionne le pack complet ; mod_version=0.0.0-alpha.0 marque par défaut les modules en veille. Chaque module actif avance indépendamment avec <module>_version et <module>_lifecycle dans gradle.properties. Le pack assemble automatiquement le JAR correspondant à la version effective de chaque projet.

La composition Modrinth/Prism est la seule propriétaire de pack_version. Un changement du pack ne réécrit donc pas les JAR des modules non modifiés.

Le client peut installer Sanctuary depuis Modrinth, puis Packwiz synchronise les JAR avant chaque lancement. Aucun mod ne tente de remplacer un JAR pendant que Minecraft l'utilise.

Mise à jour Packwiz

Pour reconstruire les dix JAR, sélectionner les dernières dépendances publiques release (ou beta lorsqu'un projet comme JEI ne publie aucune release 26.2), refuser les alphas et produire les deux archives :

./gradlew verifyPackwizRelease

téléverser puis extraire build/distributions/sanctuary-<version>-packwiz-site.zip dans https://download.botsu.cloud/sanctuary/26.2/ ;
vérifier que https://download.botsu.cloud/sanctuary/26.2/pack.toml répond ;
configurer l'instance Prism locale une seule fois avec ./pack/configure_packwiz_prism.sh ;
démarrer un serveur avec ./pack/start_sanctuary_server.sh /chemin/serveur java -Xmx4G -jar fabric-server-launch.jar nogui, ou appeler update_packwiz_server.sh avant la commande habituelle de l'hébergeur.

Pour les joueurs, ./gradlew verifyPackwizPrismClientZip produit un unique build/distributions/Sanctuary-26.2-auto-update.zip importable directement dans Prism Launcher. Cette archive ne contient ni mods, ni captures, ni sauvegardes, ni options personnelles : Packwiz télécharge le pack au premier lancement puis le synchronise à chaque lancement depuis download.botsu.cloud.

Packwiz ne possède jamais saves/, screenshots/, options.txt, servers.dat, resourcepacks/, shaderpacks/ ni sanctuary-personal/. Le dossier sanctuary-personal/ est créé automatiquement pour les notes, sauvegardes et fichiers propres au joueur ou à l'opérateur.

Le projet existant est identifié par l'ID stable FgOqyAXd et le slug indicatif sanctuary-koka99. Pour une release :

publier la release Modrinth sous le même numéro que pack_version ;
déclarer Minecraft 26.2, Fabric et le bon canal de release ;
faire installer le pack depuis Modrinth aux clients, sans importer une copie locale détachée ;
conserver les mondes, options et données explicitement prévus comme fichiers locaux lors des updates.

Vérification opérateur en lecture seule :

python3 pack/check_modrinth_update.py

Codes de sortie : 0 à jour, 10 update disponible, 2 configuration ou réseau indisponible.

Le livrable public Modrinth est généré avec :

./gradlew verifyModrinthMrpack

Le fichier unique build/distributions/sanctuary-<version>.mrpack est le fichier primaire à téléverser sur le projet Modrinth. Il contient les dix modules Sanctuary dans overrides, les dépendances publiques par URL Modrinth, les réglages Iris dans client-overrides et Voice Chat dans server-overrides. Un installateur serveur compatible .mrpack peut donc consommer exactement le même fichier que les clients.

Pour les essais locaux dans Prism Launcher, le workspace peut produire un pack de laboratoire qui embarque uniquement les dix JAR :

./gradlew localMrpack

Le résultat -local.mrpack sous build/distributions/ reste destiné aux essais Prism et ne doit pas être publié sur Modrinth. Le fichier sans suffixe -local est le livrable public.

Simple Voice Chat sur le serveur

Le pack épingle Simple Voice Chat Fabric 2.6.22+26.2 sur les clients et le serveur. Copier le JAR dans mods/, installer le fichier de configuration fourni sous config/voicechat/voicechat-server.properties, puis ouvrir 24454/UDP dans le pare-feu, le routeur ou le panneau de l'hébergeur. Il s'agit bien d'UDP, indépendamment du port TCP Minecraft.