Skip to main content

Migration von v1-legacy zu v2

GWorld v2 verfügt über intelligente Migrations-Systeme, die den Übergang von älteren Versionen oder den Wechsel zwischen Speichermedien (Dateien zu Datenbank) so einfach wie möglich gestalten.


Migration von GWorld v1 zu v2

Wenn du von der ersten Version von GWorld auf v2 aktualisierst, erkennt das Plugin dies automatisch beim ersten Start.

Funktionsweise

    Erkennung: Das Plugin sucht nach einer existierenden worlds.yml, in der...
      das Feld ConfigVersion fehlt die Liste LoadWorlds existiert die Liste Worlds existiert Automatisches Backup: Bevor Änderungen an den Datenbeständen vorgenommen werden, benennt GWorld die alte Datei in worlds_legacy_backup.yml um. Daten-Konvertierung: Der LegacyMigrator liest alle alten Welten-Definitionen aus und überführt sie in das neue, strukturierte v2-Format. Fehlende neue Felder werden mit Standardwerten (Defaults) aufgefüllt. Seed-Reparatur: Da in der v1 keine Seeds abgespeichert wurden, erkennt GWorld v2 fehlende Seeds beim ersten Laden der Welt automatisch und liest den korrekten Seed aus den Welt-Dateien aus und korrigiert den Eintrag.

      Hinweis: Während der Migration wird die Konsole dich über den Fortschritt informieren. Sobald die Datei worlds.yml eine ConfigVersion: 1 enthält, ist der Prozess abgeschlossen. Dies wird ebenfalls in der Konsole ausgegeben.

      Sicherheitsmaßnahmen & Voraussetzungen

      Um eine reibungslose Migration zu gewährleisten, beachte bitte folgende Punkte:

      Voraussetzungen (siehe Einführung)

        Java-Version: GWorld v2 benötigt zwingend mindestens Java 21, da moderne Sprachfeatures verwendet werden.

        Checkliste

          Erstelle vor dem Upgrade ein manuelles Backup deines gesamten Plugin-Ordners. Prüfe nach der Migration mit dem Befehl /gworlds, ob alle Welten korrekt gelistet werden. Kontrolliere die Server-Konsole auf Fehlermeldungen während des ersten Starts.

          Diese Dokumentation bezieht sich auf GWorld Version 2.0.0.