Bot de chat (Discord et Telegram)

Le bot de chat relie Lords Bot à votre propre bot Discord ou Telegram. Depuis le chat, vous pouvez voir quels comptes sont en ligne, lancer et arrêter des comptes, obtenir les journaux et une capture d’écran, et recevoir des alertes, par exemple quand une clé d’accès a expiré. Les membres de la guilde peuvent aussi utiliser la banque de guilde depuis le chat.

Comment ça marche #

1. Créez votre propre bot sur Discord ou Telegram et copiez son jeton (token).
2. Connectez-le : collez le jeton dans Lords Bot et cliquez sur Connecter (Connect).
3. Choisissez votre chat : envoyez !set dans le salon ou le groupe que vous voulez utiliser. Vous devenez l’administrateur du bot de chat.
4. Utilisez-le : pilotez vos comptes avec des commandes, recevez des alertes et laissez votre guilde utiliser la banque depuis le chat.

Configurer le bot de chat #

Dans la fenêtre principale, ouvrez Paramètres > Options > Autres paramètres (Settings > Options > Other Settings) et allez dans l’onglet Bot de discussion (Chat Bot). Suivez ensuite les étapes pour Discord ou Telegram.

Discord #

1. Allez sur https://discord.com/developers/applications et créez une nouvelle application.
2. Ouvrez la page Bot de l’application et copiez le jeton du bot. Gardez ce jeton secret.
3. Sur la même page, activez Message Content Intent. Lords Bot en a besoin pour lire les commandes. Enregistrez vos modifications.
4. Dans Lords Bot, collez le jeton dans Jeton de robot : (Bot Token:), choisissez Discord et cliquez sur Connecter.
5. Quand le statut affiche Discord Connecté (Discord Connected), cliquez sur Ajouter un bot à Discord (Add Bot to Discord) et ajoutez le bot à votre serveur.

Astuce : si Discord indique que l’intégration « requires code grant », retournez sur le portail développeur et désactivez l’option OAuth2 code grant de votre bot.

Telegram #

1. Ouvrez https://t.me/BotFather dans Telegram et envoyez /newbot.
2. Choisissez un nom, puis un nom d’utilisateur qui se termine par bot. BotFather vous envoie le jeton du bot.
3. Envoyez /setprivacy à BotFather, choisissez votre bot, puis Disable. Cela permet au bot de lire les messages qui commencent par ! dans les groupes.
4. Dans Lords Bot, collez le jeton dans Jeton de robot :, choisissez Telegram et cliquez sur Connecter.
5. Quand le statut affiche Telegram Connecté (Telegram Connected), cliquez sur Ajouter un bot à Telegram (Add Bot to Telegram) et ajoutez le bot à votre groupe.

Pour Telegram uniquement, vous pouvez cocher Utiliser Proxy? (Use Proxy?) et choisir l’un de vos proxies pour la connexion du bot de chat.

Attribuer votre chat #

Les commandes ne fonctionnent qu’une fois le bot lié à un chat :

1. Dans le salon Discord ou le groupe Telegram que vous voulez utiliser, envoyez !set (ou /set).
2. Le bot répond Groupe attribué avec succès ! (Group assigned successfully!)

Le chat où vous avez envoyé set devient le chat du bot de chat, et vous en êtes l’administrateur. Seul l’administrateur peut utiliser les commandes du bot de chat, et seulement dans ce chat. Sur Discord, les commandes apparaissent aussi comme commandes slash sur ce serveur après l’envoi de set.

L’administrateur du bot de chat (celui qui a envoyé set) n’est pas la même chose que les utilisateurs autorisés d’une banque de guilde. Ceux-ci s’ajoutent pour chaque banque dans son onglet Utilisateurs auth. (Authorized Users).

Pour déplacer le bot de chat vers un autre chat, envoyez /cleargroup dans le chat actuel, ou cliquez sur Effacer les données (Clear Data) dans l’onglet Bot de discussion, puis envoyez de nouveau set dans le nouveau chat.

Autres boutons de l’onglet Bot de discussion #

Élément	Ce qu’il fait
Déconnecter (Disconnect)	Déconnecte le bot de chat.
Afficher le journal (View Log)	Affiche le journal de connexion du bot de chat. Consultez-le si le statut indique Quelque chose s’est mal passé, vérifiez le journal (Something went wrong, check log).
Effacer les données	Oublie le chat attribué et l’administrateur.
Zone d’infos	Affiche l’ID du chat (Chat ID), l’ID administrateur (Admin ID) et, sur Discord, le Guilde ID (Guild ID), c’est-à-dire votre serveur.

Commandes #

Seul l’administrateur du bot de chat peut les utiliser, dans le chat défini avec set. Les commandes peuvent commencer par /, ! ou ,. Sur Discord, ce sont aussi des commandes slash, et le champ du compte propose les noms de comptes pendant que vous tapez.

Si quelqu’un d’autre que l’administrateur utilise une commande, le bot répond Vous n’êtes pas autorisé à utiliser cette commande (You are not authorized to use that command). Dans tout autre chat, il répond Les commandes d’administration ne peuvent être utilisées que dans le chat où : /Set a été utilisé. (Admin Commands can only be used in the chat where: /Set was used.) L’exception est /setcastle, que l’administrateur peut utiliser dans n’importe quel chat où se trouve le bot.

Banque de guilde dans le chat #

La banque de guilde peut répondre aux commandes dans n’importe quel salon Discord ou groupe Telegram où se trouve votre bot de chat, pas seulement dans le chat administrateur. Répétez ces étapes pour chaque banque.

Ajouter une banque à un chat (administrateur) #

Dans le chat de groupe, envoyez /setcastle suivi du nom ou de l’ID IGG du compte de la banque, par exemple /setcastle MyBank. Le bot répond Compte attribué au chat (Account Assigned to Chat). Pour la retirer, envoyez /unsetcastle MyBank dans le chat administrateur du bot de chat.

S’inscrire comme utilisateur de la banque (chaque joueur) #

Chaque joueur lie une seule fois son compte Discord ou Telegram à son nom en jeu :

1. Dans le chat de groupe, envoyez une commande de banque comme !bal. (Utilisez le préfixe de la banque s’il a été changé par rapport à !.)
2. Le bot répond avec Veuillez envoyer à la banque : (Please send the bank:) et une commande comme !reguser 123456789.
3. Envoyez exactement cette commande à la banque dans le jeu, dans le chat de guilde ou par courrier. La banque répond Compte enregistré (Social account registered).
4. Renvoyez !bal dans le chat de groupe. Vous recevez votre solde.

Vous pouvez maintenant utiliser depuis le chat toutes les commandes de banque que votre rang autorise. Pour supprimer le lien, envoyez !unreguser à la banque dans le jeu. Voir Commandes de la banque de guilde pour la liste complète.

Remarque : les commandes du bot de chat sont lues en premier. Une commande de banque qui porte le même nom qu’une commande du bot de chat, comme !stop, est traitée dans le chat comme la commande du bot de chat. Envoyez plutôt ces commandes de banque dans le jeu.

Notifications des comptes #

Le bot de chat peut publier les alertes des comptes dans le chat administrateur. Activez-les compte par compte : ouvrez la fenêtre du compte, allez dans Paramètres > Général > Avancé (Settings > General > Advanced), puis dans le groupe Bot de discussion. Vous pouvez utiliser les Paramètres globaux ou un modèle pour régler de nombreux comptes à la fois.

Option	Ce qu’elle publie
Publier le statut dans le Chatbot (Post Status in Chatbot)	Active les alertes du bot de chat pour ce compte.
Expiration de la clé d’accès (Access Key Expiry)	Quand la clé d’accès expire, est renouvelée ou ne peut pas être renouvelée.
Changement du statut de connexion (Connection Status Change)	Quand le compte se connecte, se reconnecte ou se déconnecte.
Autre Connexion (Other Login)	Quand quelqu’un d’autre se connecte au compte.
Statut de la planification (Schedule Status)	Quand une pause du planning commence et se termine, et quand le compte se connecte pendant une pause pour vérifier ses tâches.
Limite de RSS proche (Nearing RSS limit)	Quand la nourriture, la pierre, le bois, le minerai ou l’or atteint 4 milliards, proche de la limite du jeu.
Envoyer les stats (Upload Stats)	Publie les rapports de statistiques que ce compte enregistre (statistiques de cadeaux, liste de la guilde et statistiques de la Fête de guilde, activés dans la page Guilde) sous forme de fichiers dans le chat où ce compte a été ajouté avec /setcastle. Rien n’est publié tant que vous ne l’avez pas fait. Avec cette option activée, la commande de banque !stats all envoyée depuis ce chat envoie aussi le rapport sous forme de fichier.

Tant que Publier le statut dans le Chatbot est activé, certaines alertes sont toujours publiées, par exemple quand le compte est banni ou suspendu, ou quand votre nombre maximum de comptes est atteint.