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.
• Île tempérée aux teintes douces : forêts de chênes et de bouleaux, clairières fleuries et affleurements de pierre, andésite, diorite et granite. Des failles courbes ouvrent le terrain flottant issu du générateur 26.2. Les corniches humides accueillent chênes noirs et champignons ; les essences rares restent ponctuelles.
• Géologie enrichie en profondeur : tuf, pierres moussues et boue compactée dans les intérieurs humides, puis ardoise des abîmes, roche noire, basalte et poches de soufre. Les volumes existants fournissent leur support.
• Petits filons de charbon, fer, cuivre, or, redstone, lapis, diamant et émeraude à des altitudes adaptées au terrain. Les essais de charbon, fer et cuivre exposés sont plus fréquents. Les stocks se constatent après génération.
• 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.
• Étangs, petits lacs, plages plus larges et dépôts de trois à cinq blocs de sable, gravier, pierre ou terre enherbée. La canne à sucre apparaît lorsque les rives respectent ses règles vanilla.
• Recherche de bassins plus grands et d’une longue rivière calme au tracé arrondi, avec largeur variable et berges progressives. La liaison de deux bassins, sa source et sa cascade entrante sont contrôlées dans les mondes de test de l’alpha.8.
• Quelques sources dans des niches rocheuses naturelles, y compris aux étages inférieurs : Minecraft fait couler leur eau en cascades, qui peuvent descendre jusque dans le vide.
• Une petite poche de lave couverte est recherchée en priorité sur une corniche profonde, puis plus haut si nécessaire. Une à deux sources profondes supplémentaires peuvent former des coulées, vérifiées par les ticks du moteur.

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 océans, les ruines et les autres fonctionnalités restent à construire par tickets.

L’alpha.8 utilise la nouvelle génération sanctuary:sanctuary_rift ; créer un nouveau monde pour l’essayer. Les anciennes générations, jusqu’à l’alpha.7, gardent leurs paramètres ; aucune sauvegarde n’est régénérée. Dappled Forest reste réservé aux futurs continents et présent dans les anciennes sauvegardes alpha.5. La validation moteur de l’alpha.8 passe sur les trois graines de référence, avec 1 800 ticks de fluides ; aucune rivière, coulée ou quantité de ressources n’est garantie pour toutes les graines. Les observations et leurs limites figurent dans Validation.

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.8

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.8.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.