Configuration et dépannage

config.yml conserve les modifications de l'administrateur. Les clés manquantes utilisent les valeurs par défaut actuelles sans réécrire le fichier, tandis que config.reference.yml est régénéré à chaque démarrage comme référence complète. Migrate refuse une configuration créée par une version plus récente du plugin.

Réglages importants #

migration.confirmation-timeout-seconds : délai autorisé entre start et confirm.
migration.dry-run-validity-minutes : durée pendant laquelle le résultat d'une simulation reste valide.
migration.max-records : nombre maximal d'enregistrements acceptés dans un plan.
performance.batch-size : nombre d'enregistrements écrits dans un lot.
performance.pause-between-batches-ms : pause entre les lots ; augmentez-la sur un serveur chargé.
conflicts.defaults : résolution par défaut pour chaque type de conflit.
world-mappings et currency-mappings : correspondances explicites entre source et cible.
identity.create-missing-players : autorise la création des lignes d'utilisateur HuskHomes manquantes ; désactivé par défaut.
connections.advancedban et connections.litebans : connexions MariaDB/MySQL configurées explicitement.
compatibility.allow-unverified-versions : permet à des versions de plugin plus récentes et non vérifiées d'atteindre la simulation plus stricte ; désactivez-le pour les bloquer.

La base de données d'état propre à Migrate est SQLite. Les autres options de base de données d'état ne sont pas vérifiées pour la 1.0.0 et exigent que le pilote JDBC correspondant soit installé sur le serveur.

Politiques de conflit #

La simulation affiche chaque conflit et la politique qui sera appliquée. Les valeurs par défaut sûres conservent les enregistrements cibles existants et ignorent les données invalides ou non prises en charge. Parmi les autres politiques adaptées à la route figurent OVERWRITE, RENAME, KEEP_NEWEST, KEEP_OLDEST, MANUAL et FAIL_MIGRATION.

text

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

Refaites la simulation après avoir modifié une politique ou une correspondance.

Sauvegardes et rapports #

Avant la première écriture, Migrate enregistre les données normalisées, les images antérieures de la cible, les copies autorisées des fichiers source et cible, la configuration active et les sommes de contrôle SHA-256 dans plugins/Migrate/backups/<id>/. Les sauvegardes ne sont jamais supprimées automatiquement.

Chaque migration écrit des rapports JSON, texte et HTML dans plugins/Migrate/reports/ ; les enregistrements ignorés reçoivent en plus un rapport CSV. /migrate backups <id> vérifie les sommes de contrôle enregistrées.

Langues #

Migrate inclut l'anglais, le turc, l'allemand, l'espagnol, le français, le portugais du Brésil, le polonais, le russe, le chinois simplifié et le japonais. Sélectionnez-en une avec /migrate language <locale> ou avec language.default. Les clés de message manquantes se rabattent sur l'anglais.

Dépannage #

Message ou situation	Action
La simulation est trop ancienne	Relancez `/migrate dryrun <id>`.
Le plugin cible doit être désactivé	Retirez ou désactivez le jar cible, redémarrez le serveur et recommencez.
La version n'est pas vérifiée	Examinez les avertissements de la simulation ; désactivez `compatibility.allow-unverified-versions` si ces versions doivent être bloquées.
`connections.<plugin>` n'est pas défini	Complétez cette section de connexion et exécutez `/migrate reload`.
Une autre migration écrit dans la cible	Attendez qu'elle se termine ou consultez `/migrate history`.
La configuration n'a pas été rechargée	Corrigez le chemin invalide exact indiqué dans le message ; les réglages précédents restent actifs.
La migration a été interrompue	Exécutez `/migrate inspect <id>`, puis choisissez `resume` ou `rollback`.

Pour l'assistance, joignez /migrate diagnostics, /migrate compatibility, /migrate adapters, le rapport texte de la migration et les lignes pertinentes du journal du serveur. Retirez les mots de passe et les adresses de serveur de tout ce que vous partagez.