sanctuary-luanti/README.md

Sanctuary pour Luanti

Sanctuary est un jeu de survie et d'exploration libre construit avec Luanti. Il reprend la vision du projet Sanctuary : commencer vulnérable, faire grandir durablement son personnage, découvrir des ères dans un ordre partiellement ouvert et relier des mondes habités.

Cette édition n'est pas un fork de Luanti. C'est un jeu autonome chargé par le moteur officiel. Ce choix garde le projet libre, distribuable et soutenable ; un fork ne sera envisagé que face à une limite technique démontrée.

Intention

Le monde de blocs sert ici de langage commun pour habiter Internet autrement. Un serveur n'est pas une instance jetable : c'est un lieu numérique entretenu, avec une mémoire, des habitants et des passages choisis vers d'autres lieux. Sanctuary vise donc une fédération de mondes autonomes plutôt qu'un métavers centralisé.

La vision complète se trouve dans docs/VISION.md. La traduction du parcours historique de Sanctuary 26.2 se trouve dans docs/PROGRESSION.md.

État actuel

Le jalon 0.1.0-dev.1 fournit les fondations de développement :

• un game Luanti autonome et un mod directeur sanctuary_core ;
• quatre nœuds de monde minimaux et un biome de test ;
• un schéma de progression joueur versionné, encore sans économie d'achat ;
• des commandes de diagnostic en lecture seule ;
• un healthcheck qui démarre Luanti réellement puis arrête le monde CI ;
• un environnement local isolé dans .runtime/ ;
• la vision, l'architecture, la progression et la feuille de route initiales.

Ce n'est pas encore une boucle de jeu. La première tranche jouable sera le prologue de l'île.

Prérequis

• Luanti 5.16 ou plus récent ;
• Node.js 20 ou plus récent ;
• npm.

Le script trouve automatiquement Luanti dans /Applications/Luanti.app sur macOS. Sur une autre installation, définir LUANTI_BIN vers l'exécutable.

Démarrage

npm install
npm run setup
npm test
npm run play

Commandes utiles :

Commande	Effet
npm run setup	prépare les mondes de développement isolés
npm run check	lance le healthcheck avec le vrai moteur
npm test	teste l'outillage puis le démarrage Luanti
npm run play	lance le monde local de développement
npm run server	lance un serveur local sur 127.0.0.1:31099
npm run status	affiche moteur, version et processus géré
npm run logs	affiche la fin du journal de développement
npm run stop	arrête uniquement le processus lancé par l'outillage

Structure

mods/sanctuary_core/  directeur de progression et socle du monde
docs/                 vision, contrats et feuille de route
tools/                lancement Luanti reproductible et isolé
tests/                vérifications statiques de la fondation
.runtime/             mondes, logs et état local non versionnés

Voir docs/ARCHITECTURE.md avant de créer un nouveau mod ou un protocole de portail.

Sources et indépendance

La conception s'appuie sur les documents du workspace Sanctuary 26.2, notamment sanctuary/PROGRESSION.md, sanctuary/ALPHA.md et iliketomoveit/PORTALS.md. Leur synthèse, la carte des dix domaines historiques et les écarts sont consignés dans docs/REFERENCES.md.

Ce dépôt ne contient aucun code, binaire ou asset Minecraft/Mojang. Une idée de gameplay peut être réinterprétée ; un asset ou une implémentation ne peut être importé qu'après vérification explicite de sa provenance et de sa licence.

Licence

Code et documentation : GNU GPL, version 3 ou ultérieure (GPL-3.0-or-later). Les futurs assets devront déclarer leur licence dans un inventaire dédié avant distribution.