Adaptateurs et compatibilité
Exécutez /migrate adapters et /migrate compatibility sur le serveur avant chaque migration. Le tableau ci-dessous décrit Migrate 1.0.0 ; une version de plugin située hors de la plage attendue d'un adaptateur est signalée comme non vérifiée ou non prise en charge au lieu d'être acceptée en silence.
Capacités #
R = lecture, W = écriture, RB = annulation des enregistrements écrits par Migrate.
| Source ou cible | Homes | Warps | Économie | Sanctions | Stockage |
|---|---|---|---|---|---|
| EssentialsX | R W RB | R W RB | R W RB | — | Données utilisateur YAML, warps et table des utilisateurs |
| HuskHomes | R W RB | R W RB | — | — | SQLite uniquement |
| PlayerPoints | — | — | R W RB | — | SQLite uniquement |
| AdvancedBan | — | — | — | R W RB | MariaDB ou MySQL |
| LiteBans | — | — | — | R | MariaDB ou MySQL ; lecture seule |
| Listes de bannissement vanilla | — | — | — | R | banned-players.json et banned-ips.json ; lecture seule |
| Fichiers d'échange | R W RB | R W RB | R W RB | R W RB | Fichiers JSON Lines versionnés |
Tout adaptateur en lecture peut alimenter un adaptateur en écriture du même domaine. La lecture peut avoir lieu pendant que le plugin source fonctionne. L'écriture exige que le plugin cible soit désactivé et que le serveur soit redémarré, afin que l'état mis en cache du plugin ne puisse pas écraser les données migrées.
Versions vérifiées #
Les routes suivantes ont été testées avec de vraies données générées par les plugins ou par le serveur lors de la vérification de la 1.0.0 :
- EssentialsX 2.21.0 : homes et warps lus et écrits ; soldes lus.
- HuskHomes 4.9.10 et 4.11 : homes et warps via SQLite.
- PlayerPoints 3.3.5 : soldes via SQLite.
- AdvancedBan 2.3.0 : sanctions via MariaDB 11.8.9.
- LiteBans 2.18.7 : sanctions lues depuis MariaDB comme test de compatibilité en boîte noire.
- Listes de bannissement vanilla des joueurs et des IP de Paper 1.21.11.
- Fichiers d'échange pour les homes, les warps, l'économie et les sanctions.
LiteBans reste signalé comme non vérifié dans le plugin, car il est à code source fermé et la structure de sa base de données n'est pas un contrat de compatibilité public. Examinez attentivement sa simulation.
Stockages et sens non pris en charge #
- Les bases de données de sanctions H2 et HSQLDB.
- Le stockage distant MySQL, MariaDB ou PostgreSQL pour HuskHomes.
- Le stockage MySQL pour PlayerPoints.
- L'écriture dans LiteBans.
- La création de fichiers utilisateur EssentialsX pour des joueurs qui n'en ont pas déjà un.
Les adaptateurs refusent un stockage non pris en charge au lieu de tenter une conversion au mieux.
Notes sur les plateformes #
Migrate est compilé contre l'API Spigot 1.20.6 et a été exécuté sur Spigot, Paper, Purpur, CraftBukkit et Folia. Sur Folia, les routes qui exigent l'API active d'un autre plugin ou l'accès aux mondes sont désactivées ; les routes par fichier et par base de données restent disponibles. Fiez-vous toujours à la commande de compatibilité en direct du serveur que vous allez migrer.