66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
# 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.
|