sanctuary-luanti/docs/REFERENCES.md

Références de conception

Cette synthèse rend le dépôt autonome tout en conservant la provenance des idées. Les chemins ci-dessous décrivent le workspace local au moment de l'initialisation et ne sont pas des dépendances d'exécution.

Documents Sanctuary 26.2 lus

Source locale	Apport retenu
../26.2/sanctuary/PROGRESSION.md	directeur de partie, statistiques permanentes, Atlas, branches et multijoueur
../26.2/sanctuary/ALPHA.md	monde historique fini, déterministe et préservable
../26.2/iliketomoveit/PORTALS.md	routes data-driven, paires persistantes, arrivées sûres et autorité serveur
../26.2/README.md	séparation des responsabilités fonctionnelles et état des systèmes
../26.2/AGENTS.md	discipline de migrations, compatibilité, tests et petites branches
../26.2/CONTRIBUTING.md	flux de contribution et contrats inter-mods

Carte fonctionnelle héritée

Sanctuary 26.2 répartit le projet en dix responsabilités. La version Luanti conserve cette lecture du produit, sans décider prématurément qu'une ligne doit devenir un mod distinct.

Domaine 26.2	Responsabilité	Traduction Luanti envisagée
Another World	matière, biomes, photographie, instruments météo	nœuds, crafts, worldgen et outils d'observation
It's Alive!	vivant, créatures, agriculture et cuisine	cycles biologiques et gameplay du vivant
Ambiance	perception, météo, lumière, audio et calendrier	composition client accessible, pilotée par des états serveur
Red-Stoner	calcul, signaux, ordinateurs, identité locale et stockage	machines, mémoire du lieu et interfaces informatiques
I Like To Move It	portails, véhicules, grappin, poulies et waystones	déplacements locaux, inter-ères puis handoff fédéré
Ouch	combat, armes et destruction	règles de dommage et risques explicites
Only Fun	raretés et règles ludiques absurdes	écarts volontaires, sans raccourci de progression caché
Sanctuary	progression, aventure, Atlas et monde principal	directeur de partie et propriétaire des jalons
Events	événements de serveur	événements collectifs data-driven
MasterKey	administration et diagnostic	commandes opérateur, migrations et laboratoire

Cette carte impose une règle simple : le directeur interprète les événements, mais le domaine qui crée un contenu reste propriétaire de ses IDs et de son état.

Contrats à préserver

• La progression, les transactions, les arrivées et les dégâts sont validés par le serveur.
• Atlas sépare la mémoire personnelle de la mémoire collective du lieu.
• Les waystones servent au déplacement local ; les portails relient des régions, des ères ou, plus tard, des serveurs.
• Une route est définie par des données, possède deux extrémités persistantes et cherche une arrivée sûre.
• Les formats persistants gardent une version et une migration monotone.
• Les nouveaux habitants commencent au rang initial mais peuvent bénéficier des infrastructures déjà construites.
• Le ciel partagé et ses constellations financées collectivement constituent un exemple fort de création commune à réinterpréter dans Luanti.

Traductions et écarts

• Les « chapitres » deviennent des « ères » pour souligner la préservation des couches de monde ; leur structure en tronc et branches est conservée.
• Les dimensions Minecraft deviennent d'abord des régions éloignées dans un même monde Luanti, puis éventuellement des serveurs fédérés.
• Les IDs historiques prouvent l'intention mais ne sont pas repris tels quels.
• Les personnages, marques et assets Minecraft ne sont pas importés. Les rôles narratifs doivent être réécrits avec une identité Sanctuary originale.
• L'interconnexion de serveurs est une nouvelle direction : elle étend le contrat des portails sans prétendre qu'elle existe déjà dans Sanctuary 26.2.

Références Luanti

• moteur officiel : https://www.luanti.org/ ;
• documentation : https://docs.luanti.org/ ;
• API Lua officielle : https://github.com/luanti-org/luanti/blob/master/doc/lua_api.md.

Luanti ne centralise pas les comptes entre serveurs. Cette contrainte est traitée comme une propriété de la fédération et non comme un détail à masquer.