Présentation

En attente d'approbation v1.0.0

Plateformes: Spigot, Paper, Purpur, CraftBukkit, Folia
Minecraft: Minecraft 1.20.6 ou version ultérieure ; testé sur 1.20.6, 1.21.11 et 26.2
Java: 21
Requis: Aucun
Facultatif: EssentialsX, HuskHomes, PlayerPoints, AdvancedBan, LiteBans

Migrate déplace les homes, les warps, les soldes et les sanctions entre des plugins Minecraft pris en charge, tout en gardant chaque exécution vérifiable et réversible. Il prépare un plan, effectue une simulation en lecture seule, crée une sauvegarde vérifiée, écrit par lots et relit le résultat avant de signaler le succès.

Prérequis #

Spigot, Paper, Purpur ou Folia, Minecraft 1.20.6 ou plus récent.
Java 21 ou plus récent.
Aucun plugin n'est nécessaire pour simplement charger Migrate. Les plugins source et cible dépendent de la route de migration que vous choisissez.

Domaines de données #

Domaine	Nom de la route	Données déplacées
Homes	`homes`	Propriétaire, nom, monde, coordonnées, yaw et pitch
Warps	`warps`	Nom, monde, coordonnées, yaw et pitch
Économie	`economy`	Solde du joueur et devise
Sanctions	`punishments`	Bannissements, mutes, avertissements, expulsions et notes, avec dates, émetteur et motif

Migrate lit aussi les listes de bannissement vanilla du serveur et prend en charge un format d'échange JSON Lines documenté pour les transferts qui n'utilisent pas d'adaptateur direct.

Installation #

Placez Migrate.jar dans plugins/ et démarrez le serveur.
Migrate crée plugins/Migrate/ avec sa configuration, ses langues, le dossier d'import, les sauvegardes, les rapports et la base de données d'état.
Exécutez /migrate compatibility et /migrate scan avant de préparer une route.

Toutes les commandes sont d'administration et réservées par défaut aux opérateurs du serveur. Migrate n'a ni vérificateur de mises à jour, ni métriques, ni service réseau sans rapport avec sa fonction. Il ne se connecte qu'aux serveurs de bases de données que vous configurez explicitement pour une route.

Procédure de migration sûre #

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 détecte les données prises en charge installées et propose des routes.
prepare lit la source et crée un plan sans rien écrire.
dryrun valide le plan, liste les conflits et indique si l'exécution est sûre, sûre avec avertissements ou bloquée.
start affiche exactement la portée de l'écriture et de l'annulation. Il ne modifie encore rien.
confirm, saisi dans le délai de confirmation configuré, crée la sauvegarde et lance la migration.
Migrate relit les enregistrements écrits et signale la vérification comme réussie, réussie avec avertissements ou échouée.

Une simulation doit être récente pour qu'une migration puisse démarrer. Le plugin cible doit être désactivé pendant que Migrate écrit, car les plugins pris en charge mettent leurs données en cache. Conservez votre propre sauvegarde complète du serveur en plus de la sauvegarde propre à la route de Migrate.

Récupération et annulation #

Migrate journalise la progression dans migrate.db. Après une interruption, il attend un administrateur ; il ne reprend jamais une écriture automatiquement. Inspectez la migration et choisissez resume ou rollback. Resume compare un lot interrompu avec la cible avant de réécrire, afin que les enregistrements ne soient pas dupliqués.

text

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

L'annulation ne modifie que les enregistrements écrits par cette migration. Un enregistrement cible modifié après coup est laissé intact et signalé.

Confidentialité #

Les mots de passe des bases de données restent dans config.yml et sont exclus des rapports et des diagnostics. Les rapports de migration contiennent des informations sur la route, le plan, les conflits, le résultat, la vérification et les sauvegardes ; relisez chaque fichier avant de le partager publiquement.