Sanctuary

Sanctuary est une extension gratuite de Minecraft qui transforme le jeu en un monde flottant d'exploration, de production et de progression collective. Les joueurs commencent ensemble sur Sanctuary Island et construisent les infrastructures qui permettront progressivement d'ouvrir de nouveaux continents.

Sanctuary is a free expansion of Minecraft that reshapes the game around a floating world. Players begin together on Sanctuary Island, isolated in the void. By exploring, building infrastructure and producing resources, they progressively unlock new floating continents, each with its own geography. Rather than a linear campaign, the server itself becomes a world that grows through the action of its players.

Ce dépôt démarre la nouvelle base Fabric. La vision complète conserve les intentions ; le backlog prépare les premiers tickets. Les systèmes d'expansion, d'économie, de progression et les dimensions décrits dans la vision ne sont pas encore implémentés.

Premier incrément

• Mod sanctuary indépendant et pack Sanctuary construit avec packwiz.
• Preset Sanctuary sélectionnable à la création d'un monde, avec une île flottante finie, un terrain naturel et un extérieur vide.
• Forêt de départ avec végétation, minerais et animaux vanilla. Les formes de terrain reprennent l'approche du générateur 26.2, adaptée à l'API 26.3.
• Spawn recherché sur le sol de l'île lors de la création. Les mondes ordinaires et les choix ultérieurs de spawn ne sont pas remplacés.
• Nouveaux mondes sur 384 blocs (Y=0..383), île relevée de 64 blocs, dessous sculpté et nuages au-dessus du terrain. Les anciennes sauvegardes conservent leurs paramètres de génération.
• Première hydrologie de surface : étangs, petits lacs et cours d’eau calmes, avec des berges de sable et de la canne à sucre lorsque le terrain s’y prête.

L'île a une emprise nominale de 512 blocs de diamètre, avec une bordure sculptée par des bruits liés à la seed. Aucune masse centrale n'est ajoutée pour forcer le terrain : le spawn cherche un emplacement naturel. Le catalogue TerraMix, les continents déverrouillables, les grandes rivières et cascades, les ruines et les autres fonctionnalités restent à construire par tickets.

Le premier champ de recherche climatique est défini : nord froid, sud chaud, ouest sec et est humide, avec leurs combinaisons diagonales. Un outil de développement relève les ressources après génération ; le système d'expansion en jeu reste à construire. Voir Expansion et ressources.

Les détails du terrain et de ses limites sont dans Génération, et la provenance dans Audit 26.2.

Versions et prérequis

Au 8 septembre 2026, la cible disponible est 26.3-pre-2. Le dépôt ne prétend pas cibler une version finale 26.3 déjà sortie. Le passage à la version finale sera une mise à jour explicite, avec vérification des API et des sauvegardes.

Composant	Version fixée
Minecraft Java	26.3-pre-2
Java JDK	25
Fabric Loader	0.19.5
Fabric API	0.160.0+26.3
Fabric Loom	1.17.20
Gradle Wrapper	9.5.1, distribution vérifiée par SHA-256
Sanctuary / pack	0.1.0-alpha.4

Java 25 et Python 3.11 ou plus récent sont nécessaires. Le script pack utilise uniquement la bibliothèque standard et repère aussi une installation Python 3.11–3.14 si python3 désigne l'ancien Python fourni par macOS. Gradle est fourni par le wrapper. packwiz est utile pour modifier les dépendances ou servir le pack ; il n'est pas nécessaire pour le construire.

Références vérifiées : Minecraft 26.3-pre-2, Fabric, version Fabric API.

Construire et lancer

git clone https://git.botsu.net/koka/sanctuary-beta.git
cd sanctuary-beta
./gradlew check build assemblePack

check inclut les tests de forme et le serveur de test automatisé de Fabric, qui charge le vrai preset Sanctuary dans un monde de développement neuf. Les scénarios couverts et les essais multijoueurs restant à effectuer sont décrits dans Validation.

Résultats :

• mods/sanctuary/build/libs/sanctuary-0.1.0-alpha.4.jar : mod à installer avec Fabric API sur la version Minecraft indiquée.
• build/packwiz/ : pack de développement complet, avec le mod construit et l'index vérifié. Voir Installation packwiz.

Le pack peut aussi être exporté en .mrpack avec packwiz pour une importation dans un lanceur compatible ; la commande est indiquée dans ce même guide.

Pour les essais réguliers, la même instance Prism suit un canal packwiz stable et se synchronise avant chaque lancement. La procédure de publication et de raccordement est dans Distribution Prism.

Lancer le client de développement :

./gradlew :sanctuary:runClient

Créer un nouveau monde, puis sélectionner le type de monde Sanctuary. L'installation du mod seule ne transforme pas un monde Minecraft ordinaire.

Pour un serveur de développement, lancer ./gradlew :sanctuary:runServer, puis suivre les indications du jeu concernant son EULA. Utiliser un dossier de monde neuf et choisir dans mods/sanctuary/run/server.properties :

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

Relancer ensuite la même commande. Ne pas remplacer le générateur d'une sauvegarde 26.2 : aucun outil de migration de ses chunks n'est livré ici.

Organisation

Chemin	Responsabilité
mods/sanctuary/	Code, ressources et tests du mod Sanctuary
packwiz/	Manifeste source, dépendances distantes et hashes
ressources-pack/	Sources graphiques existantes et futurs resource packs
shaders-pack/	Sources et réglages de shaders à venir
docs/	Vision, backlog, migration, génération et validation
.gitea/ISSUE_TEMPLATE/	Modèles de tickets fonctionnalités et bugs
.gitea/workflows/	Vérification sur un runner Gitea compatible

It's Alive !, Only Fun et Master Key restent des modules autonomes prévus par la vision. Leurs sources 26.2 ne sont pas copiées dans ce socle. Fabric API est la seule dépendance de gameplay actuellement distribuée avec le mod.

Travailler par tickets

Un ticket décrit un comportement à obtenir ou un bug à reproduire. On livre un petit incrément, on le vérifie en jeu si nécessaire, puis on ajuste avec le ticket suivant. Pour le terrain, joindre la seed et les coordonnées aide à retrouver exactement le problème. Voir Contribuer.

Le backlog initial contient des propositions locales, pas des issues déjà publiées. Le prochain travail après ce socle est le réglage de l'île, puis le placement de continents et leur ouverture sans écraser les constructions des joueurs.

Licence et crédits

Sanctuary conserve la licence GPL-3.0-or-later du projet 26.2. Voir LICENSE et provenance et crédits. Projet communautaire indépendant de Mojang Studios et Microsoft.