Adapter und Kompatibilität
Führe vor jeder Migration /migrate adapters und /migrate compatibility auf dem Server aus. Die folgende Tabelle beschreibt Migrate 1.0.0; eine Plugin-Version außerhalb des erwarteten Bereichs eines Adapters wird als nicht verifiziert oder nicht unterstützt gemeldet, statt stillschweigend akzeptiert zu werden.
Fähigkeiten #
R = Lesen, W = Schreiben, RB = Rollback der von Migrate geschriebenen Datensätze.
| Quelle oder Ziel | Homes | Warps | Wirtschaft | Strafen | Speicher |
|---|---|---|---|---|---|
| EssentialsX | R W RB | R W RB | R W RB | — | YAML-Benutzerdaten, Warps und Benutzerzuordnung |
| HuskHomes | R W RB | R W RB | — | — | Nur SQLite |
| PlayerPoints | — | — | R W RB | — | Nur SQLite |
| AdvancedBan | — | — | — | R W RB | MariaDB oder MySQL |
| LiteBans | — | — | — | R | MariaDB oder MySQL; nur lesend |
| Vanilla-Banlisten | — | — | — | R | banned-players.json und banned-ips.json; nur lesend |
| Austauschdateien | R W RB | R W RB | R W RB | R W RB | Versionierte JSON-Lines-Dateien |
Jeder lesbare Adapter kann einen schreibbaren Adapter im selben Bereich speisen. Gelesen werden darf, während das Quell-Plugin läuft. Schreiben erfordert, dass das Ziel-Plugin deaktiviert und der Server neu gestartet wird, damit zwischengespeicherter Plugin-Zustand die migrierten Daten nicht überschreiben kann.
Verifizierte Versionen #
Die folgenden Routen wurden bei der Verifizierung von 1.0.0 mit echten, von Plugins oder vom Server erzeugten Daten geprüft:
- EssentialsX 2.21.0: Homes und Warps gelesen und geschrieben; Kontostände gelesen.
- HuskHomes 4.9.10 und 4.11: Homes und Warps über SQLite.
- PlayerPoints 3.3.5: Kontostände über SQLite.
- AdvancedBan 2.3.0: Strafen über MariaDB 11.8.9.
- LiteBans 2.18.7: Strafen aus MariaDB gelesen, als Black-Box-Kompatibilitätstest.
- Vanilla-Spieler- und IP-Banlisten von Paper 1.21.11.
- Austauschdateien für Homes, Warps, Wirtschaft und Strafen.
LiteBans bleibt im Plugin als nicht verifiziert gekennzeichnet, weil es Closed Source ist und sein Datenbanklayout kein öffentlicher Kompatibilitätsvertrag ist. Prüfe den zugehörigen Probelauf sorgfältig.
Nicht unterstützte Speicher und Richtungen #
- H2- und HSQLDB-Strafendatenbanken.
- Entfernter MySQL-, MariaDB- oder PostgreSQL-Speicher für HuskHomes.
- MySQL-Speicher für PlayerPoints.
- Schreiben in LiteBans.
- Erstellen von EssentialsX-Benutzerdateien für Spieler, die noch keine haben.
Die Adapter lehnen nicht unterstützten Speicher ab, statt eine Konvertierung nach bestem Bemühen zu versuchen.
Plattformhinweise #
Migrate ist gegen die Spigot-API 1.20.6 gebaut und wurde auf Spigot, Paper, Purpur, CraftBukkit und Folia ausgeführt. Auf Folia sind Routen deaktiviert, die die Live-API eines anderen Plugins oder Weltzugriff benötigen; Datei- und Datenbankrouten bleiben verfügbar. Verlasse dich immer auf den Live-Kompatibilitätsbefehl des Servers, den du migrieren willst.