Retroactive Import
Durch den rückwirkenden Import können Timeline-Chronikeinträge aus Spielerfortschrittsdateien in vorhandenen Welten aufgefüllt werden.
TLDR
- Wird einmal beim Serverstart ausgeführt (sofern aktiviert).
- Scannt
world/advancements/*.json. - Importe abgeschlossen, sichtbare Weiterentwicklungen noch nicht vorhanden.
- Kann optional Rezepterweiterungen enthalten.
Wie es funktioniert
Beim Serverstart:
- Die Timeline sucht nach JSON-Dateien zur Player-Fortschrittung.
- Für jede Spielerdatei werden die abgeschlossenen Kriterien überprüft.
- Es löst passende anzeigbare Fortschritte aus.
- Es schreibt importierte Ereignisse in Chronicle SavedData.
- Es werden aktualisierte Chronicle + Hall of Fame übertragen, wenn etwas importiert wurde.
Doppelte Sicherheit
Der Import ist idempotent gemäß (playerUuid, sourceId):
- Wenn das Paar bereits in den Chronicle-Daten vorhanden ist, wird es übersprungen
- Wiederholte Startvorgänge duplizieren nicht ständig dieselben historischen Einträge
Tageszuordnungsmodi
retroactiveAdvancementImportMapByRealDays steuert die Datumsplatzierung:
true: Ordnet das Fertigstellungsalter der Wanduhr dem Tagesversatz der Zeitachse zufalse: platziert importierte Einträge am aktuellen Timeline-Tag
Rezepthandhabung
retroactiveAdvancementImportIncludeRecipes:
false(empfohlen): ignoriertnamespace:recipes/*true: Enthält Rezeptverbesserungen, die viel Lärm verursachen können
DEEP DIVE: Fallback für Abschlusszeitstempel
Die Zeitleiste versucht, die Fertigstellungszeit anhand von Kriterienanforderungsgruppen zu berechnen. Wenn kein robuster Zeitstempel abgeleitet werden kann, wird für eine sicherere Importkontinuität auf die Dateiänderungszeit zurückgegriffen.
Der rückwirkende Import ist eine Startup-Pipeline. Während der Laufzeit werden Weiterentwicklungsdateien nicht kontinuierlich überwacht.
Dieses Projekt unterstutzen
Gefallt dir dieses Wiki und diese Mods?
Jede Unterstutzung hilft mir, neue Features zu bauen, Dokus zu schreiben und Updates zu liefern.