Ouvrez le Gestionnaire de bots et cliquez sur Ajouter un bot. La fenêtre compte cinq onglets : Identité, Jeu, Connexion, Comportement / Script et Données en direct. Une version de jeu prête est la seule chose dont vous ne pouvez pas vous passer ; tout le reste peut attendre, et presque tout se modifie plus tard dans les Réglages du bot. Votre premier bot guide pas à pas la création d'un bot en mode MITM, pour « homme du milieu » (man-in-the-middle).
Identité
Nom
Lettres minuscules, chiffres et tirets, de 1 à 64 caractères, en commençant et en finissant par une lettre ou un chiffre. Toute autre saisie affiche « Uniquement des lettres minuscules, des chiffres et des tirets. » sous le champ.
Si vous le laissez vide, Asterobot choisit un nom composé de trois mots reliés par des tirets. Le bouton en forme de dé à côté du champ, Générer un nom, en remplit un pour que vous puissiez le voir ou le modifier avant.
Le nom sert uniquement à vous permettre de reconnaître le bot : il n'est pas envoyé au jeu. Il ne peut pas être changé par la suite, et il détermine l'ordre des bots dans le Gestionnaire de bots, ce qui compte aussi en mode MITM.
Compte
Le compte Ankama enregistré avec lequel ce bot se connecte, pour le mode Full socket. Il est facultatif : sans compte, le bot peut seulement relayer une partie que vous jouez en mode MITM.
- La liste affiche tous les comptes du Gestionnaire de comptes, connectés ou non.
- Sous la liste, le compte choisi affiche Connecté ou Non connecté. Pour un compte non connecté, un bouton Connecter ouvre la fenêtre de connexion.
- Le bouton à côté de la liste, Ajouter ou connecter un compte, ajoute un nouveau compte, ouvre la fenêtre de connexion pour celui-ci et le sélectionne.
- L'indication sous le champ précise ce que le bot pourra faire : avec un compte, se connecter seul et relayer une session que vous ouvrez vous-même ; sans compte, seulement relayer.
Choisissez avec soin : la liste ne propose pas de choix vide, donc une fois un compte choisi, vous ne pouvez plus revenir à aucun compte dans cette fenêtre. Rechargez Asteroboard pour repartir d'un formulaire vide. Le compte d'un bot ne peut pas non plus être retiré par la suite, seulement remplacé.
Un compte ne peut appartenir qu'à un seul bot. Si vous en choisissez un qu'un autre bot utilise déjà, Ajouter le bot échoue avec Impossible d'ajouter le bot.
Jeu
Version du jeu
La liste propose les versions de Dofus installées dans le Gestionnaire de jeux. Quand la version de jeu avec laquelle cette version d'Asterobot a été testée est installée, elle est sélectionnée pour vous ; si vous en choisissez une autre, Utiliser la version testée, suivi de son numéro, la remet. Ajouter un jeu ouvre la fenêtre de téléchargement sans quitter celle-ci. Voir Télécharger une version de jeu.
Des badges sous le champ décrivent la version choisie :
| Badge | Signification |
|---|---|
| Compatible ou Version différente | S'il s'agit de la version avec laquelle Asterobot a été testé. Une version différente n'est pas refusée. |
| Vérification des fichiers requis..., puis Prêt ou Fichiers requis manquants | Si les fichiers du jeu dont un bot a besoin sont présents. Télécharger les fichiers requis récupère ceux qui manquent. |
| Non extrait, Extraction en cours, Extrait ou Échec de l'extraction | Si ses données de jeu sont extraites. Cliquez sur Non extrait ou Échec de l'extraction pour lancer l'extraction. |
Une version n'est utilisable qu'une fois ses fichiers du jeu présents et ses données de jeu extraites. D'ici là, une indication sous les badges le signale, l'onglet Connexion reste grisé et Ajouter le bot reste désactivé. Extraire les données de jeu explique ce que signifie « prêt pour un bot ».
Langue
Français, English, Deutsch, Español ou Português. Par défaut, c'est Français.
Cette langue n'est enregistrée avec le bot que si vous choisissez un Paquet de la bibliothèque dans l'onglet Comportement / Script. Avec Aucun ou Script direct, le bot est enregistré en français quoi qu'affiche le champ, et vous la changez ensuite dans les Réglages du bot. Réglages du bot explique ce que la langue change.
Connexion
Cet onglet reste grisé tant que la version de jeu choisie n'est pas prête.
Une fois le bot ajouté
| Choix | Ce qui se passe quand vous cliquez sur Ajouter le bot |
|---|---|
| Ne rien faire | Le bot est ajouté et reste Déconnecté. |
| Se connecter maintenant | Le bot se connecte avec son compte puis rejoint un serveur de jeu, en mode Full socket. Il faut un compte qui affiche Connecté. Sans compte, ce choix est grisé et l'indique. |
| Attendre mon client de jeu | Le bot se met en attente d'un client Dofus que vous jouez, en mode MITM. Rien d'autre ne se passe tant que vous n'avez pas lancé Dofus et ne vous êtes pas connecté. |
Se connecter maintenant est sélectionné à l'ouverture de la fenêtre, même pour un bot sans compte. Dans ce cas, choisissez une autre option, sinon Ajouter le bot reste grisé.
Choix du serveur
La façon dont le bot choisit un serveur de jeu quand il se connecte seul : Le plus récemment joué, Toujours ce serveur ou Me demander à chaque fois. Chaque option est expliquée dans Mode Full socket. Un bot en mode MITM n'en tient pas compte : c'est votre jeu qui choisit le serveur.
Avec Toujours ce serveur, un champ Forcer un serveur affiche les serveurs de la version de jeu choisie, avec leurs noms dans la langue que vous avez sélectionnée. Cliquez sur un serveur pour le sélectionner, et sur Effacer pour le désélectionner. Ajouter le bot reste grisé tant qu'aucun serveur n'est sélectionné.
Identifiant de machine (HWID)
Laissez-le vide pour un nouveau bot : si le bot a un compte, Asterobot en génère un au moment de l'ajouter. Générer en remplit un aléatoire ici à la place. Une valeur que vous saisissez doit compter 64 caractères hexadécimaux, sinon le champ affiche « Doit contenir 64 caractères hexadécimaux. » Réglages du bot explique à quoi il sert.
Comportement / Script
Cet onglet choisit ce que le bot va lancer. Rien de ce que vous choisissez ici ne s'exécute si Lancer le comportement directement n'est pas coché.
| Choix | Ce qu'il fait |
|---|---|
| Aucun | Le choix par défaut. Le bot est ajouté sans rien à lancer. Vous pourrez choisir un paquet plus tard sur sa page. |
| Script direct | Un module JavaScript que vous collez dans Script de comportement, pour des tests rapides. Il n'est jamais enregistré, et il n'est utilisé que si Se connecter maintenant et Lancer le comportement directement sont tous deux sélectionnés. Sinon, il est abandonné à l'ajout du bot. |
| Paquet de la bibliothèque | Un paquet installé, choisi dans Paquet, qui devient le paquet par défaut du bot. En télécharger un installe un paquet depuis le marché sans quitter la fenêtre. |
Un Paquet de la bibliothèque fait aussi apparaître les réglages que le paquet déclare, pour que vous puissiez les définir avant même que le bot existe. Asterobot les enregistre juste après avoir ajouté le bot. Réglages et actions d'un paquet explique ces réglages, et Installer depuis le marché le téléchargement.
Lancer le comportement directement
Cette case, « Démarre le comportement ci-dessus juste après la connexion. », n'apparaît qu'une fois un script direct ou un paquet choisi, et pas avec Attendre mon client de jeu. Elle ne peut être cochée qu'avec Se connecter maintenant, et elle se coche d'elle-même quand vous choisissez un paquet alors que Se connecter maintenant est sélectionné. Si elle reste décochée, le bot est ajouté avec son paquet choisi, mais pas démarré.
Avec Attendre mon client de jeu et un paquet, la fenêtre indique que le comportement « démarre dès que vous lancez le jeu et que la session lui parvient ». Ce n'est pas le cas : rien ne démarre tout seul. Une fois votre jeu relayé, appuyez sur Lancer sur la page du bot. Voir Lancer un paquet.
Données en direct
Cet onglet choisit ce que le bot envoie à Asteroboard pendant qu'il est connecté, pour que sa page suive ce qui se passe en jeu. Il comporte quatre cases, toutes cochées à l'ouverture de la fenêtre.
| Case | Ce qu'elle tient à jour |
|---|---|
| Personnage | Niveau, expérience, points de vie, énergie et caractéristiques, dans l'onglet Personnage et dans la ligne au-dessus des onglets du bot |
| Chat | Messages des canaux de chat du jeu, dans la Console du bot |
| Inventaire | Objets, kamas et pods, dans l'onglet Inventaire et dans la ligne au-dessus des onglets du bot |
| Carte | Position, joueurs et monstres alentour, ressources, dans l'onglet Carte |
Chaque case cochée demande un peu de travail à Asterobot et à votre navigateur pour chaque message qu'elle apporte : décochez celles que vous ne regarderez pas. Si rien n'est coché, les pages du bot restent vides.
Asterobot enregistre votre choix avec le bot. Pour le modifier plus tard, cliquez sur le bouton en forme d'antenne parabolique, tout à droite de la ligne au-dessus des onglets du bot. Son infobulle est Réglages des données en direct, et il propose un interrupteur pour chaque case.
Pourquoi Ajouter le bot reste grisé
Ajouter le bot reste désactivé tant que toutes ces conditions ne sont pas remplies :
- Le nom est vide, ou respecte les règles de nommage ci-dessus.
- Une version de jeu est choisie, et elle est prête : fichiers du jeu présents et données de jeu extraites.
- Si un compte est choisi, il existe toujours dans le Gestionnaire de comptes.
- Avec Se connecter maintenant, un compte est choisi et affiche Connecté.
- Avec Toujours ce serveur, un serveur est sélectionné.
- Avec Script direct, le script n'est pas vide ; avec Paquet de la bibliothèque, un paquet est choisi.
Après un clic sur Ajouter le bot
Asteroboard passe par ces étapes dans l'ordre, et s'arrête à la première qui échoue.
- Asterobot ajoute le bot, avec les données en direct que vous avez cochées. S'il refuse, Asteroboard affiche Impossible d'ajouter le bot et la fenêtre reste ouverte, sans en donner la raison. Les causes habituelles sont un nom déjà pris, un compte déjà utilisé par un autre bot, un Asterobot non connecté à asterobot.net, et la limite de bots de votre compte asterobot.net. Voir Plusieurs bots.
- Les réglages du paquet sont enregistrés, si vous en avez défini. En cas d'échec, Asteroboard affiche Impossible d'appliquer les réglages avec le nom du paquet. Le bot est tout de même ajouté, et vous pouvez les redéfinir dans ses Réglages.
- Avec Ne rien faire, la fenêtre se ferme.
- Avec Attendre mon client de jeu, le bot se met en attente et la fenêtre se ferme. S'il n'y parvient pas, Asteroboard affiche Bot ajouté, mais il n'a pas pu être connecté : le bot existe, déconnecté, et Mode MITM liste les raisons possibles.
- Avec Se connecter maintenant, Asteroboard attend l'issue de la connexion :
- Connecté : la fenêtre se ferme, sauf s'il y a un script à démarrer.
- En attente de votre choix de serveur : la fenêtre se ferme et Asteroboard affiche Bot ajouté - une question de connexion attend une réponse, avec un bouton Aller au bot. Choisissez le serveur sur la page du bot, comme le montre Mode Full socket.
- Échec : la fenêtre se ferme et Asteroboard affiche Bot ajouté, mais il n'a pas pu être connecté, avec la raison en dessous. La même raison apparaît sur la page du bot.
- Avec Lancer le comportement directement, le script démarre une fois le bot connecté, et la fenêtre se ferme. S'il ne peut pas démarrer, Asteroboard affiche Bot ajouté et connecté, mais le comportement n'a pas pu démarrer.
Warning
Dans quelques-uns de ces échecs, la fenêtre reste ouverte avec vos choix toujours remplis : quand le bot ne peut pas se mettre en attente, quand le démarrage du script échoue, et quand une connexion prend plus de 90 secondes (ce qui peut arriver avec une connexion Ankama automatique), auquel cas le bot continue souvent de se connecter en arrière-plan. Le bot a quand même été ajouté. Fermez la fenêtre et regardez la page du bot. Cliquer à nouveau sur Ajouter le bot tenterait d'ajouter un second bot, et avec un nom vide, cela réussit.
Pour aller plus loin
- Mode Full socket ou Mode MITM, pour mettre le bot en ligne.
- Lancer un paquet, pour lui donner quelque chose à faire.
- Réglages du bot, pour modifier ce que vous avez choisi ici.