# beta.003 — contrat de progression et d'activation

Ticket PROG-01, autorisé le 13 septembre 2026. Ce contrat précède les changements
de sauvegarde ; il ne modifie aucun générateur ni aucune expansion.

## Activation

Les nouveaux mondes utilisant le générateur Sanctuary activent la progression.
Les mondes possédant déjà des données de joueurs et aucun registre beta.003
conservent leur fonctionnement. Pour les adopter explicitement : sauvegarder
le monde, arrêter le serveur, puis mettre `enableExistingWorlds` à `true` dans
`config/sanctuary/progression.json`. Au prochain démarrage, chaque joueur crée
sa fiche et reçoit les capacités initiales 3/3/3 ; inventaire, XP, statistiques,
advancements et terrain sont conservés. La santé, nourriture et respiration
courantes sont ramenées aux nouvelles capacités. Aucun import automatique des
sauvegardes de 26.2. Les mondes vanilla ne sont pas activés.

## Données additives

`data/sanctuary-inhabitants.json` conserve un registre versionné des identités,
la graine de palette, les attributions RGB et la première arrivée. L'UUID
authentifié est l'identité ; le client ne choisit ni UUID ni pseudo de compte.
La création est validée pendant la configuration réseau, avant l'entrée en jeu.
La sélection d'une couleur est revalidée au moment de l'enregistrement.

L'attachement Fabric `sanctuary:progression` du joueur conserve une enveloppe
versionnée : rangs, aptitude Noms et journal des achats. Il est enregistré dans
le même fichier joueur que l'XP et copié lors d'une mort. Les achats retirent
les niveaux et mettent à jour l'attachement sur le thread serveur, avec un
numéro de révision empêchant la répétition d'une même requête. La sauvegarde
vanilla persiste ensemble le solde et le résultat. Un arrêt brutal peut perdre
les actions depuis la dernière sauvegarde, comme les autres données Minecraft.
Le registre d'identités est écrit atomiquement et relu ; un registre invalide
ou modifié extérieurement bloque la progression et n'est pas réinitialisé.

Les sept améliorations de chaque capacité coûtent provisoirement
`1, 2, 4, 8, 16, 32, 64` niveaux. Noms coûte provisoirement 4 niveaux.
Ces prix sont configurables côté serveur. S'asseoir est disponible dès le début.
La mort laisse par défaut 70 % des points d'XP disponibles en orbes vanilla,
soit 6 069 points pour un joueur au niveau 60 sans fraction de barre (environ
52 niveaux récupérés depuis zéro). `deathXpFraction` accepte 0 à 1.
`keepInventory=true` conserve l'XP sans créer d'orbes supplémentaires.
Le prestige et le New Game Plus ne sont pas introduits dans ce lot.

## Noms des créatures

Les familles et la sélection déterministe par UUID proviennent du code Sanctuary
26.2. `config/sanctuary/mob-names.json` ajoute des noms par identifiant de type
d'entité, avec activation globale et choix d'ajouter ou remplacer les noms
par défaut pour chaque type. Une étiquette nommée par un joueur reste prioritaire.
Le nom est une révélation personnelle de la créature visée, sans renommer
l'entité dans la sauvegarde. Changer les listes peut changer les noms calculés.

Les faits d'arrivée et d'achat sont datés en UTC, rattachés à l'UUID dans le
registre ou le fichier joueur. Leur future projection commune utilisera
`sanctuary:inhabitant_created` et `sanctuary:progression_purchased`. Cette
projection, l'export Web et la timeline publique restent un autre ticket.

## Retour arrière

Restaurer la sauvegarde préalable est la méthode pour annuler une adoption.
Ne pas supprimer seulement le registre : les capacités et achats des joueurs
font partie du même contrat. Garder une copie avant de charger avec un ancien
mod susceptible d'ignorer les attachements. Les fichiers invalides sont à
réparer hors ligne ; aucun outil ne les écrase pour recommencer silencieusement.