Konfiguration und Fehlerbehebung

config.yml behält Änderungen des Administrators. Fehlende Schlüssel verwenden die aktuellen Standardwerte, ohne die Datei umzuschreiben, während config.reference.yml bei jedem Start als vollständige Referenz neu erzeugt wird. Migrate lehnt Konfigurationen ab, die von einer neueren Plugin-Version erstellt wurden.

Wichtige Einstellungen #

migration.confirmation-timeout-seconds: erlaubte Zeit zwischen start und confirm.
migration.dry-run-validity-minutes: wie lange ein Probelauf-Ergebnis gültig bleibt.
migration.max-records: maximale Anzahl der Datensätze, die ein Plan akzeptiert.
performance.batch-size: Datensätze, die in einem Batch geschrieben werden.
performance.pause-between-batches-ms: Pause zwischen Batches; auf einem ausgelasteten Server erhöhen.
conflicts.defaults: Standardauflösung für jeden Konflikttyp.
world-mappings und currency-mappings: ausdrückliche Zuordnungen von Quelle zu Ziel.
identity.create-missing-players: erlaubt das Anlegen fehlender HuskHomes-Benutzerzeilen; standardmäßig deaktiviert.
connections.advancedban und connections.litebans: ausdrücklich konfigurierte MariaDB-/MySQL-Verbindungen.
compatibility.allow-unverified-versions: lässt neuere, nicht verifizierte Plugin-Versionen den strengeren Probelauf erreichen; deaktiviere es, um sie zu blockieren.

Die eigene Zustandsdatenbank von Migrate ist SQLite. Alternative Zustandsdatenbank-Optionen sind für 1.0.0 nicht verifiziert und erfordern, dass der passende JDBC-Treiber auf dem Server installiert ist.

Konfliktrichtlinien #

Der Probelauf zeigt jeden Konflikt und die Richtlinie, die angewendet wird. Sichere Standardwerte behalten vorhandene Zieldatensätze und überspringen ungültige oder nicht unterstützte Daten. Weitere zur Route passende Richtlinien sind OVERWRITE, RENAME, KEEP_NEWEST, KEEP_OLDEST, MANUAL und FAIL_MIGRATION.

text

/migrate conflicts MIG-20261008-0001
/migrate resolve MIG-20261008-0001 INVALID_WORLD SKIP
/migrate dryrun MIG-20261008-0001

Führe den Probelauf nach dem Ändern einer Richtlinie oder Zuordnung erneut aus.

Backups und Berichte #

Vor dem ersten Schreiben legt Migrate normalisierte Daten, Vorher-Abbilder des Ziels, erlaubte Quell-/Zieldatei-Kopien, die aktive Konfiguration und SHA-256-Prüfsummen unter plugins/Migrate/backups/<id>/ ab. Backups werden nie automatisch gelöscht.

Jede Migration schreibt JSON-, Text- und HTML-Berichte unter plugins/Migrate/reports/; übersprungene Datensätze erhalten zusätzlich einen CSV-Bericht. /migrate backups <id> verifiziert die gespeicherten Prüfsummen.

Sprachen #

Migrate enthält Englisch, Türkisch, Deutsch, Spanisch, Französisch, brasilianisches Portugiesisch, Polnisch, Russisch, vereinfachtes Chinesisch und Japanisch. Wähle eine mit /migrate language <locale> oder language.default. Fehlende Nachrichtenschlüssel greifen auf Englisch zurück.

Fehlerbehebung #

Meldung oder Zustand	Maßnahme
Der Probelauf ist zu alt	Führe `/migrate dryrun <id>` erneut aus.
Das Ziel-Plugin muss deaktiviert sein	Entferne oder deaktiviere das Ziel-Jar, starte den Server neu und beginne erneut.
Die Version ist nicht verifiziert	Prüfe die Warnungen des Probelaufs; deaktiviere `compatibility.allow-unverified-versions`, wenn solche Versionen blockiert werden sollen.
`connections.<plugin>` ist nicht gesetzt	Vervollständige diesen Verbindungsabschnitt und führe `/migrate reload` aus.
Eine andere Migration schreibt in das Ziel	Warte, bis sie fertig ist, oder prüfe `/migrate history`.
Die Konfiguration wurde nicht neu geladen	Korrigiere den in der Meldung genannten ungültigen Pfad; die vorherigen Einstellungen bleiben aktiv.
Die Migration wurde unterbrochen	Führe `/migrate inspect <id>` aus und wähle dann `resume` oder `rollback`.

Füge für den Support /migrate diagnostics, /migrate compatibility, /migrate adapters, den Textbericht der Migration und die relevanten Zeilen des Server-Logs bei. Entferne Passwörter und Serveradressen aus allem, was du teilst.