sanctuary-beta/README.md

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

Le chantier worldgen est terminé sur le socle **alpha.30.7**, selon la décision
du créateur du 12 septembre 2026. La suite commence par une passe courte sur
les **expansions**, puis se concentre sur la **progression en jeu**.
La [vision complète](docs/vision.md) conserve les intentions ; le
[backlog](docs/backlog.md) suit les tickets et leurs résultats vérifiés.
L’économie, les claims et les dimensions décrits dans la vision restent
à implémenter.

Les sources Git sont synchronisées jusqu’à **beta.060**. Le récapitulatif de
[synchronisation](docs/git-sync-beta060.md) précise les vérifications et les
limites. Les archives bêta mentionnées dans ce document sont des fichiers
locaux ; la dernière release du canal packwiz reste **alpha.30.7**.

Les [archives pour le site](archives/web/README.md) conservent la maquette
Blocodex autonome, les documents et les images retrouvées jusqu'à alpha.30.7.
La [carte native beta.005](docs/atlas-beta005.md) prend le relais après
l’étude de Xaero et des alternatives libres.


## beta.060 — objets et blocs sur les mobs

Maj + clic droit avec un objet équipe la tête d'un mob. Clic droit utilise
le bloc ; Maj + clic droit à main vide récupère l'objet. Une poule portant une
torche de redstone alimente les circuits voisins en se déplaçant. Coffres,
cuissons, leviers, boutons et autres blocs reprennent les interactions de tête.
[Contrat et vérifications](docs/mob-head-blocks-beta060.md).
Build, parcours natif et archives vérifiés.
[Pack normal](build/Sanctuary-beta.060.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.060.mrpack).

## beta.059 — bannières et cartes au trésor

Un clic droit enregistre une bannière avec sa couleur et son nom ; utiliser
une carte au trésor importe ses repères dans la World Map. Les opérateurs
peuvent inspecter les trésors des îlots sans les découvrir pour leur personnage.
Les cartes s'obtiennent dans le butin des navires et des îlots miniers.
[Contrat](docs/atlas-markers-beta059.md). Build, parcours natif et archives vérifiés.
[Pack normal](build/Sanctuary-beta.059.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.059.mrpack).

## beta.058 — altitude de la carte

Les boutons ↑ et ↓ sous le zoom changent la coupe de la carte :
0, 140, 280, 420, 560, 640. La position et le zoom restent en place ;
les relevés personnels des couches inférieures se constituent lors des visites.
Chunks et Demeure sont désactivés par défaut. Le cadre assombri est retiré.
[Contrat](docs/atlas-altitude-beta058.md). Build et parcours natif vérifiés.
[Pack normal](build/Sanctuary-beta.058.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.058.mrpack).

## beta.057 — météo quotidienne et nouvelles ambiances

`/sanctuary weather realtime` choisit une ambiance pour chaque journée réelle :
beau temps, ciel gris, brouillard, averses, pluie continue ou orage.
Les averses alternent avec des périodes sèches ; les autres profils gardent
leur état pour la journée. Le serveur suit son fuseau Real Time et conserve
la prévision lors des reconnexions. `/sanctuary weather vanilla` reprend le
cycle Minecraft. [Contrat](docs/daily-weather-beta057.md).
Build, essais natifs et archives vérifiés.
[Pack normal](build/Sanctuary-beta.057.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.057.mrpack).

## beta.056 — étoiles dispersées et saturation

Les étoiles d'un même accomplissement se répartissent sur toute la sphère
céleste. Les nouveaux souvenirs augmentent la densité sans déplacer ceux déjà
affichés. Les anciennes constellations conservent leurs liens et suivent cette
nouvelle disposition. Vanilla Light démarre à 142 % de saturation, en respectant
les préférences déjà enregistrées. [Contrat](docs/sky-spacing-beta056.md).
Build, test client natif et archives vérifiés.
[Pack normal](build/Sanctuary-beta.056.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.056.mrpack).

## beta.055 — Force et portage de joueurs

Force réduit le ralentissement lié aux joueurs portés, y compris dans une pile.
Avec un joueur sur la tête : 75 % de vitesse sans Force, environ 87 % avec
Force I et 91 % avec Force II. Le calcul suit l'effet du porteur et se rétablit
à son expiration. [Contrat et vérifications](docs/strength-carry-beta055.md).
Build et test natif client/serveur réussis.
[Pack normal](build/Sanctuary-beta.055.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.055.mrpack).

## beta.054 — duels, mises et niveaux des familiers

H → Duel permet de défier un joueur proche. Chacun choisit éventuellement une
mise dans son inventaire, puis les deux valident. Le gagnant reçoit les deux
mises ; une interruption les restitue. G déclenche la technique du familier.
Les gains restent disponibles si l'inventaire est plein. H → Niveaux du familier
permet de stocker et récupérer son XP. Chaque niveau renforce la vie et les
dégâts sans plafond ; la rareté de l'œuf augmente également. Transferts hors
combat, exacts en points d'XP, conservés avec l'individu lors des échanges.
[Contrat et vérifications](docs/familiar-combat-beta054.md).
Les 88 profils sont présents ; certaines variantes et leur équilibrage restent
à finaliser. Build, parcours natifs FR/EN et archives vérifiés.
[Pack normal](build/Sanctuary-beta.054.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.054.mrpack).

## beta.053 — brume progressive et saturation

Vanilla Light fait commencer la brume dès le point de vue. Options → Shaders
propose une saturation de 0 à 200 %, appliquée immédiatement et sauvegardée ;
100 % conserve le rendu habituel. Les œufs de Hello World sont alignés à gauche.
[Contrat et vérifications](docs/progressive-fog-beta053.md).
Build et parcours client natif FR/EN réussis ; archives locales vérifiées.
[Pack normal](build/Sanctuary-beta.053.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.053.mrpack).

## beta.052 — nom du familier de départ

Hello World propose un champ « Nom du familier » sous les trois œufs. Le nom
choisi suit le compagnon et sa fiche d'habitant ; vide, il garde le nom de son
espèce. [Contrat et migration](docs/starter-name-beta052.md).
Build, **8 tests serveur**, parcours client FR/EN et reconnexion vérifiés.
[Pack normal](build/Sanctuary-beta.052.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.052.mrpack).

## beta.051 — distributeur porté orienté par le regard

Les projectiles partent dans la direction regardée par le porteur, y compris
vers le haut et vers le bas. Le tir différé utilise le regard au moment du
lancement et suit la position précise de la tête.
[Contrat et vérifications](docs/head-dispenser-beta051.md).
Build, **34 tests serveur** et archives vérifiés.
[Pack normal](build/Sanctuary-beta.051.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.051.mrpack).

## beta.050 — bateaux compacts et redstone portée

Bateaux **1 × 2 et 2 × 1**, quatre places dans les onze bois. Bibliothèques
sculptées compatibles avec les livres enchantés, objets visibles dans les
étagères et livre visible sur le pupitre. Lits complets, uniquement décoratifs ;
pots de fleurs utilisables. Boutons et leviers reposent sur la tête et, avec
la torche de redstone, alimentent les circuits proches.
[Contrat et vérifications](docs/head-blocks-beta050.md).
Build, **40 tests serveur**, parcours client natif FR/EN et archives vérifiés.
[Pack normal](build/Sanctuary-beta.050.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.050.mrpack).

## beta.049 — bateaux rectangulaires et chapeaux actifs

Bateaux 3 × 1, 1 × 3, 2 × 3 et 3 × 2 dans les onze bois, avec recettes
identiques à leur disposition. Chaque module reçoit deux passagers, en remplissant
d’abord les places principales, puis les secondaires. Les blocs portés montrent leurs aliments et
leurs ouvertures ; leurs sons incluent celui qui les utilise. Têtes et fours
regardent vers l'avant, les bateaux ont leur modèle de chapeau et les coups
produisent un signal redstone local.
[Contrat et vérifications](docs/boats-head-beta049.md).
Build, **35 tests serveur**, parcours client natif FR/EN et archives vérifiés.
[Pack normal](build/Sanctuary-beta.049.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.049.mrpack).

## beta.048 — bateaux collectifs et moteurs animaux

Bateaux 2 × 2 et 3 × 3 dans les onze bois natifs, avec fonds répétés, rebords
extérieurs et deux rames. Quatre ou neuf bateaux du même bois forment la recette.
Poule, chauve-souris, perroquet, abeille, Blaze, Allay et Breeze fournissent des
propulsions différentes ; les pilotes partagent les commandes, les piles ajoutent
leur poids. Les petites piles se raccrochent si la place est libre ; à partir de
quatre personnes, le porteur touché descend avec son groupe supérieur.
Le Happy Ghast se déplace deux fois plus vite.
[Contrat, gestes et vérifications](docs/poultry-aeronautics-beta048.md).
Build, **33 tests serveur**, parcours client natif FR/EN et exports vérifiés.
[Pack normal](build/Sanctuary-beta.048.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.048.mrpack).

## beta.047 — étoiles à la longue-vue et boutons

Observer une étoile à la longue-vue affiche son nom, l'événement qui l'a créée,
sa date et ses constellations. La molette parcourt les appartenances multiples.
Le clic droit observe ; **Maj + clic droit** retire désormais le dernier trait.
Les textes des boutons actifs deviennent jaune vif au survol.
[Contrat et vérifications](docs/spyglass-stars-beta047.md).
Build, **12 tests serveur**, parcours client FR/EN et exports vérifiés.
[Pack normal](build/Sanctuary-beta.047.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.047.mrpack).

## beta.046 — constellations, vol et zoom

Les nouvelles factions proposent deux places dès leur création.
Longue-vue en main, le clic gauche relie les étoiles et le clic droit retire le
dernier trait. Une poule dans le bateau permet de monter avec Espace et de
redescendre en le relâchant. Le zoom devient une aptitude, avec C et la molette.
La fenêtre utilise le titre Sanctuary - beta.046 et l’icône officielle.
Les dix aptitudes affichent les icônes fournies, également copiées dans le resource pack.
[Gestes, règles et vérifications](docs/sky-flight-zoom-beta046.md) ·
[Migration des factions](docs/faction-two-slots-beta046.md).
[Pack normal](build/Sanctuary-beta.046.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.046.mrpack).
Build, **20 tests serveur**, parcours client FR/EN et intégrité des exports vérifiés.

## beta.045 — menu principal

La version de Sanctuary apparaît en haut à gauche. Friends / Amis est un bouton
normal sous Multiplayer, à la place de Realms. Les trois icônes compactes
Friends, Language et Accessibility sont retirées du menu principal.
[Contrat et vérifications](docs/title-menu-beta045.md).
[Pack normal](build/Sanctuary-beta.045.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.045.mrpack).
Build, quatre tests serveur ciblés et parcours client FR/EN réussis.

## beta.044 — pouvoirs natifs des familiers

Les attaques de Creeper, Blaze, Ghast, Wither, Dragon et Breeze utilisent leurs
effets natifs. Le Slime crée un vrai bloc sous les pieds pendant cinq secondes.
Les 88 œufs ont un contexte positif d'activation ; les stocks, impacts et effets
principaux sont contrôlés par les tests.
[Audit et contrat](docs/spawn-eggs-audit-beta044.md) ·
[Catalogue des 88 œufs](docs/spawn-eggs-catalogue-beta044.md).

La commande /sanctuary time vanilla fonctionne après activation tardive des
commandes en LAN : le replay d'introduction ne capture plus les commandes serveur.
L'icône officielle utilise la dernière variante fournie, avec le bleu en haut.
[Pack normal](build/Sanctuary-beta.044.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.044.mrpack).
Build, **69 tests serveur** et deux parcours client réussis.

## beta.043 — blocs portés et icône officielle

Les blocs portés ouvrent leurs menus natifs et gardent leur fonctionnement de
stockage et de traitement. Au retrait, le contenu est rendu ; les Shulkers le
conservent. L’icône officielle est incluse dans le mod et les packs.
[Contrat, couverture et limites](docs/functional-head-blocks-beta043.md).
Build et **41 tests serveur** réussis. Rendu client supplémentaire non validé.
[Pack normal](build/Sanctuary-beta.043.mrpack) ·
[Monde plat rapide](build/Sanctuary-Test-beta.043.mrpack).

## beta.042 — joueurs assis sur la tête

Le bassin du passager repose sur la tête du porteur, avec la pose assise native.
Le placement tient compte des piles, de l'accroupissement et des différences
de taille. [Ticket et diagnostic LAN](docs/lan-carry-beta042.md).

Build, **39 tests serveur** et rendu natif réussis. Exports vérifiés :
[pack normal](build/Sanctuary-beta.042.mrpack) ·
[monde plat rapide](build/Sanctuary-Test-beta.042.mrpack).

## beta.041 — portage des bébés

Porter un bébé mob ne ralentit plus le joueur. La même règle s'applique aux
familiers dont le modèle est un bébé, y compris dans une pile de joueurs.
Les adultes gardent leur poids ; le ralentissement se recalcule si un animal
grandit pendant le portage. [Contrat et vérifications](docs/carry-babies-beta041.md).

Build et **43 tests serveur** réussis. Exports vérifiés :
[pack normal](build/Sanctuary-beta.041.mrpack) ·
[monde plat rapide](build/Sanctuary-Test-beta.041.mrpack).

## beta.040 — mode opérateur, fiche Habitant et ciel partagé

Le crash du Hello World en multijoueur à froid est corrigé : les trois œufs
s'affichent avant la réception des composants d'items. Le tirage et l'admission
restent gérés par le serveur. [Correctif](docs/multiplayer-hello-beta040.md).

**World Options → Allow Commands** pilote les options opérateur Sanctuary.
Sans commandes, elles sont masquées et refusées par le serveur ; avec commandes,
les inspections de la carte et des catalogues sont disponibles. Les contrôles
se mettent à jour dès l'application du réglage.

**Options → Shaders → Sanctuary · Vanilla Light** ajoute un traitement léger des
couleurs, désactivable. Les étoiles empruntent la passe native du ciel ; la
compatibilité avec Iris devra être vérifiée lorsque sa version pour notre
Minecraft sera disponible. [Rendu et limites](docs/shaders-beta040.md).

La fiche Habitant présente le personnage et son familier en 3D, avec un cadrage
adapté à la largeur, le nom, la bio et le nom personnalisé de l'œuf équipé.
Le ciel se remplit à partir des premières arrivées, advancements, prestiges
et premières factions de deux membres. Les étoiles restent après la mort,
les reconnexions et la dissolution d'une faction. Un même duo ne peut pas
multiplier les étoiles en recréant sa faction.
[Contrat et limites](docs/operator-inhabitant-stars-beta040.md).

Build, **50 tests serveur** et parcours client natif réussis, y compris
l’accueil à froid et le catalogue complet après réouverture. Connexion réseau
dédiée non testée. Exports : [pack normal](build/Sanctuary-beta.040.mrpack) ·
[monde plat de test rapide](build/Sanctuary-Test-beta.040.mrpack).

## beta.039 — Hello World, savoir alimentaire et inventaires de mort

Le **Hello World** affiche trois cases d’œufs sous les couleurs, avec une courte
description au survol. Trois familiers différents sont tirés une seule fois parmi
les communs, avec **10 % de chance** qu’un peu commun remplace l’un d’eux. La
reconnexion reprend la création au même stade et garde les mêmes choix. Le choix
confirmé est définitif ; l’œuf est équipé à l’arrivée, une seule fois.
[Contrat du familier de départ](docs/hello-starter-beta039.md).

L’aptitude **Connaissance alimentaire** coûte **4 niveaux**. Sans elle, il faut
avoir goûté un aliment pour voir ses apports dans les infobulles et l’aperçu du
HUD. Les dégustations attestées par Une alimentation équilibrée sont reprises.
Le savoir reste après la mort et le prestige. L’indication d’épuisement passe
sous les sprites de nourriture.

**Options → Captures d’écran → Capture panoramique** transforme la touche de
screenshot en capture des six faces, avec profondeur et masque de brume
reconstitué. Résultats dans `screenshots/panoramas/`, sans écraser les captures
précédentes. Désactiver l’option rétablit les screenshots habituels.

Les nouvelles têtes s’appellent **Pseudo 1**, **Pseudo 2**, etc., selon le compteur
de morts Minecraft. Le cosmétique de tête utilise le profil du défunt. Leur menu
affiche l’inventaire au décès à gauche et celui du joueur qui récupère à droite :
les cases restent à leur place, grisées et accessibles en retrait uniquement.
L’inventaire actuel conserve son rendu normal ; les deux côtés utilisent les
textures existantes.
Les anciennes têtes gardent leur coffre de récupération, faute de disposition
sauvegardée. [Contrat des inventaires](docs/grave-inventory-beta039.md) ·
[Capture et savoir](docs/food-panorama-beta039.md).

Build, **68 tests serveur** et parcours client natif réussis.
Exports : [pack normal](build/Sanctuary-beta.039.mrpack) ·
[monde plat de test rapide](build/Sanctuary-Test-beta.039.mrpack).

## beta.038 — nourriture, têtes-tombes et factions

Les informations alimentaires inspirées d’AppleSkin sont intégrées au HUD :
saturation, épuisement, aperçu de la nourriture tenue et icônes en infobulle,
adaptés aux trois à dix icônes de Hunger. Options → Informations alimentaires
permet de choisir les indications visibles. Le [guide des textures](ressources-pack/sanctuary/FOOD.md)
prépare leur remplacement dans le resource pack.

À la mort, les objets sont réunis dans la tête du joueur, pillable par tout le
monde. Clic droit sur la tête : coffre de récupération à deux pages. La casser
permet de transporter le contenu ; clic droit dans le vide pour l’ouvrir en main,
Maj + clic droit sur un bloc pour la reposer. Les cases grisées autorisent
uniquement le retrait. La tête conserve nom, date, cause et coordonnées de la
mort. L’XP garde sa règle actuelle.

Fonder sa faction coûte **10 niveaux**, dès le début et sans prestige. Le
fondateur possède l’unique place de départ ; les charges gagnées par prestige
financent les places suivantes. Les anciennes factions gardent leurs capacités.
[Contrat et vérifications](docs/graves-food-beta038.md).
Build, 55 tests serveur et parcours client natif réussis. Exports vérifiés :
[pack normal](build/Sanctuary-beta.038.mrpack) ·
[monde plat de test rapide](build/Sanctuary-Test-beta.038.mrpack).

## beta.037 — temps réel et suivi commun

Le ciel suit l’heure réelle et les saisons. En solo, Sanctuary prend le fuseau
horaire de la machine et sa ville de référence, sans géolocalisation. Le serveur
dédié choisit son fuseau dans `config/sanctuary/realtime.json`. Les ticks de jeu
restent normaux ; dormir en lit ne saute plus la nuit.

Le suivi utilise un seul moteur pour les advancements et les futurs objectifs
de quête, avec les notifications au même endroit. Le rendu fonctionne aussi
lorsque F3 est fermé. Les quêtes elles-mêmes restent à développer.

`/sanctuary time` consulte l’heure ; les opérateurs peuvent choisir
`/sanctuary time vanilla` ou `realtime`, et recharger la configuration avec
`/sanctuary time reload`. Voir le [contrat et les réglages](docs/realtime-beta037.md).

Exports vérifiés (29 tests serveur et deux parcours client) : [pack normal](build/Sanctuary-beta.037.mrpack) et
[profil plat rapide](build/Sanctuary-Test-beta.037.mrpack).

## beta.036 — notifications et suivi choisi

Les notifications s’affichent **en haut à droite** par défaut, avec neuf positions
au choix et un placement qui évite F3, les annonces natives et les barres du HUD.
Un clic sur un advancement l’épingle ; un second le retire. Les objectifs choisis
restent suivis après la mort, les découvertes et progrès non épinglés s’effacent.

Porter un animal volant permet de planer ; s’allonger au sol réduit la détection
visuelle des mobs. Les sorties des recettes apprises par collection deviennent
recherchables dans JEI sans inventer leur possession dans Discovery.
[Contrat et vérifications](docs/corrections-beta036.md).
Build, **36 tests serveur** et deux parcours client natifs réussis.
Exports : [pack normal](build/Sanctuary-beta.036.mrpack) ·
[monde plat de test rapide](build/Sanctuary-Test-beta.036.mrpack).

## beta.035 — collections Minecraft

Les **2 042 recettes** de la version sont réparties en **67 collections** :
66 familles de survie et une référence technique. Les **126 advancements**
et la découverte de leurs matériaux enseignent les familles correspondantes,
même avant l’achat du catalogue. Les recettes connues restent conservées.
Discovery → Recettes affiche les collections en FR/EN ; le fil de découvertes
annonce les nouveaux chapitres. [Règles et vérifications](docs/collections-beta035.md).
Le [document de conception](docs/collections-minecraft.md) comporte désormais
un lien vers chaque définition serveur, et un générateur vérifie sa concordance
avec l’[inventaire exhaustif](docs/collections-minecraft-inventaire.md).
Build, **28 tests serveur** et parcours client natif réussis, dont la conservation
des collections après prestige, mort et redémarrage.
Exports : [pack normal](build/Sanctuary-beta.035.mrpack) ·
[pack de test rapide](build/Sanctuary-Test-beta.035.mrpack).

## beta.034 — fil de découvertes et hotbar agrandie

Un fil discret en bas à droite signale les premières découvertes de blocs,
d’objets et de recettes. Les lots de recettes se regroupent, les messages
s’effacent et les collections utilisent les barres Minecraft. **Options →
Notifications** règle leur visibilité, leur durée et le suivi des advancements.
Les quêtes, bounties et panneaux restent pour un prochain ticket.

Factions et History sont désormais accessibles par **Progression → Prestige**,
sans leurs boutons supplémentaires dans le menu pause. La hotbar de l’inventaire
personnel reprend les proportions du HUD et des objets légèrement plus grands.
[Contrat et vérifications](docs/notifications-beta034.md).
Exports : [pack normal](build/Sanctuary-beta.034.mrpack) ·
[pack de test rapide sur monde plat](build/Sanctuary-Test-beta.034.mrpack).
Build, 22 tests serveur, parcours client natif et intégrité des deux packs vérifiés.

## beta.033 — menus directs et profil de test rapide

Le menu pause ouvre directement Discovery, Progression, World, Inhabitant, Factions et
History. Discovery commence sur **Owned** ; l’aptitude **Catalogue**, à quatre
niveaux, ajoute **All Blocks** parmi les blocs déjà découverts. Les accès de
maintenance et le bouton de configuration JEI sont retirés de ces interfaces.
La flamme du gâteau porté rejoint la pointe de sa bougie.
[Contrat des menus](docs/menus-discovery-beta033.md).

Le module facultatif **Sanctuary Test** propose un monde plat natif et passe
automatiquement la cinématique, tout en gardant la fiche d’habitant et les vrais
systèmes du jeu. [Utilisation du profil rapide](docs/test-rapide-beta033.md).
Exports : [pack de test rapide](build/Sanctuary-Test-beta.033.mrpack) ·
[pack normal](build/Sanctuary-beta.033.mrpack).
Build, 34 tests serveur et parcours client natifs réussis.


## beta.032 — refonte des 88 familiers

Les 88 passifs et actifs disposent de nouvelles valeurs et recharges, avec
zones de laine, brumes déplaçables, passages volontaires et gestes de travail
utilisant les vrais outils et stocks. Les limites de soin, d’air, de garde et
de déplacement se partagent entre les œufs de tous les aidants.
[Catalogue complet](docs/spawn-eggs-v2-catalogue-beta032.md) ·
[Migration et vérifications](docs/spawn-eggs-v2-beta032.md).
Build, 85 tests serveur et parcours client natif validés ; équilibre en partie
à essayer. Export : [Sanctuary-beta.032.mrpack](build/Sanctuary-beta.032.mrpack).

## beta.031 — apparition galactique

Après **Entrer dans Sanctuary**, les 32 glyphes de l'UUID surgissent un à un
du noir, avec des mouvements de profondeur, des rémanences et un crescendo
sonore. Une spirale les entraîne des bords vers un portail qui grandit jusqu’à
remplir l’écran. Le flash blanc s’efface ensuite sur le spawn.
Cette apparition atmosphérique dure **29,5 secondes** ; le spawn et `helloworld`
suivent sa fin. **Échap** permet de la passer. **`/sanctuary intro`** la rejoue
avec son UUID, sans recréer de personnage.
[Proposition, admission et vérifications](docs/introduction-beta031.md).
Export : [Sanctuary-beta.031.mrpack](build/Sanctuary-beta.031.mrpack).
Build, 9 tests serveur et parcours client natif validés.

## beta.030 — lumières portées et objets jetés

Les mains, les cosmétiques de tête et les objets jetés éclairent le décor,
y compris chez les autres joueurs. Une bougie sur un gâteau éclaire une fois
allumée. Les objets proches au sol partagent une source, avec un budget de
mise à jour et aucun recalcul répété pour une source immobile.
[Utilisation, réglages et vérifications](docs/dynamic-lights-beta030.md).
Export d’essai : [Sanctuary-beta.030.mrpack](build/Sanctuary-beta.030.mrpack).
Build, 21 tests serveur et parcours client natif réussis.

## beta.029 — cri et recul des familiers

Frapper un familier déclenche le cri de son espèce et le repousse avec la physique
native. Son suivi marque une courte pause pour laisser voir le recul, puis reprend.
Le familier reste invulnérable ; l’arme ne s’use pas. La caresse garde ses cœurs.
[Contrat et vérifications](docs/familiar-hit-feedback-beta029.md).
Export d’essai : [Sanctuary-beta.029.mrpack](build/Sanctuary-beta.029.mrpack).
Build et 38 tests serveur réussis ; écoute et essai visuel encore à confirmer.

## beta.028 — plongeon jusqu’à collision

Le plongeon conserve sa posture jusqu’au contact du terrain ou de l’eau,
sans limite de 1,5 seconde. Réappuyer sur la touche ne coupe plus le geste
en plein vol. Une seule impulsion par saut ; gravité et dégâts de chute conservés.
[Contrat et vérifications](docs/dive-until-collision-beta028.md).
Export d’essai : [Sanctuary-beta.028.mrpack](build/Sanctuary-beta.028.mrpack).
Build et 32 tests serveur réussis ; essai visuel encore à confirmer.

## beta.027 — piles de joueurs

**Maj + clic droit** permet de monter sur un joueur déjà porté. On peut aussi
grimper avec les personnes que l’on porte. Toute la pile ralentit le joueur
du dessous : 75 %, 56 %, 42 %… jusqu’à un minimum de 25 % de sa vitesse habituelle.
[Gestes, règles et vérifications](docs/player-stacks-beta027.md).
Export d’essai : [Sanctuary-beta.027.mrpack](build/Sanctuary-beta.027.mrpack).
Build et 27 tests serveur réussis ; essai visuel encore à confirmer.

## beta.026 — cache d’affichage Demeure sur la carte

Les empreintes Demeure utilisent une couche de texture mise en cache. La carte
ne dessine plus un rectangle par bloc à chaque image ; les lots réseau identiques
ne reconstruisent plus la couche. Demeure reste activé par défaut, avec le même
brouillard, les mêmes couleurs et les mêmes règles serveur.
[Diagnostic et vérifications](docs/demeure-map-performance-beta026.md).
Export d’essai : [Sanctuary-beta.026.mrpack](build/Sanctuary-beta.026.mrpack).
Build et 9 tests serveur réussis ; mesure graphique encore à valider sur une
session Mac déverrouillée.

## beta.025 — barres d’XP des compétences

**B → Progression** : les jauges ASCII deviennent des barres d’expérience Minecraft.
Le prix du prochain palier est centré sur chaque barre. Elles commencent légèrement
remplies et deviennent pleines au dernier rang, sans texte « Max ».
Les six rangées d’inventaire restent le plafond actuel.
[Affichage et vérifications](docs/skill-xp-bars-beta025.md).
Export local : [Sanctuary-beta.025.mrpack](build/Sanctuary-beta.025.mrpack).
24 tests serveur et parcours graphique FR/EN réussis.

## beta.024 — recettes progressives dans le Blocodex

**B → Découverte → Recettes** ouvre le carnet. L’aptitude **Catalogue de recettes**
coûte **4 niveaux** : les découvertes et les advancements Minecraft enseignent
les plans avant même cet achat. Une planche révèle les bases du bois ; le premier
progrès d’alchimie ouvre sa collection. La fabrication manuelle reste libre.

JEI est porté depuis ses sources 26.2 vers la version exacte du pack. Son catalogue
masque les objets inconnus ; la vue opérateur s’active explicitement. **R / U**
consultent recettes et utilisations dans l’inventaire. Le bouton **+** de JEI tient
compte des six rangées et exclut les cases de récupération verrouillées.
Le catalogue et les recettes sont conservés après prestige, mort et redémarrage.
[Contrat, collections et limites](docs/recipes-jei-beta024.md).

Le [catalogue proposé des collections Minecraft](docs/collections-minecraft.md)
relie les 126 advancements à 67 collections et classe les 2 042 recettes de la
version du pack. Son inventaire couvre aussi les blocs et objets ; cette proposition
documentaire n’active pas de nouvelles collections en jeu.

Le correctif de chargement beta.022 et les interactions cosmétiques beta.023 sont
inclus. Export : [Sanctuary-beta.024.mrpack](build/Sanctuary-beta.024.mrpack).
Client et serveur beta.024 ensemble. 123 tests serveur, 588 288 comparaisons de
terrain et parcours client natif validés. Livraison locale, non installée dans Prism.

## beta.023 — cosmétiques directement sur leur case

Le grand bouton Cosmetic est retiré. **Clic droit sur la case cosmétique** :
utiliser une bougie ou un briquet au curseur ; curseur vide pour éteindre,
récupérer la bougie d’un gâteau ou changer la pose du golem. **Clic gauche**
retire l’objet. Les huit cases d’équipement ont leur infobulle de rôle.
Cette livraison intègre aussi l’optimisation du chargement de beta.022.

Les panneaux sont modifiables par les autres joueurs, les bannières gardent
leurs motifs, les lits et portes sont complets, et les minecarts utilisent leur
modèle en volume. Toile, feuilles et verre enveloppent la tête. Une TNT portée
s’amorce sur un coup et explose réellement après quatre secondes.
[Contrat et vérifications](docs/head-cosmetics-beta021.md).

Export : [Sanctuary-beta.023.mrpack](build/Sanctuary-beta.023.mrpack).
117 tests serveur et parcours client natif réussis.
Client et serveur beta.023 ensemble.

## beta.022 — création de monde plus rapide

La génération évite les calculs de bruit dont l’influence est nulle, en conservant
le même terrain. La comparaison CPU sur les mêmes colonnes mesure **19,66 % de
calcul en moins** ; la création serveur témoin atteint **89 s** sur Mac M1.
Cette durée exclut le lancement et le rendu du client. Le détail des mesures,
de leur portée et des vérifications est dans [STARTUP-01](docs/initial-loading.md).
Livraison locale, non publiée et non installée dans Prism.

## beta.020 — œufs singuliers, portage et plongeon

Les œufs portent désormais les couleurs de leur rareté et deux noms d’effets
cryptiques. **Étude des familiers**, dans les aptitudes, coûte **4 niveaux**
et révèle leurs explications dans l’infobulle native. **Habitant** rassemble
les réglages d’aide alliée, acceptée par défaut, et le carnet. **G** active
le pouvoir ; les boutons d’activation dans les menus sont retirés.

Les familiers utilisent de préférence leur modèle bébé. Clic droit : cœurs ;
clic gauche : réaction de coup, sans dégâts. Nommer l’œuf à l’enclume ou utiliser
une étiquette sur son compagnon conserve son nom avec l’œuf.
Chaque œuf reçoit aussi une **taille aléatoire persistante** au premier équipement :
90 % de tailles ordinaires, 5 % de minuscules et 5 % de géants. La taille reste
visuelle et ne change pas les pouvoirs.

**Maj + clic droit** porte un animal ou fait monter sur la tête d’un joueur.
Refaire le geste dépose le passager ; le joueur porté relâche Maj puis rappuie
pour descendre. Le porteur est ralenti de 25 %, et les coups entre les deux sont
bloqués. **Saut en sprint puis W**, ou la touche S’allonger configurée, déclenche
un plongeon horizontal.

Les détections révèlent leurs repères derrière les murs ; les téléportations
Endermite/Enderman peuvent les traverser vers une arrivée libre. Le freinage
de chute de la poule efface la distance dangereuse accumulée auparavant.
[Contrat, tailles et vérifications](docs/familiar-interactions-beta020.md).

Export : [Sanctuary-beta.020.mrpack](build/Sanctuary-beta.020.mrpack).
Client et serveur beta.020 ensemble. Contrôles purs, 104 tests serveur,
parcours client et rendu des 88 modèles aux tailles extrêmes validés.
L’équilibrage en partie réelle reste à poursuivre.

## beta.019 — pouvoirs et déplacements des familiers

Les **88 familiers** ont leur passif et leur actif, répartis entre commun,
peu commun, rare, extraordinaire et légendaire. Équiper un œuf et attendre
10 secondes active son passif. **B → Progression → Aptitudes → Lien actif**
coûte **4 niveaux** ; **G**, configurable, utilise le pouvoir. Le panneau
Familier affiche les effets, la recharge et le consentement aux aides.

Les volants utilisent une navigation aérienne, le Dragon décrit une orbite,
les aquatiques nagent et se débattent au sol. Le rendu noirci est corrigé.
Les familiers volants deviennent progressivement transparents à proximité
du joueur ou de la caméra, corps et yeux compris.

La recharge commune et les récupérations soin/air survivent à la mort et au
prestige. Ressources, cibles et transactions restent contrôlées par le serveur.
Les rangs I–III, œufs Anomaly et leur obtention en survie restent à concevoir.
L’équilibrage en partie réelle reste à éprouver : [contrat et couverture](docs/companion-powers-beta019.md).

Export : [Sanctuary-beta.019.mrpack](build/Sanctuary-beta.019.mrpack).
Contrôles purs, 91 tests serveur et parcours client natif validés.

## beta.018 — familiers, cape et cosmétique de tête

L’inventaire personnel reçoit trois cases : **œuf de familier**, **cape** et
**cosmétique de tête**, avec les trois icônes fournies par le créateur. Son titre
ne comporte plus de compteur de rangées. Maj-clic équipe un œuf ou une cape ;
un objet de tête se place volontairement et n’ajoute aucun effet d’équipement.
Un piston porté s’étend brièvement quand le joueur subit des dégâts.

Le familier suit réellement le joueur, contourne les obstacles et revient par
téléportation vers une place libre quand nécessaire. Il est invincible, sans
collision avec les entités. Clic droit sur son propre compagnon pour le caresser :
particules de son œuf et petits cœurs. Les pouvoirs feront l’objet d’un autre ticket.
**Cape Zéro** est disponible en créatif ou avec `/give @s sanctuary:zero_cape` ;
son visuel provisoire est la Vanilla Cape, avec [provenance](THIRD_PARTY_NOTICES.md).

**W : s’allonger**, gratuit dès le départ. **Maj + W : se reposer**, aptitude
à 4 niveaux par défaut, utilise la pose de sommeil des lits. Le repos conserve
son échange vie/faim et ne fait pas passer la nuit. Les touches se configurent.
Les emplacements sont, de haut en bas : cosmétique, cape, œuf, main secondaire.
**Maj + clic gauche maintenus** transfèrent les cases parcourues vers le
conteneur ouvert, avec les règles natives de chaque machine.
**Tab / Maj + Tab** changent aussi la rangée de hotbar pendant le jeu, sans
ouvrir l’inventaire. Les objets restent dans leurs cases et la touche se configure.
Le minage et la construction groupés verrouillent la sélection au premier clic :
le regard reste libre pendant le maintien. Relâcher permet de choisir un nouveau
groupe ; le plan et l’orientation de construction conservent leur état initial.
[Contrat et vérifications beta.018](docs/companions-cosmetics-beta018.md).
Export local vérifié : [Sanctuary-beta.018.mrpack](build/Sanctuary-beta.018.mrpack).
Contrôles purs, 67 tests serveur et parcours client natif validés.

## beta.017 — Nage, S’allonger, Se reposer et fabrication manuelle

Trois aptitudes rejoignent la liste du Blocodex, **4 niveaux chacune** par défaut :
**Nage** autorise le sprint aquatique ; **S’allonger** utilise **W** pour basculer
la posture basse ; **Se reposer** utilise **Maj + W** pour récupérer un demi-cœur
toutes les 10 secondes immobiles contre une demi-barre de faim. Bouger ou subir
des dégâts arrête le repos. La touche se configure dans Contrôles ; V reste libre
pour le vocal. Les trois aptitudes sont conservées au prestige.
Les compétences affichent le prix du prochain rang à côté de leur jauge ASCII ;
le ratio redondant est remplacé par `4 niv.` ou `Max.`.
Chaque récompense des Premiers pas s'accompagne du son vanilla de gain d'XP.

Sans Nage, on peut avancer lentement dans l'eau et remonter. La nage rapide suit
la faim nécessaire au sprint. Les prix se règlent par `swimmingCost`, `lyingCost`
et `restingCost` dans `config/sanctuary/progression.json`.

Le livre natif est retiré des inventaires, établis et fours ; la fabrication
manuelle reste disponible. L'intégration de JEI révélant les recettes selon les
advancements Minecraft est un chantier suivant. Les récompenses du tutoriel et
les textures beta.016 restent incluses.
[Contrat de migration et vérifications](docs/swimming-recipebook-beta017.md).
Export local vérifié : [Sanctuary-beta.017.mrpack](build/Sanctuary-beta.017.mrpack).
Contrôles purs, 62 tests serveur puis 15 tests ciblés finaux et parcours client
natif validés ; sons d'XP, clavier AZERTY et fabrication manuelle vérifiés.

## beta.016 — les premiers gestes rapportent de l’XP

Se déplacer et regarder, trouver un arbre, miner une bûche, ouvrir son inventaire
et fabriquer des planches donnent **8 points d’XP chacun**, une seule fois par
habitant dans le monde. Le premier geste suffit à acheter un premier rang.
Les étapes restent terminées après la mort et le New Game+ ; les points non
dépensés suivent les règles de mort existantes. Message personnel FR/EN à chaque gain.

`config/sanctuary/tutorial.json` permet de régler `enabled` et `xpPerStep`
au redémarrage du serveur. [Contrat et vérifications](docs/tutorial-xp-beta016.md).
Les six nouvelles icônes beta.015 sont incluses ; la respiration du HUD reste vanilla.
Export local : [Sanctuary-beta.016.mrpack](build/Sanctuary-beta.016.mrpack).
57 tests serveur, contrôles purs et parcours client natif validés.

## beta.015 — icônes de progression communes

Les six icônes du Blocodex utilisent les nouveaux PNG 9 × 9 du créateur.
Les mêmes textures sont présentes dans les sources du resource pack Sanctuary,
avec les mêmes identifiants. [Correspondance et vérifications](docs/progression-textures-beta015.md).
Export local : [Sanctuary-beta.015.mrpack](build/Sanctuary-beta.015.mrpack).

## beta.014 — Rangement, hotbar mobile et préfixe de faction

**B → Progression → Aptitudes → Rangement** débloque le tri pour **4 niveaux**
par défaut. Le clic molette sur une case de stockage regroupe les piles et range
les rangées débloquées, jusqu'aux six rangées de l'inventaire. La hotbar garde
son organisation ; la viser permet de ranger uniquement ses neuf cases.
La touche se configure dans **Contrôles → Sanctuary → Ranger la zone d'inventaire visée**.

Les cases de récupération, l'équipement, la fabrication et le contenu des
coffres restent à leur place.
Le prix se règle avec `sortingCost` dans `config/sanctuary/progression.json`.
[Contrat de migration et vérifications](docs/inventory-sorting-beta014.md).

**Tab** fait monter le cadre de la hotbar, **Maj+Tab** le fait descendre.
Les objets restent dans leurs cases et la rangée active devient celle utilisée
en jeu. La molette suit la zone survolée. La sélection est conservée à la
reconnexion ; le rangement tient compte de cette rangée active.

La faction précède le pseudo : **Les Arpenteurs · Poupoutain I**, dans la fiche
Habitant et les noms affichés. Son préfixe suit l'appartenance et sa couleur ;
le prestige conserve ses chiffres romains. Les descriptions d'aptitudes ne
répètent plus la règle globale de conservation au New Game+.

Export local vérifié : [Sanctuary-beta.014.mrpack](build/Sanctuary-beta.014.mrpack).


## beta.013 — Progression, prestige et repères visuels

Chaque compétence rassemble sur une ligne son icône, son nom, la jauge ASCII,
la valeur/plafond et les boutons d'achat/retrait. Les aptitudes gardent leur
colonne défilante. La courbe par défaut devient **1, 2, 4, 8, 16, 32, 48 niveaux** ;
les prix personnalisés et les remboursements des anciens achats sont conservés.

Pour passer en prestige : **B → Progression → Cycle**, après avoir maximisé
les six compétences, puis confirmer le New Game+. Le premier passage donne
par défaut **1 prestige et 1 charge**. **B → Monde → Factions** permet alors
de fonder une faction de deux places ; les invités n'ont pas besoin de prestige.
Cette page explique désormais le parcours et propose un accès direct à Cycle.

La fiche Habitant affiche le prestige en chiffres romains après le nom. Après
le New Game+, les cinq rangées de récupération sont entièrement grisées quand
elles restent visibles, même dans les coffres et même pour les cases vides.

La carte conserve les relevés reçus pendant les déplacements et actualise son
image sans effacement cyclique. Le point personnel reprend le sprite natif du
locator. Les marqueurs des joueurs, teintés avec les couleurs des habitants,
se superposent à la barre d’XP, dont le fond et le remplissage restent visibles.

La molette suit le survol : case sélectionnée sur la hotbar, rotation de rangée
sur le stockage débloqué, échanges sur les offres du villageois. Tab/Maj+Tab
restent disponibles.

Contrat et vérifications : [beta.013](docs/progression-inline-beta013.md).
Export local vérifié : [Sanctuary-beta.013.mrpack](build/Sanctuary-beta.013.mrpack).

## beta.012 — Inventaire et progression lisible

Les coffres et les machines alignent leur fond, leurs commandes et leurs cases.
Le stockage suit l'ordre des rangées, avec la barre rapide en bas. **Tab** fait
circuler les rangées débloquées et **Maj+Tab** inverse le sens ; la touche se règle
dans les contrôles. Si E est choisie, **Échap** ferme l'inventaire.

Maj-clic regroupe les piles sur toutes les rangées avant de remplir une case vide.
Les rangées supplémentaires suivent les priorités natives des machines ; un coffre
plein laisse les objets à leur emplacement. Les six compétences affichent une
jauge et leur plafond. **+** apparaît quand l'achat est possible ; **−**, réservé
aux opérateurs, rembourse le prix réellement payé pour le dernier rang retiré.

Le [contrat beta.012](docs/inventory-flow-beta012.md) décrit les données conservées
et la migration des achats. Export local vérifié :
[Sanctuary-beta.012.mrpack](build/Sanctuary-beta.012.mrpack).

## beta.011 — Factions, prestige et New Game+

**B → Progression → Cycle** montre les six plafonds, les compétences restantes
et le bilan avant confirmation. Toutes les compétences au maximum permettent
un New Game+ ; les aptitudes ne sont pas un prérequis. Le passage remet les six
rangs et, par défaut, l'XP à zéro. Identité, aptitudes, objets, découvertes,
Atlas, Demeure, statistiques, exploits et faction restent acquis. Les anciennes
rangées pleines restent accessibles en récupération.

Chaque passage donne **1 prestige et 1 charge personnelle**. Dans **B → Monde
→ Factions**, une charge fonde une faction de deux places, puis chaque membre
peut financer une place supplémentaire pour une charge. Invitations, départs,
exclusions, transmission et dissolution sont enregistrés côté serveur. La
couleur de faction est celle du fondateur au moment de sa création ; les
couleurs personnelles ne changent pas. Les factions ne protègent pas les chunks.

Le [contrat commun et la migration](docs/cycle-factions-beta011.md) précisent
les données conservées, les prix configurables et la reprise après interruption.
Les prochaines étapes sont les claims et leur contrat de protection.
Export local : [Sanctuary-beta.011.mrpack](build/Sanctuary-beta.011.mrpack).

## beta.010 — Inventaire jusqu'à six rangées

La sixième compétence devient achetable : **une à six rangées de neuf cases,
barre rapide comprise**. Cinq achats ajoutent chacun une rangée, pour un
plafond de 54 cases hors équipement. Les fonds d'inventaire et de conteneurs
proviennent de la 26.2 et suivent la capacité du joueur.

Les anciennes cases occupées restent visibles et permettent de retirer leurs
objets, sans y déposer à nouveau tant que leur rangée n'est pas débloquée.
Un astérisque dans le titre signale ces cases de récupération. Les grands
conteneurs font défiler leurs rangées à la molette lorsque l'écran manque de
hauteur ; la barre rapide reste visible. Le catalogue créatif propose un
bouton **Inventaire** pour ouvrir les rangées personnelles.

Les achats, sauvegardes, transferts, fabrication et règles de mort sont décrits
avec les vérifications dans [le contrat beta.010](docs/inventory-beta010.md).
Export local : [Sanctuary-beta.010.mrpack](build/Sanctuary-beta.010.mrpack).

## beta.009 — Construction et vein building

**Construction** est achetable dans les Compétences du Blocodex. Sept rangs
agrandissent les surfaces de **3×3 à 15×15**, avec un aperçu vert. La face visée
détermine le sol, le mur ou le plafond ; le serveur pose du centre vers les bords.

Avec un bloc en main, **R** affiche l'aperçu, **R + clic droit maintenus** pose
la surface et **R + molette** règle sa taille. **R + clic gauche** reste le
minage ; la touche commune se configure dans les contrôles. Relâcher arrête
le geste en conservant ce qui est déjà construit.

En survie, chaque pose consomme un bloc de la pile tenue, tous les deux ticks.
Les collisions, orientations, permissions, statistiques et contributions Demeure
suivent les placements natifs. Portes, lits, plantes doubles, échafaudages et nénuphars gardent la pose
individuelle. Les anciennes progressions conservent leurs achats, puis commencent
Construction au rang zéro : [contrat et vérifications](docs/building-beta009.md).
Export local : [Sanctuary-beta.009.mrpack](build/Sanctuary-beta.009.mrpack).

## beta.008 — Minage et vein mining

**Minage** est achetable dans la colonne Compétences du Blocodex. Ses sept
rangs augmentent la vitesse de 100 à 200 % et la taille des veines jusqu'à
256 blocs. Maintenir **R** affiche les blocs identiques reliés par leurs faces ;
maintenir **R + clic gauche** les mine. **R + molette** choisit une taille plus
petite parmi les rangs acquis. La touche se règle dans les contrôles.

La durée dépend des blocs et de l'outil ; les objets, l'XP, l'usure, la faim
et les enchantements suivent Minecraft. Relâcher, changer d'outil ou ouvrir
le Blocodex interrompt le geste. Les rangs survivent à la mort et à la reprise.
Les progressions beta.003–007 sont reprises selon le
[contrat de migration et les vérifications](docs/mining-beta008.md).
Export local : [Sanctuary-beta.008.mrpack](build/Sanctuary-beta.008.mrpack).

## beta.007 — carte immersive

La carte s'étend à tout l'écran, derrière les commandes du Blocodex. Un carré
central reste clair, avec des abords sombres et le fond du jeu visible là où
aucune surface n'est dessinée. Coordonnées et zoom se superposent en bas à
gauche ; les boutons gardent la priorité sur le déplacement de la carte.
La grille et les empreintes Demeure accompagnent le terrain jusqu'aux bords.

Les relevés existants sont conservés, sans changement des sauvegardes ou du
terrain. Voir [le ticket et les vérifications](docs/atlas-immersive-beta007.md).
Export local : [Sanctuary-beta.007.mrpack](build/Sanctuary-beta.007.mrpack).

## beta.006 — brouillard, grille et Demeure

Dans **B → Monde → Grande carte**, le glisser-déplacer utilise les boutons
souris natifs de 26.3 et reste disponible pendant les rafraîchissements.
Le terrain apparaît progressivement sur un parchemin ; les découvertes
beta.005 restent acquises. Les boutons **Chunks** et **Demeure** activent
la grille et les empreintes d'habitation. Survoler une zone connue affiche
son état et son influence principale, avec la couleur de l'habitant.

Demeure est un mod autonome embarqué. Les traces utilisent des jours réels
et persistent après redémarrage. **Aucun claim ni protection de chunk** dans
ce premier lot. Contrat et validation : [Demeure beta.006](docs/demeure-beta006.md).
Export local : [Sanctuary-beta.006.mrpack](build/Sanctuary-beta.006.mrpack).

## beta.005 — carte native et noms de couleurs

**B → Monde → Grande carte** ouvre une carte de surface avec déplacement,
zoom et recentrage. L'aptitude coûte 4 niveaux par défaut ; les relevés
personnels sont conservés avant son achat. La vue opérateur, explicitement
sélectionnée et autorisée par le serveur, inspecte le terrain déjà chargé.
Mini-carte, marqueurs et partage entre habitants restent à développer.

Les couleurs de création portent des noms associés aux teintes (Azur,
Pamplemousse, Sauge…), dans des boutons Minecraft au texte coloré.
S'asseoir disparaît des aptitudes et du passeport et reste disponible par le geste.

Les achats beta.003/004 sont repris selon [le contrat de migration](docs/atlas-beta005.md).
Export local : [Sanctuary-beta.005.mrpack](build/Sanctuary-beta.005.mrpack).

## beta.004 — cadre Blocodex et sprint

Le titre et les onglets **Discovery, Progression, Story, Inhabitant** restent
en haut ; **Done / Terminé** reste centré en bas. Les découvertes partagent
ce cadre, et les textes de la fiche et de l'histoire peuvent défiler.
Les six compétences affichent chacune l'icône 9×9 fournie par le créateur.
Le sprint exige à nouveau **plus de trois icônes de nourriture**, comme en
vanilla : acheter Faim puis manger permet de franchir ce seuil.

Les profils et mondes beta.003 se conservent. Voir
[le ticket et ses vérifications](docs/blocodex-beta004.md).
Export local : [Sanctuary-beta.004.mrpack](build/Sanctuary-beta.004.mrpack).

## beta.003 — créer son habitant et commencer la progression

Première fiche avant l'arrivée : skin, pseudo, bio et couleur personnelle.
Le Blocodex (B ou Échap) réunit la fiche, les améliorations, l'histoire et les
connaissances de blocs. Départ à **3 cœurs, 3 icônes de nourriture, 3 bulles** ;
les achats restent après la mort. **Noms des mobs** est la première aptitude,
avec les familles de 26.2 et des noms personnalisables par type côté serveur.
S'asseoir est disponible dès le début.

Tester dans un **nouveau monde Sanctuary**. L'adoption d'une partie existante
est explicite et ne touche pas au terrain. Voir les
[notes beta.003 et la configuration](docs/progression-beta003-release.md).
Export local d'essai : [`Sanctuary-beta.003.mrpack`](build/Sanctuary-beta.003.mrpack).
Le parcours de progression passe les essais natifs serveur et client ; la
suite générale conserve les deux échecs worldgen détaillés dans les notes.

## beta.002 — biomes boréaux, corail et temples

Les quatre îles de 512 blocs conservent leurs noms et positions. Au nord,
**la Veille de Noor** devient boréale : taïga, neige et biomes de glace partagent
les Peaks. À l’ouest, le bassin des **Eaux d’Ari** utilise l’océan chaud et sa
décoration de corail. Une pyramide du désert est réservée dans **la Faille de
Kai et Efe**, et un temple de la jungle dans **les Braises de Makena** ; leurs
emplacements dépendent de la graine et des terrains capables de les accueillir.

**Nouveau monde Sanctuary requis pour cette disposition.** Les sauvegardes
beta.001 restent sur leur génération. Voir [le contrat et les vérifications](docs/expeditions-beta002.md).
Export local d’essai : `build/Sanctuary-beta.002.mrpack`.

## beta.001 — les quatre anciennes expéditions

Le mod et le pack adoptent la même version : **`beta.001`**.
Chaque livraison suivante incrémente le compteur : `beta.002`,
`beta.003`, etc. Les tags reprennent la version exacte, sans `v`.
Voir [la convention et les vérifications](docs/versioning.md).

Un **nouveau monde Sanctuary** ouvre quatre îles de 512 blocs, témoins des
anciennes expéditions : **la Veille de Noor** au nord (glacial/Peaks), **les
Braises de Makena** à l’est (tropical/Volcan), **la Faille de Kai et Efe** au sud
(aride/Canyon) et **les Eaux d’Ari** à l’ouest (humide/Océan).

Les régions sont enregistrées ensemble dès la création ; leurs chunks se
génèrent à l’exploration. Le placement cherche la première position libre sur
l’axe demandé, avec les emprises de décoration et les bateaux protégés.
Le relief de l’île initiale reste celui de l’alpha.30.7. Les anciennes
sauvegardes gardent leur contrat et ne reçoivent pas ces îles automatiquement.
Voir [le contrat et les vérifications](docs/expeditions-beta001.md).

Les sources bêta sont disponibles dans Git jusqu’à beta.060 ; la dernière
release du canal packwiz reste l’alpha.30.7 ci-dessous. Les sections alpha
constituent l’historique.

## Alpha.30.7 — trésors aériens et vestiges asséchés

Le relief de 30.6 est conservé. Les nouveaux morceaux de terrain aérien reçoivent
les minerais et trésors des anciens îlots artificiels, retirés de la planification.
Les rails privilégient les lignes directes. Une seconde traversée souterraine et
quelques petites ruines océaniques asséchées sont cherchées lorsque le terrain
les accueille.

Voir [la génération](docs/generation-alpha30.7.md) et [les essais](docs/testing-alpha30.7.md).
**Nouveau monde requis.** [MRpack et release](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.30.7) ·
[Atlas scientifique](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.30.7/Sanctuary-Atlas-0.1.0-alpha.30.7.zip).

## Alpha.30.6 — village souterrain et voies ramifiées

La déformation du terrain 30.5 est légèrement renforcée. Un village vanilla
abandonné dispose d’une cavité locale adaptée ; les mines sont réservées à
l’avance et les donjons natifs disposent de davantage de tentatives. Les voies
abandonnées s’allongent et se ramifient entre les plateaux.
Deux nouveaux morceaux de terrain naturel sur Petit/Moyen, trois sur Grand,
occupent le ciel vers Y300–400. Le lieu envisagé à Y600 reste une idée future.

Voir [la génération](docs/generation-alpha30.6.md), [les essais](docs/testing-alpha30.6.md)
et [l’atlas scientifique](docs/terrain-atlas.md). **Nouveau monde requis.**

## Alpha.30.5 — plateaux et atlas du terrain

L’étirement vertical de la 30.4 est retiré. Les plateaux issus de la 24/27
reçoivent une déformation 3D modérée dans de larges zones ; aucune hauteur
sommitale n’est imposée. Grottes, rivières courbes, brèches de cascade et
infrastructures sont conservées. Le plafond constructible reste Y640.

La comparaison devient reproductible : cartes de relief, épaisseur rocheuse
et coupes de densité des quatre champs, aux mêmes coordonnées et graines.
Voir [le terrain](docs/generation-alpha30.5.md), [l’outil d’atlas](docs/terrain-atlas.md)
et [les vérifications](docs/testing-alpha30.5.md). **Nouveau monde requis.**

## Alpha.30.4 — massifs et ciel constructible

Les plateaux bas sont conservés ; les reliefs hauts se raccordent par des
abords plus larges, avec des falaises et des arches issues du bruit 3D. Des replats proches de Y360 peuvent accueillir des rivières courbes.
Le plafond de construction passe à **Y640** (dernier bloc : Y639), sans relever
l’île entière ni déplacer les nuages. Les trois tailles restent inchangées.

Créer un **nouveau monde**. Voir [le terrain](docs/generation-alpha30.4.md)
et [les vérifications](docs/testing-alpha30.4.md).

## Alpha.30.3 — plateaux et grands reliefs

La passe de petites corniches de la 30.2 est retirée après le retour en jeu.
De larges provinces de relief font cohabiter les plateaux naturels issus de la
24 et les montagnes déformées en 3D, jusqu’à proximité de Y360. Leur répartition
est proportionnée aux trois tailles. Les petits fragments détachés restent filtrés.

Créer un **nouveau monde**. Voir [la génération](docs/generation-alpha30.3.md)
et [les vérifications](docs/testing-alpha30.3.md).

## Alpha.30.1 — rivières courbes et relief global

Les rivières angulaires de la 30 sont retirées. Les anciens cours d’eau et
bassins peuvent déborder par une courte brèche dans leur berge. Le relief 3D
redevient global, avec une seule bande étroite de plateaux naturels pour
faciliter les accès aux traversées.

Créer un **nouveau monde**. Voir [le correctif](docs/generation-alpha30.1.md)
et [ses vérifications](docs/testing-alpha30.1.md).

## Alpha.30 — plateaux, rivières ouvertes et traversées

La déformation 3D se concentre dans trois grandes zones ; les plateaux naturels
reprennent leur place entre elles. Une rivière cherche un parcours à l’échelle
de l’île. Des brèches courtes dans ses berges et celles des bassins laissent
l’eau tomber sur les flancs ou dans le vide. Les traversées souterraines et
le placement du sanctuaire minéral sont renforcés ; les navires restaurés
restent proches des rivages.

Créer un **nouveau monde**. Voir [la génération](docs/generation-alpha30.md),
[les essais et leurs limites](docs/testing-alpha30.md) et [packwiz](docs/packwiz.md).
L’alpha.29 reste un point de reprise local non publié, intégré à cette livraison.
Le [MRpack alpha.30](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.30/Sanctuary-0.1.0-alpha.30.mrpack)
est publié ; le canal packwiz et l’instance Prism existante sur Mac sont
synchronisés. Les essais natifs et le rechargement sont validés sur Mac.


## Alpha.28 — grottes et lieux proches

Cette passe prolonge la 27 validée en jeu : bruits de grottes vanilla dans
la roche, failles moins traversantes, reliefs déplacés et affaissés par du bruit 3D,
bateaux près des berges et deux îlots au-dessus de Sanctuary. Les marais
occupent moins de place. Mines, huttes et donjons vanilla bénéficient de
contrôles adaptés aux cavités ; les filons suivent la profondeur de la masse
rocheuse, y compris dans les expansions.

Créer un **nouveau monde**. Voir le [périmètre](docs/generation-alpha28.md),
les [résultats effectivement vérifiés](docs/testing-alpha28.md) et la
[distribution](docs/packwiz.md).

## Alpha.27 — retour au terrain de la 24

La base est le commit `e7d1f29`, sans les massifs coniques, chambres creusées
et couches de planification de l’alpha.25. Les changements de relief seront
repris séparément après un essai visuel. L’alpha.26 est sautée à la demande
du créateur.

Les deux navires et les deux îlots restent présents, avec un seul îlot à
cascade. Les marais occupent des volumes de biomes dans les cavités existantes,
sans produire une nouvelle géométrie de grotte. Ce retour ne prétend pas
remplacer le creusement Sanctuary par l’ensemble du moteur de grottes vanilla.

Créer un **nouveau monde Sanctuary** ; tailles 512 / 724 / 1 024 et Moyen par
défaut conservés. Le codec de terrain reste `sanctuary:island_v24` dans ce
prototype alpha.27 ; la reprise des anciennes sauvegardes n’est pas un objectif.
La distribution et les vérifications effectuées sont détaillées dans
[les essais alpha.27](docs/testing-alpha27.md) et [packwiz](docs/packwiz.md).

## Alpha.24 — les lieux suspendus

La nouvelle génération `sanctuary:island_v24` ajoute une montgolfière, deux
navires marchands habités et deux îlots riches en minerais autour de Sanctuary.
Les îlots reçoivent de l’herbe, des fleurs et des petits arbres ; exactement
l’un des deux possède une cascade. Chaque lieu contient un coffre, enterré
dans les îlots. Il faut construire pour les atteindre et ramener les villageois.

Les cinq emplacements sont réservés dès la création du monde, même avant leur
exploration. Les expansions respectent ces réservations ; les anciennes
sauvegardes gardent leur génération. Créer un **nouveau monde Sanctuary** pour
les découvrir, avec les structures et l’option expérimentale activées.
Les tailles 512 / 724 / 1 024 et le bouton natif **Personnaliser** restent
inchangés. Voir [le contrat](docs/generation-alpha24.md) et
[les vérifications](docs/testing-alpha24.md). Les quatorze scénarios de génération,
les 24 GameTests généraux, `check build assemblePack` et le MRpack passent sur
Mac. Le [MRpack alpha.24](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.24/Sanctuary-0.1.0-alpha.24.mrpack)
est publié, le canal packwiz et la même instance Prism sont synchronisés. Les
925 fichiers personnels et réglages suivis sont conservés. Les essais sont
réalisés sur Mac ; aucun essai Windows natif n’est revendiqué.

## Alpha.23.1 — livraison locale vérifiée

Le [chantier de génération](docs/generation-alpha23.1.md) réunit le Blocodex, une
île initiale naturelle avec quelques secrets, le sanctuaire minéral, les océans
et le catalogue des structures vanilla. Chaque nouvelle expansion acceptée, avec
les structures activées, prévoit au moins une structure adaptée avant sa réservation.
Les familles absentes des régions entièrement vérifiées sont favorisées.

`check build`, `assemblePack`, les essais natifs et le MRpack passent sur Mac.
Voir les [vérifications et limites](docs/testing-alpha23.1.md). Créer un nouveau
monde Sanctuary pour `island_v23` ; les anciennes sauvegardes gardent leur génération.
La publication séparée de l’alpha.23.1 était bloquée par les identifiants Git.
Ce socle est désormais inclus dans l’alpha.24 publiée ci-dessus.

## Alpha.23 — Blocodex et socle commun de données, livraison locale

Le Blocodex fait partie de Sanctuary et s’ouvre avec **B**, touche modifiable
dans les contrôles. Son catalogue permet de rechercher et filtrer les blocs
inconnus, vus, minés, déjà possédés, jetés ou posés. Le stock actuellement porté
est affiché séparément de la possession passée. Aucun objet ni permission
opérateur n’est nécessaire.

La mémoire est personnelle et conservée côté serveur. Les compteurs de minage
et de jet viennent des statistiques Minecraft ; les observations et poses
commencent avec cette version. Les sauvegardes précédentes gardent leur terrain
et leur génération.

Le socle commun ajoute la distribution du terrain chargé par dimension et
chunk, ainsi que les quantités d’items dans les inventaires connectés, les
conteneurs chargés et au sol. La couverture et l’actualité accompagnent chaque
relevé ; les coffres dont le butin n’est pas encore généré restent intacts.
Les opérateurs disposent de `/sanctuary census`. Palettes de structures,
expansions et shop pourront réutiliser ces données côté serveur.

Des relevés par jour UTC des activités de minage, pose, ramassage, jet et
fabrication conservent des périodes de
l’histoire du serveur. Le [contrat Blocodex](docs/blocodex.md) précise les APIs,
la persistance et les exclusions. Shop, ballast, Backrooms et leurs règles de
progression restent à construire ; la direction narrative est conservée dans
la [cosmologie](docs/cosmologie.md). Le Blocodex initial est désormais inclus dans l’alpha.24 publiée sur le
canal packwiz. `check build assemblePack`, les 24 GameTests natifs et
le client graphique connecté passent ; voir [les essais alpha.23](docs/testing-alpha23.md).

La suite est en [conception](docs/structures-conception.md) :
départ naturel, quelques lieux isolés, fonctions reproductibles et donjon majeur
à définir. Ce cahier accompagne la poursuite des systèmes après la génération ;
l’alpha.24 est la livraison actuelle.

## Alpha.22 — trouver le bon terrain

La nouvelle génération préfère refuser une ville ou un bâtiment facultatif
qui ne trouve pas un emplacement adapté. Plus de ville forcée sur une réserve
artificielle ; moins de terrassement, des fondations proches de la roche et des
chemins qui suivent le relief. La grande traversée et la salle d’expansion sont
réservées en priorité et peuvent exister sans ville au-dessus. Les autres lieux
n’ont pas de quota garanti.

Créer un **nouveau monde Sanctuary** pour utiliser ces règles. Les tailles
512/724/1024 et le bouton natif **Personnaliser** restent inchangés ; les anciens
mondes conservent leurs générateurs. La vision retient désormais **Minecraft
comme archéologie d’un autre Minecraft** : chaque ruine témoigne d’une ancienne
solution, et de ceux qui l’ont construite puis ont disparu.

Les trois tailles natives, la réouverture, le cas expérimental OFF et la
compatibilité21 passent, ainsi que `check build assemblePack` et ses huit
GameTests généraux. Le [MRpack alpha.22](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.22/Sanctuary-0.1.0-alpha.22.mrpack)
est disponible, le canal packwiz et la même instance Prism sont synchronisés.
Les925 fichiers personnels et réglages suivis sont conservés. Voir
[la distribution](docs/packwiz.md).

## Alpha.21 — matériaux, quartiers et traversées

La ville revient à la pierre lisse, pierre, briques de pierre, andésite et chêne.
Le tuf accompagne surtout les chemins et les sous-sols. Les toits et ornements
sont raccordés à leurs appuis ; les pièces gardent leurs aménagements. La ville
recherche des petits quartiers séparés par du terrain naturel, avec des chemins
vers le cœur. Les lieux patrimoniaux recherchent davantage de raccords.

L’option expérimentale ajoute une recherche de galeries industrielles : chaussée
cinq blocs, deux trottoirs, salles et escaliers de surface. Les placements sur
pente sont assouplis et les destinations isolées sont prioritaires pour les chemins.
Créer un **nouveau monde Sanctuary** pour ce générateur21. Les anciens mondes
conservent leur génération. Les vérifications et coordonnées du
témoin sont consignées dans [les essais](docs/testing-alpha21.md).

Le [MRpack alpha.21](https://git.botsu.net/koka/sanctuary-beta/releases/download/v0.1.0-alpha.21/Sanctuary-0.1.0-alpha.21.mrpack)
est disponible. Le canal packwiz et la même instance Prism sont synchronisés ;
les 925 fichiers personnels et réglages suivis sont conservés. Les tests de
création/réouverture, le cas OFF et `check build assemblePack` passent.

## Alpha.20 — identité des bâtiments

La passe reprend les six bâtiments de ville, les quatorze infrastructures,
les parcs et les sous-sols. Bois de chêne et de bouleau, granit, diorite et tuf
identifient les usages ; biseaux, baies, corniches, portiques et verrières
donnent du relief aux volumes. Les routes reçoivent des bordures de briques
de tuf et des blocs ciselés. Les vitres et grilles se raccordent entre chunks.

Créer un **nouveau monde Sanctuary, Moyen, graine 0**, avec **Structures
expérimentales** activées pour retrouver le témoin. Les anciens mondes gardent
leur génération. Le bouton natif **Personnaliser** et ses trois tailles restent
identiques. Voir le [catalogue illustré](docs/architecture-alpha20.md) et les
[essais alpha.20](docs/testing-alpha20.md). `check build assemblePack`, les essais natifs et les artefacts sont vérifiés ;
la [release](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.20)
et le canal packwiz sont publiés. La même instance Prism est synchronisée
deux fois, avec 925 fichiers personnels et réglages suivis conservés.

## Alpha.19 — anciennes infrastructures

Le chantier ajoute une première passe des quatorze lieux du
[catalogue](docs/structures-audit.md), avec leurs accès, des petits butins vanilla
et des voies de fret ou chemins abandonnés entre destinations réelles.
L’option **Structures expérimentales** reste enregistrée à la création du monde.
La nouvelle génération garde les anciennes sauvegardes intactes. Aucun système
de progression, mailbox, caméra ou réacteur n’est activé.
Les trois tailles sont vérifiées en génération native ; création et réouverture
conservent les structures et les coffres. `check build assemblePack` passe.
Pour voir le grand fret : **Moyen, graine 0**, option activée ;
`/sanctuary structures` liste les entrées. Voir [les preuves et la carte](docs/testing-alpha19.md).
La [release alpha.19](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.19)
et le canal packwiz sont publiés. La même instance Prism est synchronisée deux
fois, avec 767 fichiers personnels et réglages suivis conservés.

## Alpha.17 — prototype des réseaux oubliés

La nouvelle génération expérimentale recherche trois petits réseaux sur l’île
initiale : mines et ateliers, salles étranges, installations techniques
abandonnées. Chaque réseau possède une entrée de surface et des salles reliées,
avec mobilier, outils vanilla et traces de travaux interrompus. Les continents
conservent leur génération urbaine sans recevoir ces réseaux supplémentaires.

Dans **Personnaliser**, l’option **Structures expérimentales** accompagne les
trois tailles habituelles. Elle est enregistrée avec chaque nouveau monde ;
elle permet de comparer un monde avec les nouveaux lieux et un autre avec le
socle urbain seul. La présence des réseaux dépend des emplacements admissibles
trouvés dans un budget borné. Les connexions entre familles restent à construire.

Le prototype demande un **nouveau monde**. Les mondes 16 et antérieurs gardent
leur génération. Revenir au binaire 16 ne permet pas d’ouvrir un monde 17 : les
mondes d’essai restent séparés. Voir [le contrat alpha.17](docs/testing-alpha17.md).
Le réacteur, la progression et les reliques restent prévus pour la suite.

`check build assemblePack`, création/réouverture et option désactivée passent.
Les empreintes natives de la génération 16 restent identiques aux témoins publiés.
La [release alpha.17](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.17)
et le canal packwiz sont publiés ; la même instance Prism est synchronisée deux
fois, avec 767 fichiers personnels et réglages suivis conservés. Pour voir les
trois réseaux, créer un monde **Moyen, graine 0**, option activée ;
`/locate structure sanctuary:forgotten_networks` indique une entrée de surface.

## Alpha.16 — Sanctuary habitée avant nous

Une ville compacte apparaît sur la nouvelle île de départ lorsque les structures
sont activées. Les étages varient leurs plans ; les sanitaires sont clos et les
lits adossés aux murs. Sous la ville, la génération recherche une piscine couverte
de **50 × 25 blocs**, des parkings de **3 à 8 plateformes**, une grande salle
sèche et des égouts qui s’ouvrent vers l’extérieur avec de vrais écoulements.
Chaque équipement dépend du relief et des appuis : les six îles testées ont une
ville, mais seules trois accueillent la grande piscine. Les continents conservent
leurs villes conditionnelles.

Créer un **nouveau monde Sanctuary** pour la génération 16. Les mondes publiés
jusqu’à l’alpha.15 gardent leur génération, y compris dans leurs futurs chunks.
Le bouton natif **Personnaliser** conserve Petit 512, Moyen 724 par défaut et
Grand 1 024. Le [protocole alpha.16](docs/testing-alpha16.md) donne les preuves,
les limites et les coordonnées du monde **Moyen, graine 0**, qui contient la
piscine, huit niveaux de parking, la salle et l’égout ouvert.

`check build assemblePack`, la création et la réouverture natives passent.
La compatibilité 15 est vérifiée contre les empreintes de la version publiée.
La [release alpha.16](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.16)
est disponible ; deux synchronisations de la même instance Prism conservent
les 767 fichiers personnels et réglages suivis.
Les futurs donjons formeront plusieurs réseaux parfois connectés, avec des
installations encore utilisables et des chantiers interrompus. Le réacteur,
les reliques et leurs récompenses restent à construire.

## Alpha.15 — ville compacte et réseaux

Les bâtiments de Lost City reçoivent des plans intérieurs détaillés : pièces,
portes, vestibules, couloirs, escaliers, chambres, cuisines et salles d’eau.
Les égouts relient des salles et équipements souterrains, avec garages, pool
rooms et accès depuis la surface. Les bâtiments se regroupent en une
petite ville compacte avec rues, carrefours et entrées reliés. Les ponts et
viaducs prolongent le réseau ; le terrain est dégagé dans l’emprise urbaine.
Une grande salle souterraine prépare la future machine d’expansion.

Le biome Lost City est conservé car il pilote réellement les biomes urbains
et leurs apparitions de zombies vanilla. La nouvelle génération **15** demande
un **nouveau monde Sanctuary** ; les mondes 12/13/14 gardent leur génération.
Les tailles et le bouton natif **Personnaliser** restent identiques. Le
[protocole alpha.15](docs/testing-alpha15.md) consigne les preuves et les limites. Les tests de création et de réouverture
passent, ainsi que `check build assemblePack`. La
[release alpha.15](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.15)
est publiée ; la même instance Prism est synchronisée deux fois, avec 767
fichiers personnels et réglages suivis conservés. Créer un **nouveau monde**,
y compris après le JAR d’essai anticipé15. La machine d’expansion et ses cartes
préremplies restent prévues pour un prochain ticket.

## Alpha.14 — Lost City

Lost City est un biome de quartiers contemporains abandonnés, composé par du
code Sanctuary original. Des poches urbaines peuvent apparaître sur l’île de
départ ; le profil d’expansion `lost_city` permet d’en rechercher dans les
nouveaux continents. Le relief et ses fondations décident des emplacements :
un quartier ou un type de bâtiment n’est pas garanti sur chaque île.

Les 17 types comprennent rues, ponts, quatre parcs (boisé, jardin, aire de jeux,
mémorial), places, marchés, parkings, excavations, piscines abandonnées,
immeubles d’appartements, hôtels, bibliothèques, restaurants avec cuisine,
casernes et halls. **Pierre, pierre lisse et briques de pierre** forment la
palette principale, avec des variantes fissurées ou moussues, du verre et
quelques détails de fer et de chêne noir. Les étages disposent d’escaliers et
les pièces d’aménagements propres à leur usage.

Les parkings souterrains, fouilles et piscines demandent une épaisseur de roche
vérifiée sur toute leur emprise. Les piscines ont un fond, des parois continues
et des marches ; les ponts enjambent de courtes failles entre deux berges
supportées. Les monstres naturels du biome sont des zombies vanilla, soumis
aux règles de lumière et de difficulté du jeu. Aucun spawner ou zombie spécial
n’est ajouté ; les variantes de zombies et la progression restent pour la bêta.

Créer un **nouveau monde Sanctuary** pour la génération 14. Le bouton natif
**Personnaliser** conserve Petit 512, Moyen 724 par défaut et Grand 1 024.
Les mondes 12/13 gardent leurs codecs, journaux, paramètres et chunks.

Dans un nouveau monde de génération 14, les outils opérateur acceptent des
expansions de 64, 128, 256, 512 ou 1 024 blocs. `quick` sans taille effectue un
tirage reproductible favorisant les petites îles. Les emplacements suivent des
secteurs directionnels autour du parent, avec séparation des emprises écrites.
La reprise éventuelle de chunks de vide déjà explorés exige un certificat
strict lié au journal et une réouverture du monde ; aucun terrain occupé n’est
admis dans ce mécanisme.

Le [contrat et protocole alpha.14](docs/testing-alpha14.md) précisent les
commandes, la protection des sauvegardes et les vérifications réussies :
`check build assemblePack`, création et réouverture des quartiers, reprise du
vide certifié et validation des artefacts de distribution.
La [release alpha.14](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.14),
le MRpack et le canal packwiz sont publiés. Deux installations isolées puis deux
synchronisations de la même instance Prism Mac passent ; les 713 fichiers
personnels et réglages suivis conservent leurs hashes. Aucun monde personnel
n’a été ouvert ou régénéré. La validation native Windows reste à effectuer.

## Alpha.13.1 — correctif des expansions sous Windows

Le journal d’expansion n’essaie plus d’ouvrir son dossier comme un fichier sous
Windows, ce qui provoquait `AccessDeniedException` et bloquait les expansions.
La synchronisation du fichier, son remplacement atomique et sa relecture restent
obligatoires. Le format du journal et la génération alpha.13 restent identiques.

Après installation du correctif, **rouvrir le même monde** : une réservation déjà
enregistrée est reprise après vérification du journal. Il ne faut pas supprimer
`sanctuary-world-v13` ni recréer le monde pour ce correctif. Voir le
[dépannage Windows](docs/alpha13-worldgen.md) et la [validation](docs/testing.md).

La [release alpha.13.1](https://git.botsu.net/koka/sanctuary-beta/releases/tag/v0.1.0-alpha.13.1)
et le canal packwiz sont publiés. Deux synchronisations isolées et deux
synchronisations de l’instance Mac existante passent ; les 713 fichiers personnels
et réglages suivis restent identiques. Aucun accès à l’instance Windows n’a eu lieu.

## Alpha.13 — un seul monde Sanctuary

À la création d’un **nouveau monde**, sélectionner **Sanctuary**, puis utiliser
le bouton natif **Personnaliser** pour choisir la taille de l’île :

| Taille | Diamètre nominal |
| --- | --- |
| Petit | 512 blocs |
| Moyen, par défaut | 724 blocs |
| Grand | 1 024 blocs |

**Terminé** conserve le choix ; **Annuler** revient sans l’appliquer. La hauteur
reste de 384 blocs. Ces tailles décrivent une emprise, sans promettre un nombre
de joueurs, une aire constructible ou un stock de minerais.

L’île reprend les forêts, le relief flottant et les plans d’eau complets du
générateur précédent : bassins, rivière, terrasses et cascades restent liés
aux possibilités naturelles du terrain. Les poches de cavités natives de Minecraft
du laboratoire rejoignent cette île. Les commandes opérateur
d’expansion, avec leur distance facultative et leur recherche d’emplacements
libres, sont accessibles dans ce même nouveau monde. Les déblocages par la
production et l’XP restent à construire.

Les anciens choix Petit/Grand et Laboratoire sont cachés à la création, tout
en restant chargeables avec leurs paramètres enregistrés. **Aucun monde
existant n’est converti ni régénéré.** Le [guide alpha.13](docs/alpha13-worldgen.md)
détaille la création, les expansions et la séparation des sauvegardes.

`check build assemblePack`, les tests client, les trois tailles et les scénarios
d’expansion/rechargement passent. Moyen atteint 63,66 secondes pour la création
puis 289 chunks FULL dans le test serveur de référence. Les preuves et leurs
limites sont dans [Validation](docs/testing.md).

À la livraison alpha.13, le canal packwiz, le MRpack et la même instance Prism
avaient été mis à jour, avec les 601 fichiers personnels et réglages alors suivis conservés.
Voir [Distribution](docs/packwiz.md).

## Socle livré jusqu’à l’alpha.8

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

Jusqu’à l’alpha.9, 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.

La génération alpha.8, `sanctuary:sanctuary_rift`, passe les contrôles moteur
sur les trois graines de référence, avec 1 800 ticks de fluides. Ces résultats
ne valident pas par avance l’incrément suivant. Les observations et leurs
limites figurent dans [Validation](docs/testing.md).

## Alpha.9, historique : cavités vivantes et terrasses d’eau

L’incrément ajoute des cavités luxuriantes et lumineuses sous l’île, des
secteurs à spéléothèmes, des géodes d’améthyste et des poches de soufre moins
envahissantes, avec de vrais geysers de soufre lorsque leurs conditions sont
réunies. Les forêts de surface sont conservées ; la recherche de lacs plus
profonds et volumineux accompagne des groupes facultatifs de bassins naturels
étagés. Leurs cascades relient les paliers et permettent de circuler par la nage.
L’image des « rizières » décrit ce paysage d’eau en terrasses : aucune culture
de riz n’est ajoutée.

**La validation moteur alpha.9 passe sur les trois graines de référence.**
Les preuves de terrasses, geysers et décor souterrain sont cumulées sur ces
trois mondes, sans imposer chaque élément à chacun. La version est publiée
et la même instance Prism est synchronisée ; voir [Distribution](docs/packwiz.md). Le
nouveau réglage `sanctuary:sanctuary_cavern` nécessite de créer un **nouveau
monde Sanctuary**. Les anciennes générations jusqu’à l’alpha.8 gardent leurs
paramètres ; aucune sauvegarde n’est régénérée. Les cavités restent dans
l’Overworld, sans créer la dimension des cavernes prévue par la vision.
Dappled Forest reste réservé aux futurs continents et présent dans les
anciennes sauvegardes alpha.5. Aucun lac, groupe de terrasses, geyser ou stock
de ressources n’est garanti sur chaque graine. Voir le ticket local
[WG-10](docs/backlog.md).

## Alpha.10, historique : îles pour 5, 20 ou 100 joueurs

L’alpha.10 proposait trois tailles, avec **20 joueurs par défaut**.
Leur aire nominale est proportionnelle à la capacité choisie, sur la base
de l’île de 512 blocs pour cinq joueurs. La hauteur reste de 384 blocs.

| Choix à la création | Identifiant du preset | Capacité | Diamètre nominal |
| --- | --- | --- | --- |
| Sanctuary 5 joueurs | `sanctuary:sanctuary_5` | 5 | 512 blocs |
| Sanctuary, choix par défaut | `sanctuary:sanctuary` | 20 | 1 024 blocs |
| Sanctuary 100 joueurs | `sanctuary:sanctuary_100` | 100 | Environ 2 290 blocs |

Ces capacités dimensionnent l’île ; elles ne fixent pas la limite de
connexions du serveur. Le contour réel dépend du relief et de la graine,
et le stock de ressources reste celui de la génération. La taille se choisit
pour un **nouveau monde** : aucune ancienne île n’est agrandie et aucune
sauvegarde n’est régénérée lors de la mise à jour.
Les paramètres sauvegardés sont distincts : `sanctuary:population_5`,
`sanctuary:population_20` et `sanctuary:population_100`.

**Les trois profils passent les onze tests moteur sur la graine `0`, avec
1 800 ticks réels de fluides.** Le choix de capacité persiste après écriture
et relecture sur disque. La vérification conserve 212 anciens fichiers de
production strictement identiques ; huit fichiers d’intégration ou d’interface
accueillent les nouveaux choix. La première planification locale reste coûteuse,
environ 83–88 secondes pour les premiers essais 5/20 sur cette configuration.
La génération en masse reste à optimiser. Ces essais ne simulent pas
100 connexions et ne donnent aucune garantie de performances multijoueurs.
Les diamètres nominaux ne permettent pas d’extrapoler les stocks ou l’aire
réellement habitable. La version est publiée et la même instance Prism a été
synchronisée deux fois, avec 363 fichiers personnels et réglages suivis conservés.
Voir [WG-11](docs/backlog.md), [Validation](docs/testing.md) et
[Distribution](docs/packwiz.md).

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](docs/expansion.md).

Les détails du terrain et de ses limites sont dans [Génération](docs/worldgen.md),
et la provenance dans [Audit 26.2](docs/migration-26.2.md).

## Alpha.11, historique : Petit, Grand et génération plus rapide

Les anciens formats sont trop grands et éloignent les constructions. Le
nouveau choix de départ se limite à **Petit** et **Grand**, avec **Grand par
défaut**. Petit garde un diamètre nominal de 512 blocs ; Grand mesure environ
724 blocs, soit deux fois l’aire nominale de Petit. La hauteur reste de
384 blocs. Les repères internes 5 et 10 servent au calcul de surface : ils
ne sont ni les noms des choix ni une promesse de capacité multijoueur.

Grand utilise le nouveau réglage `sanctuary:population_10`. Les anciennes
parties `population_5`, `population_20` et `population_100` gardent leurs
paramètres ; les formats 20/100 sont retirés des choix publics de création,
sans réduire les mondes déjà enregistrés. Aucun monde personnel n’est ouvert
pour les essais.

Le ticket [WG-12](docs/backlog.md) réduit les calculs répétés de terrain et
permet de lire un plan régional déjà prêt pendant le calcul du suivant.
À géométrie 20 identique, la création puis 289 chunks autour du spawn passent
de 407,43 à 62,54 secondes (−84,65 %) ; 80 chunks d’exploration passent de
103,14 à 14,05 secondes. Le nouveau Grand atteint 62,67 secondes sur le même
protocole de départ. Ces essais serveur sur une graine et une machine ne
mesurent pas le rendu du client ni une charge multijoueur.

`check build assemblePack` passe, ainsi que douze tests moteur pour chacun
des deux choix, avec 1 800 ticks de fluides. Plus de trois millions de
comparaisons de densité confirment l’équivalence de calcul. Les mesures et
limites sont dans [Validation](docs/testing.md) ; publication et synchronisation
de la même instance sont consignées dans [Distribution](docs/packwiz.md).
L’alpha.11 est publiée ; la même instance Prism a été synchronisée deux fois,
avec les 364 fichiers personnels et réglages suivis conservés.

## Alpha.12, historique — laboratoire d’expansion

Un troisième preset **Sanctuary — Laboratoire** permet de tester les expansions
dans un **nouveau monde**, sur la même version Minecraft. Les choix Petit et
Grand gardent leur génération alpha.11. Le laboratoire possède sa propre île
initiale de 512 blocs, avec un relief supérieur légèrement déformé et des biomes
vanilla. Les nouvelles îles choisissent séparément leur parent, direction,
climat, diamètre nominal (64/128/256/512) et relief (naturel, pics, canyon, volcan).

Avec les commandes autorisées ou le statut opérateur :

```text
/sanctuary expansion quick north autumn 128 peaks
/sanctuary expansion list
/sanctuary expansion visit island_1
/sanctuary expansion create oasis island_1 east arid 64 natural
```

Le premier exemple ouvre une forêt automnale au nord ; le second continent
part vers l’est depuis cette île. `quick north` seul emploie la convention froide,
avec 128 blocs et un relief naturel. `create` permet de choisir explicitement un
identifiant et un parent. `preview` propose l’emplacement sans l’activer ;
`resume <id>` reprend une réservation interrompue. L’autocomplétion liste les
directions, douze profils climatiques et quatre reliefs.

Les anciens chunks, même vides, sont refusés dans l’emprise d’une nouvelle île.
Le registre persiste côté serveur ; la préparation est progressive et la visite
attend un terrain prêt. Villages, temples, cabanes de marais et camps abandonnés
vanilla peuvent être retenus selon leur biome et leurs fondations. Les autres
structures, la grande hydrologie des continents, les recherches, les boîtes de
dépôt et le refuge Void restent des étapes suivantes. Un biome humide ne promet
pas encore un lagon ou un océan. Les règles, limites et essais figurent dans le
[guide du laboratoire](docs/alpha12-laboratory.md).

`check build assemblePack` et les essais d’expansion/rechargement de graine 42
passent. L’alpha.12, son MRpack et le canal packwiz sont publiés ; la même
instance Prism a été synchronisée deux fois, avec les 466 fichiers personnels
et réglages suivis conservés. Voir [Distribution](docs/packwiz.md).

## Alpha.12.1, historique — distance et emplacements libres

Le correctif ajoute une distance minimale facultative à la fin des commandes :

```text
/sanctuary expansion quick north autumn 128 peaks 2048
/sanctuary expansion create desert sanctuary east arid 128 natural 4096
```

La distance se mesure entre les centres depuis le parent choisi. Sans distance,
le placement reste automatique. Les emplacements déjà générés sont maintenant
écartés en cherchant plus loin dans la même direction, sans changer le climat
ni réécrire les chunks. Les mondes laboratoire alpha.12 peuvent être conservés :
le journal et la génération restent compatibles. Voir le [guide](docs/alpha12-laboratory.md).

`check build assemblePack`, les scénarios moteur et les tests de distance passent.
L’alpha.12.1 et son MRpack sont publiés ; la même instance Prism est synchronisée
deux fois, avec 466 fichiers personnels et réglages suivis conservés.

## 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 | beta.060 |

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](https://www.minecraft.net/en-us/article/minecraft-26-3-pre-release-2),
[Fabric](https://fabricmc.net/develop/),
[version Fabric API](https://modrinth.com/mod/fabric-api/version/o9uChmGq).

## Construire et lancer

```sh
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 par défaut le nouveau générateur unifié Sanctuary dans un monde
de développement neuf. Les suites historiques utilisent explicitement
`-PsanctuaryUnifiedTests=false`.
Les scénarios couverts et les essais multijoueurs restant à effectuer sont
décrits dans [Validation](docs/testing.md).

Résultats :

- `mods/sanctuary/build/libs/sanctuary-beta.060.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](packwiz/README.md).

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](docs/packwiz.md).

Lancer le client de développement :

```sh
./gradlew :sanctuary:runClient
```

Créer un **nouveau monde**, sélectionner le type **Sanctuary**, puis
**Personnaliser** pour changer la taille Moyen retenue par défaut.
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` :

```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 |
| `mods/sanctuary-test/` | Module facultatif pour tester sur monde plat sans cinématique |
| `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
requise ; Demeure et le port expérimental de JEI pour 26.3-pre-2 sont imbriqués
dans le JAR Sanctuary. Leurs sources ou leur procédure de reconstruction et
leurs attributions figurent dans `mods/demeure/` et `mods/jei/`.

## 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](CONTRIBUTING.md).

Le [backlog](docs/backlog.md) contient des tickets locaux, pas des issues déjà
publiées. La prochaine étape est une passe courte de vérification et de finition
des expansions, puis la progression en jeu, par petits incréments jouables.

## Licence et crédits

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