Zum Hauptinhalt springen

Upgrade-Karten und Migration

Mit FlammiCraft ausgelieferte Mod-Version: 0.4.0

English

Basic und Advanced Package Distributor sowie beide Kinetic Pattern Provider verwenden im lokalen Fork seit Version 0.2.0 ein gemeinsames Inventar mit vier Kartenplätzen. Die im Maschinenmenü sichtbaren Plätze und das Einlegen per Schleich-Rechtsklick greifen auf dieselben Karten zu. Die Basic- Variante akzeptiert weiterhin keine Parallel-Karten. Die anderen Varianten behalten das Limit von zwei Parallel-Karten und ihre bisherigen Jobgrenzen.

Die bekannten Inventarfelder von Applied Flux und ExtendedAE Plus verweisen ebenfalls auf dieses Inventar. Ihre eigenen Funktionsleser und Änderungsrückrufe bleiben angebunden, darunter Induktionskarten-Abfragen, Capability-Aktualisierung und Plus-Kartenstatus. Die bekannten Addon-Karten erhalten die für einen normalen AE2 Pattern Provider registrierten Limits, soweit für diese Maschine noch kein eigenes Limit existiert. Ein Kartenplatz allein macht eine vom Addon oder vom Craftingpfad nicht unterstützte Kartenfunktion nicht verfügbar.

Automatische Übernahme vorhandener Karten

Beim Laden werden die tatsächlich gespeicherten alten Einträge aus upgrades und gegebenenfalls compat_upgrades in den gemeinsamen Speicher übernommen. Der alte Schlüssel upgrades wurde sowohl vom Host als auch von Applied Flux benutzt. Er wird deshalb genau einmal gelesen. Getrennt gespeicherte Karten bleiben auch dann getrennt erhalten, wenn ihre Inhalte identisch sind.

Der neue Schlüssel createpackage_upgrades ist nach der Migration maßgeblich. Weitere Speicher- und Ladevorgänge lesen keine alten Kopien zusätzlich ein. Kartenkomponenten wie gebundene Besitzer oder Kanäle bleiben erhalten. Routen, Patterns, wartende Materialien und laufende Crafting-Jobs ändern ihr Format nicht. Bereits vor diesem Update überschriebene und nicht mehr gespeicherte Karten können aus einem Save allein nicht rekonstruiert werden.

Zurückgehaltene Einträge

Der Tooltip des Upgrade-Panels meldet zurückgehaltene Einträge. Es gibt zwei Fälle:

  • Lesbare Karten, die nicht in die vier Plätze passen, bleiben gespeichert. Beim normalen Abbau mit einem geeigneten Werkzeug werden sie als Karten mitgegeben.
  • Ist eine Karte oder eine ihrer Komponenten wegen eines fehlenden Addons nicht lesbar, bleiben ihre ursprünglichen Daten unverändert gespeichert. Beim Abbau wandern diese Daten in das fallengelassene Blockitem, dessen Tooltip darauf hinweist. Stelle die fehlende Mod wieder her und platziere den Block erneut; dann versucht er, diese Karten wieder in freie Plätze aufzunehmen.

Ein fehlendes Addon kann seine Kartenfunktion erst nach seiner Wiederherstellung bereitstellen. Das Entfernen eines Addons ist keine allgemeine Freigabe zur Migration anderer Weltdaten. Bewahre Blockitems mit zurückgehaltenen Daten auf. Die normalen Upgrade-Karten werden beim Abbau genau einmal zurückgegeben, auch wenn mehrere Addon-Hooks denselben Speicher betrachten.

Rückweg und Prüfung

Verwende auf Client und Server denselben Build. Für einen Downgrade auf den alten Inventarcode zuerst alle Karten einschließlich zurückgehaltener Daten mit dem neuen Build bergen. Die alte Version kennt den neuen Speicher und die Recovery- Komponente nicht. Ist das nicht möglich, verwende eine passende Weltsicherung; ein bloßer JAR-Tausch stellt den alten Zustand nicht wieder her. Leere vor einem Downgrade außerdem alle Musterplätze und Seiten, auf die die Zielversion keinen Zugriff hat.

Automatisierte Prüfungen decken Übernahme, Komponenten, wiederholtes Laden, Kartenlimits, direkte Feldleser und Callback-Verbindung, doppelte Drop-Hooks, Überlauf und die rohe Recovery bei fehlenden Addons ab. Die ABI-Prüfung erfolgte gegen Applied Flux 2.1.4 und die installierte 2.1.7 sowie ExtendedAE Plus 1.5.4.1. Das ist kein Ingame-Nachweis. Manuell zu prüfen bleiben Menü und Schleich-Einlegen, Kartenwirkung, Abbau/Platzieren und Weltneuladen mit den tatsächlich verwendeten Addon-Mixins, jeweils mit und ohne die optionalen Addons.