Advanced Backups: sichern, prüfen und wiederherstellen
Mit FlammiCraft ausgelieferte Mod-Version: 3.26.0
English · Vollständige Betriebsreferenz
Dieses Handbuch beschreibt den aktuellen NeoForge-Fork für Minecraft 1.21.1. Die älteren Loader-Adapter und Zukunftspläne im ursprünglichen README sind nicht der maßgebliche Bedienablauf. Quell- und Fixture-Prüfungen ersetzen keine Wiederherstellungsprobe einer konkreten Welt.
Sicherungen einrichten
- In
advancedbackups-common.tomlZielpfad, Typ, Zeitplan, Aktivitätsbedingung und Aufbewahrung prüfen. Die erste erfolgreiche Migration übernimmt alte Properties-Dateien und erhält die Originale; danach ist TOML maßgeblich. - Das Ziel muss außerhalb der Welt liegen. Profilziele dürfen weder überlappen noch ineinander liegen, auch nicht über Pfad-Aliasse.
- ZIP sichert einen vollständigen Stand. Differential benötigt den vollständigen Ausgangspunkt und den gewählten Teilstand; Incremental benötigt die gesamte Elternkette bis zum gewünschten Stand.
- Mit
/backup reload-configübernehmen und die Bestätigung abwarten. Ungültige Konfiguration wird insgesamt abgelehnt. Während laufender Dateioperationen ist Reload gesperrt. - Als OP Stufe 2 oder berechtigter Einzelspieler-/LAN-Besitzer
/backup startausführen. Anschließend mit/backup statusund/backup historyden Abschluss prüfen.
Ein angenommener Auftrag ist noch keine fertige Sicherung. Die Phasen reichen von Speicherprüfung und Welt-Save über Dateiaufnahme bis Archivveröffentlichung, Verifikation und Aufbewahrung. Auch ein einzelner Save-Callback kann das Zeitbudget überschreiten.
Bei bestätigtem Platzmangel endet die Dateiaufnahme oder Archivierung sofort. Der unvollständige Lauf aktualisiert weder die Sicherungskette noch ihr Manifest.
Für eine Vollsicherung müssen neben den vorhandenen Archiven grob das Doppelte der ausgewählten Dateigröße sowie Reserve und Archiv-Overhead frei sein. Steht die Vollsicherung bereits fest, prüft Advanced Backups das anhand der Dateigrößen vor dem Kopieren. Wird aus einer Teilsicherung beim Erfassen eine Vollsicherung, zählt die Prüfung bereits zwischengespeicherte Daten mit ein.
Die reine Prozesssperre music_disc_maker/audio/.lock wird nicht aufgenommen. Music Disc Maker erzeugt sie beim Öffnen seines Audiospeichers erneut. Audiodateien und Besitzerdateien bleiben ausgewählt; andere gesperrte oder nicht lesbare Nutzdaten führen weiterhin zum Fehlschlag. Die Ausnahme ist kein allgemeiner Ausschluss von .lock-Dateien. Audio- und Besitzerdateien werden einzeln erfasst; eine atomare Gesamtsicherung paralleler Musikänderungen ist damit nicht zugesichert.
Profile und Überwachung
Die obersten Einstellungen bilden default; benannte Profile erben sie. Beispielsweise startet /backup start daily ein konfiguriertes Profil namens daily. /backup profile daily status und history zeigen dessen Zustand. Alle Aufträge teilen eine serielle Ausführung.
/backup snapshot Name erstellt einen von automatischer Löschung ausgenommenen Snapshot. /backup retention-plan zeigt die geplante Aufbewahrungsauswahl. Gewöhnliche Sicherungen können nach erfolgreicher Erstellung automatisch alte Archive entfernen; Elternketten und geschützte Punkte können das nominelle Speicherlimit überschreiten.
Bei Fehlern nicht nur den letzten Erfolgsstand ansehen: History und Job-ID zeigen auch ausgelassene Zeitpläne, Vorbereitung, Abbruch und SUCCESS_WITH_CLEANUP_ERROR. Letzteres bedeutet vorhandenes Archiv mit gescheiterter Nacharbeit. /backup staging liest Zwischenstände; cleanup-staging ist dagegen eine ausdrückliche Löschaktion.
Integrität prüfen
/backup verify Archivdatei full liest alle erforderlichen Archivmitglieder und prüft verfügbare CRC-/SHA-256-Daten. Die schnelle Prüfung ohne full kontrolliert Struktur und Elternbezüge, nicht jeden Nutzdateninhalt. Alte Archive können ohne gespeicherte SHA-256 vorliegen. Keine Variante repariert Archive oder authentifiziert sie gegen absichtliche Manipulation.
Neue .abchain-Archive enthalten auch Löschinformationen. Bewahre erforderliche Eltern auf und verwende das passende neue CLI; ältere Werkzeuge benötigen einen materialisierten ZIP-Export.
Ketten-IDs
Differenzial- und Inkrementalsicherungen tragen eine Ketten-ID im Dateinamen, zum Beispiel backup_2026-11-06_12-00-00-000-c7-full.abchain und die darauf aufbauenden …-c7-partial.abchain. Gleiche ID bedeutet gleiche Kette. Jede neue Vollsicherung beginnt eine neue ID, die nie wiederverwendet wird, auch nicht nach einem Neustart: Der zuletzt vergebene Wert steht in chain-id.txt neben manifest.json und wird zusätzlich mit den vorhandenen Dateinamen abgeglichen. Ist chain-id.txt unlesbar, wird keine neue Vollsicherung veröffentlicht, sondern ein Fehler gemeldet.
Sicherungen ohne ID aus älteren Versionen bleiben gültig. Sie werden weiter gefunden, wiederhergestellt und automatisch bereinigt; Teilsicherungen einer solchen Kette erhalten ebenfalls keine ID. Wiederherstellung und Bereinigung lehnen eine Teilsicherung ab, deren ID nicht zu ihrer Vollsicherung passt. /backup retention-plan nennt bei jedem Löschgrund die Kette. Unter unrestorable stehen Teilsicherungen samt Ketten-ID, die nach dem Entfernen ihrer Vollsicherung nicht mehr wiederherstellbar wären. Ältere Mod- und CLI-Versionen erkennen die neuen Namen nicht; für sie einen materialisierten ZIP-Export verwenden.
Einen Stand wiederherstellen
Server vollständig stoppen und Ziel, vollständige Kette, freien Platz und externe Sicherung prüfen. Mit dem passenden Mod-JAR kann Java im Offline-CLI arbeiten:
plan <archive> --target=<offline-world>für betroffene Dateien prüfen.- Bevorzugt mit
drill <archive> --target=<new-separate-directory>in ein neues separates Verzeichnis rekonstruieren und dort den Stand abnehmen. restore <archive> --target=<offline-world> --safety=<existing-external-directory>zeigt zunächst eine Vorschau.- Erst die Variante mit
--applyverändert das Ziel. Sie legt vorher eine vollständige externe Sicherheitskopie an; eine Wiederherstellung kann trotzdem nach Teiländerungen scheitern.
Die Sicherheitskopie enthält auch Dateien namens session.lock in Unterordnern, bevor diese entfernt oder ersetzt werden. Nur die Welt-Sperrdatei session.lock direkt im Weltverzeichnis bleibt erhalten und wird nicht mitkopiert.
Die Wiederherstellung ist keine atomare Welttransaktion. Bei Fehlern die gemeldeten Ziel- und Sicherheitspfade erhalten. Ein erfolgreicher Export beweist noch keinen erfolgreichen Spielstart. Die Referenz enthält CLI-Syntax, Teilbaum-Auswahl, Sperren und Rückweg.