Zum Hauptinhalt springen

Fehlende Zellinhalte gezielt löschen

Mit FlammiCraft ausgelieferte Mod-Version: 19.68.0

English

Berechtigungsstufe 2 ist erforderlich. Die globale Variante funktioniert auch aus der Serverkonsole und über berechtigte Remote-Serverbefehle. Dafür muss kein Spieler eine Zelle halten oder beim jeweiligen ME-Netz stehen.

Die gesamte Welt prüfen und bereinigen

  1. /ae2 missingcontent global inspect startet eine weltweite Vorschau.
  2. Warte auf die Abschlussmeldung. Während des Laufs erscheinen keine Fortschrittsmeldungen im Chat; am Ende kommt genau eine Statusmeldung: beendet, unvollständig bzw. abgebrochen oder nach einem Fehler gestoppt. /ae2 missingcontent global status zeigt den laufenden Stand auf Abfrage. Angezeigt werden geprüfte Datensätze, Zellinventare, gefundene und gelöschte Einträge sowie ungeklärte Datensätze. Höchstens 20 Beispiele mit ursprünglicher ID, Typ und Menge werden ausgegeben.
  3. /ae2 missingcontent global purge confirm startet einen neuen Lauf und löscht die zu diesem Zeitpunkt nachweislich fehlenden Inhalte. /ae2 missingcontent global purge startet nur eine Vorschau.
  4. /ae2 missingcontent global cancel beendet den Lauf nach bereits eingereihten Schreibvorgängen. Schon ausgeführte Änderungen werden nicht automatisch zurückgenommen.

Der Lauf umfasst alle aktuell registrierten Dimensionen, aktive und entladene Chunk- und Entity-Daten, Online-Inventare und Endertruhen sowie gespeicherte Offline-Spielerdateien. Zellen in Kisten und verschachtelten, im Item gespeicherten Inventaren werden mitgeprüft. TDAE2Additions ergänzt den zentralen Inhaltsspeicher von Sophisticated Backpacks; dadurch werden auch Taschen offline gespeicherter Spieler und verschachtelte Taschen erfasst. Andere extern verwaltete Inventare benötigen einen passenden Adapter.

Es werden vorhandene Region-Dateien gelesen; der Lauf erzeugt oder erzwingt keine neuen Chunks. Geladene Inventare werden über ihre regulären Setter aktualisiert, damit Speicher-Caches und Änderungsmeldungen erhalten bleiben. Bei gleichzeitigem Laden oder Entladen wird ein Datensatz zunächst zurückgestellt. Bleibt er ungeklärt oder lässt sich ein aktives Mod-Inventar nicht sicher ändern, meldet der Lauf einen unvollständigen Abschluss und behält diese Daten. Einzelheiten stehen im Serverlog. Nach Klärung kann ein neuer globaler Lauf erfolgen.

Bei geladenen Spielern und Entitäten prüft der Lauf zusätzlich deren gespeicherten Datensatz. Findet er dort fehlende Zellinhalte ohne passenden Inventarzugriff, zählt er die Treffer und meldet den Datensatz als ungeklärt. Für das gezielte Bereinigen ist ein Adapter für das betroffene Inventar erforderlich.

Leere Region-Dateien (0 Byte) gelten wie in Vanilla als Regionen ohne Chunks. Eine beschädigte oder abgeschnittene Region-Datei, deren Offset-Tabelle kürzer als 4 KiB ist, wird übersprungen; ebenso wird ein einzelner nicht lesbarer Chunk ausgelassen. Der Lauf geht mit den übrigen Dateien weiter und meldet am Ende ein unvollständiges Ergebnis mit der Zahl dieser Dateien und bis zu fünf Namen wie minecraft:the_nether region/r.-1.-100.mca. Das Serverlog nennt jede betroffene Datei einmal. An diesen Dateien wird nichts geschrieben oder repariert.

Vor jedem geänderten Datensatz wird dessen ursprünglicher Inhalt unter data/ae2_missing_content_backup/<lauf-id>/ im Weltverzeichnis gesichert. Der Befehl nennt diesen Pfad. Diese Sicherungen werden nicht automatisch gelöscht und nicht automatisch wiederhergestellt. Ein Fehler beendet weitere Änderungen; bereits abgeschlossene Änderungen bleiben bestehen. Die Vorschau schreibt keine bereinigten Inventare und legt keine solchen Sicherungen an.

Der Lauf prüft Daten schrittweise und friert die Welt nicht ein. Verschiebe währenddessen möglichst keine Zellen zwischen Inventaren. Eine Vorschau ist kein eingefrorener Weltzustand; der bestätigte Lauf prüft die dann vorhandenen Daten erneut. Dauer und Sicherungsumfang hängen vom Weltbestand und den tatsächlich betroffenen Datensätzen ab.

Eine einzelne gehaltene Zelle bereinigen

  1. Entnimm die betroffene Zelle aus ME Drive oder ME Chest. Schließe auch ein geöffnetes tragbares Zellmenü.
  2. Halte genau eine Zelle in der Haupthand und führe /ae2 missingcontent inspect aus.
  3. Prüfe die ursprünglichen Typen, IDs und Mengen. Mengen werden in ursprünglichen Speichereinheiten angezeigt, beispielsweise Millibuckets bei Fluiden. Der Bericht zeigt höchstens 20 Einzelzeilen; die Gesamtzahl enthält auch weitere Einträge.
  4. /ae2 missingcontent purge confirm löscht die nachweislich fehlenden Einträge endgültig aus der aktuell gehaltenen Zelle. Der Befehl prüft diese erneut; eine Vorschau reserviert keine Zelle.

/ae2 missingcontent und /ae2 missingcontent purge zeigen ebenfalls nur eine Vorschau. Eine Bestätigung als normaler Chattext löst nichts aus.

Gültige Inhalte, Registry-Aliasse, Zell-Upgrades und Einstellungen bleiben erhalten. Unbekannte Ressourcentypen, beschädigte Wiederherstellungsdaten und bloße Codec-Fehler werden nicht pauschal gelöscht. Nicht eindeutig zuordenbare Platzhalter bleiben erhalten und werden im Ergebnis mitgezählt. Werkzeuge mit internem Speicher werden nicht unterstützt.

AE2 erkennt fehlende Items und Fluide. Addons müssen weitere gespeicherte Schlüsseltypen über die API registrieren. TDAE2Additions ergänzt appmek:chemical, wenn Applied Mekanistics und Mekanism vorhanden sind. Ohne einen passenden Detector bleiben die Einträge erhalten.

API für Addons

appeng.api.storage.MissingContentCleanup.register(typeId, detector) registriert während des Common Setup genau einen Detector pro serialisierter AEKey-Typ-ID. Doppelte Registrierungen werden abgewiesen. AE2 enthält keine Mekanism-Abhängigkeit.

Der Detector erhält die ursprüngliche Registry-ID und eine Kopie der gespeicherten Schlüsseldaten. Er darf MISSING nur bei nachweislich fehlender Registry-ID zurückgeben; Aliasse müssen zuerst aufgelöst werden. PRESENT, UNKNOWN, fehlende Detectoren und Laufzeitfehler erhalten den Eintrag. classify prüft einen einzelnen Schlüssel; plan erstellt einen unveränderlichen Bereinigungsplan, ohne die Zelle zu ändern. Andere Aufrufer müssen Serverzuständigkeit, Zugriffsrechte und laufende Zell-Caches selbst berücksichtigen.

registerWorldStorage(id, server -> iterator) ergänzt extern verwaltete Inventare. Ein WorldInventory liefert eine Beschreibung und einen unveränderten NBT-Snapshot. Sein replace muss den neuen Inhalt auf dem Serverthread übernehmen, speichern und eigene Caches beziehungsweise offene Menüs aktualisieren. Der globale Lauf sichert den Snapshot vor dem Aufruf. Auch hier werden nur nachweislich fehlende Einträge aus erkannten Zellkomponenten entfernt; andere NBT-Felder bleiben erhalten.

Nach Installation passender Client-/Server-Versionen die Funktion mit einer getrennten Testzelle einschließlich Speichern und Neuladen prüfen. Automatisierte Tests ersetzen diese Abnahme nicht.