Timeline

Retroactive Import

L'importation rétroactive permet à Timeline de remplir les entrées de Chronique à partir des fichiers d'avancement des joueurs dans les mondes existants.

TLDR
  • S'exécute une fois au démarrage du serveur (lorsque activé).
  • Scanne world/advancements/*.json.
  • Importations terminées, avancées visibles non déjà présentes.
  • Peut éventuellement inclure des avancées de recettes.

Comment ça marche

Au démarrage du serveur :

  1. Timeline localise les fichiers JSON d'avancement du lecteur.
  2. Pour chaque fichier de joueur, il vérifie les critères complétés.
  3. Il résout les avancées affichables correspondantes.
  4. Il écrit les événements importés dans Chronicle SavedData.
  5. Il diffuse la Chronique mise à jour + le Temple de la renommée si quelque chose a été importé.

Sécurité des doublons

L'importation est idempotente selon (playerUuid, sourceId) :

  • si la paire existe déjà dans les données Chronicle, elle est ignorée
  • les démarrages répétés ne dupliquent pas les mêmes entrées historiques

Modes de cartographie du jour

retroactiveAdvancementImportMapByRealDays contrôle le placement de la date :

  • true : mappe l'âge d'achèvement de l'horloge murale au décalage du jour de la chronologie
  • false : place les entrées importées le jour actuel de la chronologie

Gestion des recettes

retroactiveAdvancementImportIncludeRecipes :

  • false (recommandé) : ignore namespace:recipes/*
  • true : inclut des avancées dans les recettes, ce qui peut ajouter beaucoup de bruit
DEEP DIVE : repli de l'horodatage d'achèvement

Timeline essaie de calculer le temps d’achèvement à partir des groupes d’exigences de critères. Si un horodatage robuste ne peut pas être dérivé, il revient à l'heure de modification du fichier pour une continuité d'importation plus sûre.

Phase d'exécution

L'importation rétroactive est un pipeline de démarrage. Il ne surveille pas en permanence les fichiers d'avancement pendant l'exécution.

Soutenir ce projet

Vous aimez ce wiki et ces mods ?

Chaque soutien m'aide a continuer a creer des fonctionnalites, ecrire la documentation et publier des mises a jour.

Retour en haut