Changer de bot Discord : transférer niveaux, menus de rôles et commandes vers Lizbot

Beaucoup de serveurs tournent depuis des années avec le même bot. Si on hésite à changer de bot Discord, c'est surtout par peur de perdre quelque chose en route : les niveaux des membres, les rôles-réactions du salon des rôles, les commandes perso ou le message de bienvenue rédigé avec soin. Sans compter la crainte que deux bots fassent tout en double pendant un moment.

Lizbot a une section dédiée au changement de bot : elle analyse ton serveur et reprend ce que ton bot actuel avait configuré. Dans ce guide, tu fais la migration étape par étape : lancer les deux en parallèle, analyser, reprendre les niveaux et les menus de rôles, importer les commandes et retirer proprement l'ancien bot. Pourquoi c'est l'occasion de regrouper plusieurs bots en un seul, le guide Un seul bot au lieu de plusieurs l'explique.

Ce qui peut être repris et ce qui ne peut pas l'être

Les règles AutoMod, les commandes perso et les minuteurs d'autres bots ne peuvent pas être repris automatiquement, car ils ne sont pas visibles publiquement sur Discord. Tu colles donc toi-même tes commandes en texte et tu reconfigures l'AutoMod. Tout est expliqué dans le guide sur l'AutoMod.

1. Ajouter Lizbot en parallèle

Ajoute Lizbot depuis le tableau de bord sans retirer l'ancien bot. Les deux peuvent tourner côte à côte pendant un moment. La migration se trouve dans le tableau de bord sous Outils, onglet Changer de bot. Il te faut pour cela des droits d'admin sur le serveur.

En haut de la page, sous Bots détectés, Lizbot affiche les bots connus qu'elle trouve sur ton serveur et les modules qu'elle peut reprendre. Si les deux font la même chose en ce moment, par exemple envoyer deux fois un message de bienvenue, Lizbot te prévient. Désactive alors la fonction chez l'un des deux.

Fais attention à l'ordre des rôles : Lizbot ne peut attribuer que des rôles placés sous son propre rôle. Dans les paramètres du serveur, fais glisser le rôle Lizbot au-dessus de tous les rôles de niveau, de ping et de centres d'intérêt. Si quelque chose bloque encore, le guide sur les permissions manquantes du bot t'aide.

2. Analyser le serveur

Dans l'onglet Assistant, clique sur Analyser le serveur. Lizbot lit les derniers messages dans 25 salons maximum, en commençant par ceux dont le nom contient log, welcome, roles ou ticket. Elle détecte :

• quels salons servent de logs de modération ou de logs
• les messages de bienvenue et de départ de ton bot actuel
• les panneaux de tickets avec leurs boutons
• les rôles-réactions et les menus de rôles
• quels modules Lizbot peuvent reprendre les tâches de l'ancien bot

L'analyse ne modifie encore rien. Dans les messages de bienvenue, Lizbot retransforme les infos concrètes en variables : la mention du nouveau membre devient {user.mention}, le nom du serveur {guild.name} et le nombre de membres {guild.memberCount}. Le texte fonctionne ainsi aussi pour le membre suivant. Pour peaufiner le modèle ensuite, lis le guide sur le message de bienvenue Discord.

3. Vérifier et appliquer le plan

L'analyse donne une Proposition. Tu peux cocher ou décocher chaque étape séparément. Les suggestions incertaines, comme des associations de rôles dont Lizbot n'est pas sûre, sont décochées d'avance. Lis les remarques sous le plan, elles t'indiquent ce que tu dois faire à la main.

Avec Appliquer la sélection, Lizbot met le plan en œuvre. Tu vois ensuite ce qui a été repris et quelles étapes ont échoué. Tu peux relancer une analyse à tout moment.

4. Reprendre les niveaux

Dans l'onglet Niveaux, choisis la source :

• Fichier : CSV ou JSON avec l'ID utilisateur et l'XP, et en option le niveau et le nombre de messages. Les exports d'autres bots de niveaux marchent en général directement. Tu peux télécharger un modèle. Le fichier peut faire jusqu'à 8 Mo. Avant l'import, Lizbot affiche combien d'entrées elle a reconnues et quelles colonnes elle associe.
• Classement public : pour un bot de niveaux très répandu, Lizbot peut charger directement le classement public de ton serveur. Il doit être réglé sur public chez ce bot. L'onglet t'indique si c'est possible avec ton bot actuel.

Ensuite, tu définis la Conversion :

• Garder les niveaux : chacun a dans Lizbot le même niveau qu'avant, quelle que soit la courbe d'XP.
• XP 1:1 : l'XP est reprise telle quelle, le niveau découle de la courbe de Lizbot.

Si ton serveur a déjà des niveaux dans Lizbot, tu choisis entre Fusionner (la valeur la plus haute l'emporte) et Remplacer. Avec Attribuer ensuite les rôles de récompense, tout le monde reçoit immédiatement les rôles de niveau auxquels il a droit. Crée les récompenses de rôles avant, sous Niveaux et XP. Plus d'infos dans le guide Système de niveaux.

5. Reprendre les menus de rôles

Dans l'onglet Menus de rôles, colle les liens des messages (clic droit sur le message, « Copier le lien du message ») ou choisis les salons que Lizbot doit parcourir. Avec Chercher des menus de rôles, Lizbot détecte quel emoji ou quel bouton correspond à quel rôle, et indique pour chaque résultat son niveau de certitude.

Il y a ici une différence importante :

• Rôles-réactions : Lizbot reprend le message existant. Les réactions restent, tes membres ne remarquent rien du changement. Plus de détails dans le guide sur les rôles-réactions.
• Menus à boutons ou menu déroulant : ces composants appartiennent à l'ancien bot et ne fonctionnent pas sans lui. Lizbot publie donc un nouveau menu de rôles à boutons dans le même salon. Tu supprimes ensuite toi-même l'ancien message.

Lizbot n'attribue jamais via un menu des rôles avec des permissions de staff, comme bannir ou gérer les messages. Pour savoir comment adapter tes menus de rôles par la suite, lis le guide Configurer les rôles Discord.

6. Reprendre les commandes perso

Dans l'onglet Commandes, colle tes commandes en texte, une ligne par commande, par exemple !regles Merci de lire #regles ou regles: Merci de lire #regles. Tu peux aussi charger un fichier CSV ou JSON avec le nom et la réponse.

Sous Variables de, choisis de quel bot viennent les textes. Lizbot convertit alors les variables connues dans les siennes, les inconnues restent telles quelles. La commande à préfixe devient une commande slash : le préfixe disparaît et le nom passe en minuscules, donc !Regles devient /regles.

Avec Vérifier, tu vois à l'avance ce qui sera créé, mis à jour ou ignoré. Une commande est ignorée si son nom appartient à Lizbot, existe déjà, apparaît deux fois ou si la limite de ton offre est atteinte. Lizbot ne remplace les commandes existantes que si tu actives Écraser les commandes existantes. Pour modifier et compléter les commandes importées, consulte le guide sur les commandes personnalisées Discord.

7. Retirer l'ancien bot

Quand tout fonctionne, retire toi-même l'ancien bot dans « Paramètres du serveur > Intégrations » ou d'un clic droit dans la liste des membres. Lizbot ne retire jamais d'autres bots. Supprime ensuite les anciens messages de menus de rôles qui ne fonctionnent plus et crée une sauvegarde de ta nouvelle configuration.

Limites selon l'offre

Checklist

• Lizbot ajoutée, l'ancien bot tourne encore
• Rôle Lizbot au-dessus de tous les rôles qu'elle doit attribuer
• Analyse lancée et proposition vérifiée
• Niveaux importés et rôles de récompense attribués
• Menus de rôles repris et anciens menus à boutons supprimés
• Commandes perso importées et testées
• Fonctions en double désactivées chez l'ancien bot
• Ancien bot retiré, sauvegarde créée

Erreurs fréquentes

• Retirer l'ancien bot trop tôt : sans lui, Lizbot peut encore lire ses messages, mais les menus à boutons ne fonctionnent plus. Ne le retire que quand tout a été repris.
• Laisser les deux bots faire le même travail : deux messages de bienvenue ou des passages de niveau en double perturbent les membres. Désactive tout de suite les fonctions qui se recoupent chez l'un des bots.
• Rôle Lizbot trop bas : l'attribution des rôles de niveau et des rôles des menus échoue alors.
• Cocher les suggestions incertaines sans regarder : vérifie les associations peu sûres avant de les appliquer.
• Classement de niveaux non public : Lizbot ne peut pas charger un classement privé. Utilise alors l'export en fichier.