Documentation
Bien démarrer

Migration

Récupérez en quelques clics les soldes, homes, warps, kits, grades et sanctions de vos anciens plugins dans InglisCore.

Passer à InglisCore ne veut pas dire repartir de zéro. La page Importer de l'éditeur web repère les plugins que vous utilisiez, vous montre précisément ce qui sera importé, puis copie les données en arrière-plan pendant que le serveur continue de tourner.

Remarque

Les fichiers de vos anciens plugins sont seulement lus, jamais modifiés. Relancer un import ne crée jamais de doublons.

Plugins pris en charge

Plugin Ce qui peut être importé
EssentialsX Soldes, homes, warps, spawn, kits, prisons, surnoms
CMI Soldes
LuckPerms Grades (groupes), grades des joueurs et permissions
LiteBans Sanctions
AdvancedBan Sanctions
Vault Soldes de tout autre plugin d'économie encore actif

Les joueurs trouvés dans ces plugins (pseudo, première et dernière connexion) sont aussi ajoutés, pour que leur historique soit prêt dès le premier jour.

Chaque type de données va dans un module, et ce module doit être activé pour les recevoir : les soldes vont dans économie, les homes, warps et le spawn dans téléportation, les kits dans kits, les prisons dans modération, les surnoms dans identité, les grades et permissions dans grades, les sanctions dans sanctions. Si un module est désactivé, l'éditeur affiche Activez d'abord ... à côté de la ligne concernée.

Remarques sur le stockage

  • EssentialsX est lu directement depuis ses données : le plugin n'a même plus besoin d'être installé.
  • Les soldes de CMI sont lus depuis son stockage SQLite.
  • LuckPerms est lu directement quand il stocke ses données en YAML, JSON, SQLite, MySQL ou MariaDB. Pour les autres types de stockage (H2, celui par défaut de LuckPerms, ou MongoDB), gardez LuckPerms installé et actif pendant l'analyse, ou lancez d'abord /lp export : InglisCore lit alors le dernier export.
  • LiteBans doit utiliser SQLite, MySQL ou MariaDB. Son stockage H2 ne peut pas être lu.
  • AdvancedBan doit utiliser MySQL. Sa base de données intégrée sous forme de fichiers ne peut pas être lue : passez AdvancedBan sur MySQL, redémarrez une fois, puis relancez l'analyse.
  • Vault est une solution de dernier recours : il lit les soldes via le plugin d'économie encore chargé. Quand une autre source fournit déjà des soldes, la ligne Vault est décochée au départ.

Pas à pas

  1. Ouvrez l'éditeur web avec /inglis et allez dans Importer.
  2. Cliquez sur Analyser le serveur. Chaque plugin trouvé obtient une carte avec le nombre de joueurs et, pour chaque type de données, le nombre d'entrées trouvées. Les plugins introuvables sont listés sous les cartes.
  3. Cochez les données que vous voulez. Tout ce qui est lisible est coché par défaut quand le module correspondant est activé.
  4. Choisissez ce qui se passe quand les données existent déjà (voir plus bas). Si vous avez plusieurs devises, choisissez celle qui reçoit les soldes importés.
  5. Cliquez sur Aperçu. Rien n'est encore écrit : un tableau indique, pour chaque type de données, ce qui sera ajouté, ce qui sera remplacé et ce qui est ignoré, avec la raison de chaque élément ignoré.
  6. Cliquez sur Importer et confirmez. Une barre de progression affiche chaque étape. Vous pouvez quitter la page et revenir plus tard.

Une fois terminé, un récapitulatif indique ce qui a été ajouté, remplacé, ignoré et les éventuelles erreurs. Si certains éléments n'ont pas été importés, cliquez sur Télécharger le rapport pour obtenir la liste complète dans un tableur, avec la raison de chaque ligne.

Attention

Après l'import, retirez les anciens plugins ou désactivez leurs fonctions équivalentes, pour que les mêmes données ne soient pas gérées deux fois.

Quand les données existent déjà

Option Effet
Garder l'actuel Ce qui existe déjà dans InglisCore est conservé, seules les nouvelles données sont importées. C'est l'option par défaut.
Remplacer Les données de l'ancien plugin remplacent celles qui existent dans InglisCore.
Additionner les soldes Les anciens soldes s'ajoutent aux soldes actuels, une seule fois par joueur. Tout le reste se comporte comme avec Garder l'actuel.

Relancer l'import

Vous pouvez analyser et importer autant de fois que vous le souhaitez. InglisCore se souvient de ce qu'il a déjà importé : un second passage ne duplique jamais un home, un warp, une sanction ou un solde. Avec Additionner les soldes, l'ancien solde d'un joueur n'est ajouté qu'une fois par devise, même si vous relancez l'import ou si plusieurs plugins contiennent un solde pour le même joueur.

Si le serveur s'arrête en plein import, relancez-le simplement.

Ce qui n'est pas importé

Certains éléments n'ont pas d'équivalent ou ne peuvent pas être convertis sans risque. Ils sont listés dans l'aperçu et dans le rapport au lieu d'être écartés sans prévenir. Les cas les plus courants :

  • Les entrées de kit qui exécutent une commande ou donnent de l'argent, et les items que le serveur ne sait pas lire.
  • Les spawns de groupe d'EssentialsX (seul le spawn principal est importé).
  • Les homes, warps ou prisons situés dans un monde qui n'existe pas sur ce serveur.
  • Les permissions LuckPerms liées à un monde ou à un autre contexte, les valeurs meta et les permissions temporaires sur un grade.
  • Les grades de joueurs qui pointent vers un grade inexistant.
  • Les grades et permissions temporaires expirés.
  • Un surnom déjà utilisé par un autre joueur.
Astuce

Lancez l'import à un moment calme et faites d'abord un Aperçu. Ça ne coûte rien et vous savez exactement à quoi vous attendre.