Überblick

Wartet auf Freigabe v1.0.0

Plattformen: Spigot, Paper, Purpur, CraftBukkit, Folia
Minecraft: Minecraft 1.20.6 oder neuer; getestet mit 1.20.6, 1.21.11 und 26.2
Java: 21
Erforderlich: Keine
Optional: EssentialsX, HuskHomes, PlayerPoints, AdvancedBan, LiteBans

Migrate überträgt Homes, Warps, Kontostände und Strafen zwischen unterstützten Minecraft-Plugins und hält dabei jeden Lauf nachvollziehbar und umkehrbar. Es erstellt einen Plan, führt einen schreibgeschützten Probelauf durch, legt ein verifiziertes Backup an, schreibt in Batches und liest das Ergebnis zurück, bevor es Erfolg meldet.

Voraussetzungen #

Spigot, Paper, Purpur oder Folia, Minecraft 1.20.6 oder neuer.
Java 21 oder neuer.
Zum bloßen Laden von Migrate ist kein Plugin nötig. Quell- und Ziel-Plugins hängen von der gewählten Migrationsroute ab.

Datenbereiche #

Bereich	Routenname	Übertragene Daten
Homes	`homes`	Besitzer, Name, Welt, Koordinaten, Yaw und Pitch
Warps	`warps`	Name, Welt, Koordinaten, Yaw und Pitch
Wirtschaft	`economy`	Spielerkontostand und Währung
Strafen	`punishments`	Bans, Mutes, Verwarnungen, Kicks und Notizen, einschließlich Datum, Aussteller und Grund

Migrate liest außerdem die Vanilla-Banlisten des Servers und unterstützt ein dokumentiertes JSON-Lines-Austauschformat für Übertragungen, die keinen direkten Adapter nutzen.

Installation #

Lege Migrate.jar in plugins/ und starte den Server.
Migrate erstellt plugins/Migrate/ mit Konfiguration, Sprachen, Importordner, Backups, Berichten und Zustandsdatenbank.
Führe /migrate compatibility und /migrate scan aus, bevor du eine Route vorbereitest.

Alle Befehle sind administrativ und standardmäßig Server-Operatoren vorbehalten. Migrate hat keine Update-Prüfung, keine Metriken und keinen sachfremden Netzwerkdienst. Es verbindet sich nur mit Datenbankservern, die du ausdrücklich für eine Route konfigurierst.

Sicherer Migrationsablauf #

text

/migrate scan
/migrate prepare essentialsx huskhomes homes
/migrate dryrun MIG-20261008-0001
/migrate start MIG-20261008-0001
/migrate confirm MIG-20261008-0001
/migrate status MIG-20261008-0001

scan erkennt unterstützte installierte Daten und schlägt Routen vor.
prepare liest die Quelle und erstellt einen Plan, ohne zu schreiben.
dryrun validiert den Plan, listet Konflikte auf und meldet, ob der Lauf sicher, sicher mit Warnungen oder blockiert ist.
start zeigt den genauen Schreib- und Rollback-Umfang. Es ändert trotzdem nichts.
confirm, innerhalb des konfigurierten Bestätigungsfensters eingegeben, erstellt das Backup und startet die Migration.
Migrate liest die geschriebenen Datensätze zurück und meldet die Verifizierung als bestanden, mit Warnungen bestanden oder fehlgeschlagen.

Ein Probelauf muss aktuell sein, bevor eine Migration starten darf. Das Ziel-Plugin muss deaktiviert sein, während Migrate schreibt, weil unterstützte Plugins ihre Daten zwischenspeichern. Erstelle zusätzlich zum routenspezifischen Backup von Migrate ein eigenes vollständiges Server-Backup.

Wiederherstellung und Rollback #

Migrate protokolliert den Fortschritt in migrate.db. Nach einer Unterbrechung wartet es auf einen Administrator; es setzt einen Schreibvorgang nie automatisch fort. Prüfe die Migration und wähle resume oder rollback. Resume gleicht einen abgebrochenen Batch mit dem Ziel ab, bevor erneut geschrieben wird, damit keine Datensätze doppelt entstehen.

text

/migrate inspect MIG-20261008-0001
/migrate rollback MIG-20261008-0001
/migrate rollback MIG-20261008-0001 confirm

Der Rollback ändert nur Datensätze, die diese Migration geschrieben hat. Ein später bearbeiteter Zieldatensatz bleibt unangetastet und wird gemeldet.

Datenschutz #

Datenbankpasswörter bleiben in config.yml und sind aus Berichten und Diagnosen ausgeschlossen. Migrationsberichte enthalten Angaben zu Route, Plan, Konflikten, Ergebnis, Verifizierung und Backup; prüfe jede Datei, bevor du sie öffentlich teilst.