Smooth

Les bots et la page du jeu travaillent à partir de versions de jeu qu'Asterobot a téléchargées depuis les serveurs de téléchargement d'Ankama. Votre premier bot en télécharge une avec les valeurs par défaut. Ouvrir la fenêtre de téléchargement Dans la barre latérale, ouvrez le Gestionnaire de jeux. Cliquez sur Télécharger un jeu. La fenêtre Télécharger une version de jeu s'ouvre, déjà remplie pour le Dofus qu'utilisent les bots. La même fenêtre s'ouvre depuis Ajouter un jeu, sur l'onglet Jeu de la fenêtre Ajouter un bot. Les champs Champ Par défaut Rôle Jeu dofus Le jeu à télécharger. Plateforme windows La plateforme dont il faut télécharger les fichiers. Environnement dofus3 L'environnement du jeu. Version latest Un numéro de version, comme 3.6.6.6, ou latest pour la version la plus récente publiée par Ankama. Filtre de fichiers (regex) Les fichiers dont un bot a besoin Une expression régulière comparée aux chemins des fichiers du jeu. Seuls les fichiers qui correspondent sont téléchargés. Vide, il télécharge tous les fichiers. Filtre de fragments (regex) Vide Une expression régulière comparée aux noms des parties en lesquelles Ankama découpe un jeu. Vide, il télécharge toutes les parties. Extraire les données après le téléchargement Coché Lance l'extraction des données de jeu de la version dès la fin du téléchargement. Télécharger reste grisé tant que Jeu, Plateforme, Environnement et Version ne sont pas tous remplis. Annuler ferme la fenêtre sans rien télécharger. Jeu, Plateforme et Environnement Ces trois champs acceptent n'importe quel texte et proposent des valeurs pendant la saisie. Les suggestions viennent de la liste des jeux et des versions publiée par Ankama, qui comprend d'autres jeux Ankama en plus de Dofus. Chaque champ ne propose que ce qui va avec les champs situés au-dessus : les plateformes du jeu choisi, puis les environnements de ce jeu sur cette plateforme. Une seule combinaison fonctionne avec les bots : dofus, windows et dofus3. Une version de Dofus pour Windows dans un autre environnement a quand même une page du jeu. Les versions d'autres jeux ou d'autres plateformes se téléchargent et apparaissent dans le tableau comme les autres, mais aucun bot ne peut les utiliser, elles n'ont pas de page du jeu et leur extraction échoue. Vérifier les mises à jour, en haut de la fenêtre, récupère à nouveau la liste d'Ankama, pour que les suggestions incluent ce qui a été publié depuis. Quand Ankama est injoignable, les suggestions viennent des listes qu'Asterobot a enregistrées auparavant. Quand Asteroboard ne peut pas joindre Asterobot, il affiche Impossible de vérifier les mises à jour, et vous pouvez toujours saisir les valeurs vous-même. Version Les suggestions comprennent toutes les versions trouvées dans les listes enregistrées par Asterobot, pas seulement la plus récente. Le réglage cytrus.keepMostRecentIndexes fixe le nombre de ces listes qu'Asterobot conserve, et cytrus.keepMostRecentGamesManifests le nombre de listes de fichiers qu'il conserve pour chaque jeu (Référence des réglages). latest est résolu au moment où vous cliquez sur Télécharger : Asterobot demande à Ankama sa liste actuelle et prend la version la plus récente pour le jeu, la plateforme et l'environnement choisis. Si Ankama est injoignable, Asterobot utilise la dernière liste qu'il a enregistrée. Le tableau affiche toujours le vrai numéro de version, jamais latest. Filtre de fichiers (regex) Le champ contient au départ le motif qu'Asterobot utilise pour les fichiers dont un bot a besoin : les textes du jeu, les tables de données, les données des cartes, le graphe de déplacement du monde, le fichier de version et quelques séries d'images. Gardez-le, sauf si vous savez qu'il vous en faut davantage. Un champ vide télécharge le jeu complet. Pour ajouter des fichiers à une version plus tard, utilisez Télécharger plus de fichiers dans son menu plutôt que de la télécharger à nouveau (Gérer les versions de jeu). Filtre de fragments (regex) Ankama découpe chaque version de jeu en parties nommées. Ce filtre ne garde que les fichiers des parties dont le nom correspond, en plus du filtre de fichiers. Le champ propose win64 en exemple. Laissez-le vide, sauf si vous avez une raison de restreindre le téléchargement. Un filtre qui n'est pas une expression régulière valide fait échouer le téléchargement, avec une raison qui mentionne invalid file filter ou invalid fragment filter. Extraire les données après le téléchargement Quand la case est cochée, Asteroboard lance l'extraction dès la fin du téléchargement, exactement comme si vous cliquiez vous-même sur Extraire les données (Extraire les données de jeu). La case est cochée à la première ouverture de la fenêtre. Une fois un téléchargement lancé, Asteroboard la laisse décochée à la prochaine ouverture de la fenêtre, jusqu'à ce que vous quittiez la page : cochez-la de nouveau quand vous en avez besoin. Important C'est Asteroboard qui lance cette extraction : gardez-le ouvert jusqu'à la fin du téléchargement. Si vous le fermez ou le rechargez avant, le téléchargement continue, mais la version reste marquée Non extrait. Ouvrez alors son menu et cliquez sur Extraire les données. Télécharger une version que vous avez déjà Télécharger un jeu ne télécharge rien pour une version déjà présente dans le tableau avec le statut En attente, Téléchargement, Vérification ou Installé : les filtres sont ignorés et la version reste telle quelle. Avec Extraire les données après le téléchargement coché, une version installée est extraite à nouveau. Pour lui ajouter des fichiers, utilisez Télécharger plus de fichiers. Une version dont le statut est Échec est téléchargée à nouveau, avec les filtres que vous indiquez. Un seul téléchargement à la fois Les téléchargements et les vérifications de fichiers attendent dans une file unique, et un seul d'entre eux s'exécute à la fois, quels que soient le jeu ou la version. Les autres affichent En attente jusqu'à leur tour. Les extractions et la vérification des chunks ne passent pas par cette file. Suivre le téléchargement La version apparaît dans le tableau du Gestionnaire de jeux dès que vous cliquez sur Télécharger. Statut Signification En attente Le téléchargement attend son tour. Téléchargement Les fichiers se téléchargent. Une barre de progression et un compteur indiquent l'avancée. Vérification Les fichiers de la version sont en cours de vérification après Vérifier les fichiers. Installé Le téléchargement est terminé. Échec Le téléchargement s'est arrêté. Survolez l'icône d'information à côté du statut pour lire la raison. Le compteur compte des chunks et des fichiers reconstruits, pas des octets : il donne une idée de l'avancement plutôt qu'une taille. Une fois le téléchargement terminé, la colonne Jeu affiche l'icône et le nom du jeu. Avec Extraire les données après le téléchargement coché, la colonne Extraction passe ensuite à Extraction en cours puis à Extrait, et la colonne Prêt passe à Prêt pour un bot. Fermer Asteroboard n'arrête pas un téléchargement, puisqu'il s'exécute dans Asterobot. Arrêter Asterobot, si. Au redémarrage d'Asterobot, une version interrompue de cette façon affiche Installé bien que des fichiers manquent, et sa colonne Prêt indique Pas prêt. Ouvrez son menu, cliquez sur Télécharger plus de fichiers et gardez le filtre par défaut : les fichiers terminés sont conservés et seul le reste est téléchargé. Asterobot ne vérifie pas l'espace libre sur votre disque avant de télécharger. Si le disque se remplit, le téléchargement s'arrête avec Échec. Quand un téléchargement échoue Ce que vous voyez Que faire Impossible de mettre en file d'attente le téléchargement quand vous cliquez sur Télécharger Asterobot a refusé la demande ou était injoignable. La cause habituelle est un latest impossible à résoudre, parce que le jeu, la plateforme ou l'environnement ne figure pas dans la liste d'Ankama. Choisissez-les parmi les suggestions, cliquez sur Vérifier les mises à jour et vérifiez qu'Asterobot a accès à internet. Échec, avec une raison liée au réseau ou aux serveurs d'Ankama Ouvrez le menu de la version et cliquez sur Réessayer. Le téléchargement reprend là où il s'est arrêté. Échec, avec invalid file filter ou invalid fragment filter dans la raison Cliquez sur Réessayer et corrigez le filtre dans la fenêtre. Échec, avec download queue is full or the server is shutting down Asterobot était en train de s'arrêter, ou trop de téléchargements attendaient. Cliquez sur Réessayer une fois qu'Asterobot fonctionne normalement. Problèmes de téléchargement du jeu couvre d'autres cas. Télécharger les fichiers requis pour un bot Sur l'onglet Jeu de la fenêtre Ajouter un bot, et sur l'onglet Réglages d'un bot, Asteroboard vérifie la version choisie sous Version du jeu et affiche des badges à côté : Compatible ou Version différente (Pourquoi Asterobot télécharge Dofus) ; « Vérification des fichiers requis... », puis Prêt quand les fichiers dont un bot a besoin sont sur le disque, ou Fichiers requis manquants avec un bouton Télécharger les fichiers requis ; l'état de l'extraction, par exemple Non extrait, sur lequel vous pouvez cliquer pour extraire la version. Télécharger les fichiers requis ne télécharge que les fichiers manquants de cette version, dans la même file que les autres téléchargements. Une fois le téléchargement terminé, le badge passe à Prêt. Ce bouton n'extrait pas la version : cliquez sur le badge d'extraction une fois le téléchargement fini. Si le téléchargement échoue, Asteroboard affiche Impossible de télécharger les fichiers requis. Tant qu'il manque à la version ses fichiers ou ses données de jeu, l'onglet indique « Cette version a besoin à la fois de ses fichiers de jeu et de ses données extraites avant qu'un bot puisse s'y connecter ». La même vérification figure sur l'onglet Informations de la page du jeu de la version, dans la carte Fichiers requis (Page du jeu). Ajouter un bot décrit le reste de la fenêtre. En ligne de commande La commande gamemanager download d'Asterobot télécharge une version sans passer par Asteroboard. Ligne de commande liste ses options. Pour aller plus loin Extraire les données de jeu Gérer les versions de jeu

Asterobot ne prend ni les fichiers du jeu ni les données de jeu du Dofus auquel vous jouez. Il télécharge sa propre copie des fichiers du jeu depuis les serveurs de téléchargement d'Ankama, une version de jeu à la fois, et travaille à partir de cette copie. Télécharger une version de jeu montre comment en obtenir une. Une copie bien à lui Le Dofus que vous avez installé avec l'Ankama Launcher reste le vôtre. Asterobot n'y prend ni données de jeu, ni cartes, ni textes, et il ne l'installe pas et ne le met pas à jour. Il ne touche à ce dossier qu'en mode MITM, pour « homme du milieu » (man-in-the-middle) : il lit le numéro de version dans son fichier version et modifie une ligne de ce fichier pour que votre jeu se connecte en passant par Asterobot. Mode MITM explique cette ligne. La copie d'Asterobot est toujours la version Windows de Dofus, même quand Asterobot tourne sous macOS ou Linux. Et par défaut, ce n'est pas le jeu complet, seulement les fichiers dont un bot a besoin : les textes du jeu, dans toutes les langues fournies avec le jeu ; les tables de données du jeu : objets, monstres, sorts, serveurs et le reste ; les données des cartes ; le graphe de déplacement du monde, que le jeu utilise pour planifier les longs trajets, par les zaaps et les bateaux ; quelques séries d'images : les illustrations des serveurs, les visuels de la carte du monde, les icônes des objets et les icônes dessinées sur la carte du monde ; le fichier qui indique le numéro de version. La musique du jeu n'en fait pas partie. Vous pouvez la récupérer plus tard depuis la page du jeu, comme l'explique Musique. Plusieurs versions de jeu peuvent cohabiter, chacune avec sa propre ligne dans le Gestionnaire de jeux. À quoi sert la copie Le téléchargement n'est que la moitié du travail. Asterobot extrait ensuite les fichiers du jeu en données de jeu, et c'est ce que tout le reste lit (Extraire les données de jeu). Quoi Ce qu'il faut Ajouter un bot Une version de jeu marquée Prêt pour un bot : les fichiers dont un bot a besoin sont téléchargés et ses données de jeu sont extraites. Un bot qui se connecte tout seul refuse aussi de le faire tant que sa version n'est pas prête. Scripts Les données de jeu de la version de jeu du bot, pour transformer les nombres des messages du jeu en objets, monstres, cartes et textes. Voir Vue d'ensemble des données de jeu. La page du jeu Les données de jeu et les fichiers de la version, pour la carte du monde, la visionneuse de carte, l'explorateur de données de jeu, les textes et la musique. Voir Page du jeu. La version testée Chaque version d'Asterobot est testée avec une version précise de Dofus : la version testée. Asteroboard compare chaque version de Dofus que vous téléchargez avec celle-ci et affiche un badge : Compatible quand la version est la version testée. Version différente quand ce n'est pas le cas. L'icône d'information à côté du badge affiche « Asterobot est testé avec la version », suivi de la version de Dofus testée pour votre Asterobot, puis « Cette version peut ne pas fonctionner comme prévu. » Le badge apparaît dans la colonne Compatibilité du Gestionnaire de jeux, sur l'onglet Informations de la page du jeu de la version, et sous Version du jeu dans la fenêtre Ajouter un bot ainsi que sur l'onglet Réglages d'un bot. Il n'est affiché que pour les versions de Dofus dont l'environnement est dofus3 et la plateforme windows, les seules que les bots peuvent utiliser. Quand la version testée est téléchargée, Ajouter un bot la sélectionne pour vous. Dès qu'une autre version est sélectionnée, un bouton Utiliser la version testée, suivi du numéro de version, permet d'y revenir en un clic. Une version différente n'est pas bloquée : vous pouvez quand même ajouter un bot qui l'utilise. Mais les messages que Dofus échange avec ses serveurs changent d'une version à l'autre, et Asterobot parle ceux de la version testée : un bot sur une autre version peut donc ne pas réussir à se connecter. Les identifiants de cartes, les colonnes des tables et les textes du jeu changent aussi entre les versions, si bien que les données de jeu d'une version ne correspondent pas toujours à celles d'une autre. Quand Dofus se met à jour explique quoi faire après une mise à jour du jeu. Le mode MITM exige la même version En mode MITM, le Dofus auquel vous jouez et la version de jeu de votre bot doivent être exactement la même version. Quand elles diffèrent, le bot refuse de se mettre en attente de votre jeu. Chaque fois que le launcher met à jour votre Dofus, téléchargez donc aussi la nouvelle version dans Asterobot. Mode MITM montre comment comparer les deux versions. Espace disque Les versions de jeu sont rangées dans le dossier de cache d'Asterobot, indiqué dans Fichiers et dossiers. On y trouve trois sortes de choses : Les chunks. Les serveurs de téléchargement d'Ankama livrent le contenu du jeu en morceaux appelés chunks. Asterobot stocke chaque chunk une seule fois, sous un nom tiré de son contenu, quels que soient la version ou le jeu d'où il vient. Les fichiers de chaque version de jeu, reconstruits à partir de ces chunks. Les données de jeu extraites de chaque version. Comme les chunks sont stockés selon leur contenu, un chunk qu'Asterobot possède déjà n'est jamais retéléchargé, quelle que soit la version qui en a besoin. En revanche, les chunks restent en place une fois les fichiers reconstruits, et le même contenu occupe donc deux fois la place tant que vous ne les supprimez pas. Supprimer tous les chunks dans le Gestionnaire de jeux libère cet espace, au prix d'un prochain téléchargement plus lent (Gérer les versions de jeu). Le code indique quelques tailles, qui évoluent avec les mises à jour du jeu : Élément Taille approximative Les visuels de la carte du monde, inclus dans les fichiers dont un bot a besoin 545 Mo Les données des cartes, incluses dans les fichiers dont un bot a besoin 450 Mo, mesuré sur Dofus 3.6.10.10 La musique du jeu, téléchargée uniquement depuis l'onglet Musique 900 Mo Asterobot ne vérifie pas l'espace libre sur votre disque avant un téléchargement. Si le disque se remplit, le téléchargement s'arrête et son statut passe à Échec. Prérequis récapitule l'espace à prévoir. Pour aller plus loin Télécharger une version de jeu Extraire les données de jeu Quand Dofus se met à jour

Ce pas-à-pas met en route un premier bot en mode MITM (« homme du milieu », de l'anglais man-in-the-middle) : vous jouez à Dofus comme d'habitude, et le bot rejoint votre session de jeu par l'intermédiaire d'Asterobot. Il ne demande ni compte Ankama dans Asterobot ni paquet : c'est la façon la plus rapide de voir Asterobot à l'œuvre. Prévoyez que le téléchargement du jeu prenne un moment la première fois. Avant de commencer, il vous faut : Dofus 3 installé avec l'Ankama Launcher sur l'ordinateur où tourne Asterobot, et à jour. Asterobot lancé et connecté à asterobot.net. Voir Premier lancement et Se connecter avec asterobot.net. Caution Un bot en mode MITM reste un bot. Utiliser des bots enfreint les conditions d'utilisation d'Ankama, et Ankama peut sanctionner les comptes concernés. Lisez d'abord Comptes et sécurité. 1. Télécharger la même version de Dofus Asterobot ne se sert pas du Dofus auquel vous jouez pour les fichiers du jeu : il lit seulement le numéro de version dans son fichier version et y modifie une ligne, comme l'explique Ce qu'Asterobot vient de modifier. Il lui faut sa propre copie de la même version, téléchargée auprès d'Ankama. Dans la barre latérale, ouvrez le Gestionnaire de jeux et cliquez sur Télécharger un jeu. Laissez les champs tels quels : Jeu dofus, Plateforme windows, Environnement dofus3 et Version latest, qui désigne la version la plus récente publiée par Ankama. Quand votre Dofus est à jour, c'est la version à laquelle vous jouez. Laissez Filtre de fichiers (regex) tel quel. Il limite le téléchargement aux fichiers dont un bot a besoin. Vérifiez que la case Extraire les données après le téléchargement est cochée. Cliquez sur Télécharger. La version apparaît dans le tableau. Son Statut passe de En attente à Téléchargement, puis à Installé. La colonne Extraction passe ensuite de Extraction en cours à Extrait, et la colonne Prêt passe à Prêt pour un bot. Important Gardez Asteroboard ouvert jusqu'à la fin du téléchargement. C'est Asteroboard qui lance l'extraction une fois les fichiers arrivés : si vous le fermez avant, la version reste Non extrait. Dans ce cas, ouvrez le menu de la version dans le tableau et cliquez sur Extraire les données. Le Dofus auquel vous jouez indique sa version dans le fichier Dofus_Data/StreamingAssets/version de son dossier, sur la ligne Version=. Ce doit être exactement la version affichée dans le Gestionnaire de jeux : quand Dofus se met à jour, téléchargez aussi la nouvelle version, comme l'explique Quand Dofus se met à jour. 2. Ajouter le bot Ouvrez le Gestionnaire de bots et cliquez sur Ajouter un bot. Dans l'onglet Identité, saisissez un nom en lettres minuscules, chiffres et tirets, ou laissez-le vide et Asterobot en choisira un. Laissez Compte vide : sans compte, le bot ne peut que relayer une partie que vous jouez vous-même, ce qui est exactement ce que vous voulez ici. Dans l'onglet Jeu, choisissez la version téléchargée sous Version du jeu. Ses badges doivent indiquer Prêt et Extrait. Laissez Langue tel quel : la boîte de dialogue ne l'envoie que si vous choisissez un paquet de la bibliothèque dans Comportement / Script, si bien qu'un bot ajouté sans paquet est enregistré en français, quel que soit votre choix. La langue détermine les textes du jeu que lit un paquet et les noms de serveurs affichés pour le bot, et vous pourrez la modifier plus tard dans l'onglet Réglages du bot. Ajouter un bot explique chaque champ de cette boîte de dialogue. Dans l'onglet Connexion, sous Une fois le bot ajouté, choisissez Attendre mon client de jeu. Se connecter maintenant est sélectionné au départ, mais cette option nécessite un compte, et Ajouter le bot reste grisé tant que vous n'avez pas choisi une autre option. Laissez Choix du serveur et Identifiant de machine (HWID) tels quels : ils comptent quand un bot se connecte tout seul, et un bot qui relaie reprend l'identifiant de machine de votre jeu. Dans l'onglet Comportement / Script, laissez Aucun sélectionné. Cliquez sur Ajouter le bot. La boîte de dialogue se ferme, et le bot apparaît dans le tableau avec En attente de votre client de jeu dans sa colonne Réseau. Cliquez sur son nom pour ouvrir sa page. Si Asteroboard affiche Bot ajouté, mais il n'a pas pu être connecté, le bot existe mais n'attend pas. Cela arrive quand le Dofus auquel vous jouez n'est pas la version que vous avez téléchargée, quand Asterobot ne peut pas lire le fichier version de votre dossier Dofus, ou quand un autre programme utilise déjà le port 5555 ou 5556. Corrigez la cause, puis cliquez sur Commencer l'attente sur la page du bot. Ce qu'Asterobot vient de modifier Pour faire passer votre jeu par Asterobot, Asterobot a modifié une ligne de Dofus_Data/StreamingAssets/version dans votre dossier Dofus : la ligne ConfigUrl, qui indique à Dofus où se connecter. Elle pointe désormais vers Asterobot. Le reste du fichier n'est pas touché, et Asterobot remet la ligne d'origine en place dès qu'aucun bot n'attend plus, ou quand il s'arrête normalement. Le terminal d'Asterobot, ainsi que l'onglet Console de la page Serveur, affichent Pointed the played game at Asterobot au moment de la modification. Asterobot cherche votre dossier Dofus à l'emplacement habituel de l'Ankama Launcher : %AppData%\Ankama\Dofus-dofus3 sous Windows et ~/.config/Ankama/Dofus-dofus3 sous Linux. Sous macOS, ou si votre jeu est installé ailleurs, indiquez vous-même le dossier dans le réglage botmanager.mitmGamePath, dans Serveur > Config, puis cliquez sur Déconnecter et Commencer l'attente sur la page du bot. Warning Quand botmanager.mitmGamePath est vide, le bot attend quand même, mais rien n'est modifié et votre jeu ne l'atteint jamais. Si vous ne voyez pas Pointed the played game at Asterobot une fois que le bot attend, vérifiez d'abord ce réglage. 3. Lancer Dofus et jouer Lancez Dofus depuis l'Ankama Launcher, maintenant que le bot attend. Si Dofus était déjà ouvert, fermez-le et relancez-le. Connectez-vous, puis choisissez votre serveur et votre personnage comme d'habitude. Une fois que votre jeu a rejoint son serveur, l'état du bot passe à Connecté au serveur de jeu. Son onglet Console affiche les étapes, dont Attached to Ankama account, A client is being sent to us et Relaying a game session. Votre jeu fonctionne exactement comme d'habitude. Le bot retient le compte Ankama auquel il s'est rattaché. Désormais, il n'accepte que les sessions de jeu de ce compte, et une partie lancée avec un autre compte se joue normalement, sans passer par ce bot. L'onglet Informations affiche maintenant les détails de votre compte et le serveur sur lequel vous êtes. 4. Lire votre chat et votre inventaire Les messages de votre jeu n'arrivent dans Asteroboard que si vous les demandez. Deux interrupteurs s'en chargent pour les plus utiles : Dans l'onglet Console du bot, activez Chat en direct. Dès lors, les messages de chat que reçoit votre jeu apparaissent dans la console avec le nom de leur auteur. Dans l'onglet Inventaire, activez Inventaire en direct. Le jeu n'envoie l'inventaire complet qu'une fois, quand votre personnage entre en jeu : l'onglet Inventaire peut donc rester sur En attente de l'inventaire au début. Revenez à la sélection des personnages dans Dofus et entrez de nouveau en jeu : vos kamas, vos pods et vos objets apparaissent. La prochaine fois, activez Inventaire en direct pendant que le bot attend, avant de choisir votre personnage. Les deux interrupteurs sont enregistrés avec le bot. Warning La zone de saisie en bas de l'onglet Console envoie réellement un message dans le chat du jeu, au nom de votre personnage. 5. Observer les messages de votre jeu Sur la page du bot, ouvrez Outils. L'outil Réseau s'ouvre sur son panneau Trafic. Passez à Réglages. La liste contient tous les messages qu'Asterobot sait nommer. Ceux qu'utilisent vos deux interrupteurs sont déjà cochés. Tapez un mot dans Filtrer les messages... pour réduire la liste, cochez les messages que vous voulez suivre, puis cliquez sur Appliquer. Revenez à Trafic et jouez un peu. Les messages apparaissent au fur et à mesure qu'ils passent : en vert les événements que le serveur annonce, en rouge les requêtes, en bleu les réponses. Cliquez sur un message pour voir ses champs. Pause fige la liste : les messages qui arrivent pendant la pause sont perdus, pas mis de côté, même si l'avis affiché à l'écran indique qu'ils sont toujours enregistrés. Vider efface la liste. Trafic réseau explique chaque partie du panneau. 6. Arrêter Quand vous quittez Dofus, le bot revient à En attente de votre client de jeu, prêt pour la prochaine fois que vous jouerez. Pendant qu'il attend, il garde la ligne de votre dossier Dofus pointée vers Asterobot. Pour arrêter le bot pour de bon, cliquez sur Déconnecter sur sa page. Le bot cesse d'attendre, Asterobot remet la ligne d'origine dans votre dossier Dofus et affiche Pointed the played game back at Ankama. Si vous êtes encore en jeu à ce moment-là, votre jeu est déconnecté : c'est le bot qui portait sa session. La prochaine fois, ouvrez la page du bot, cliquez sur Commencer l'attente, puis lancez Dofus. Les bots ne se mettent jamais en attente tout seuls au démarrage d'Asterobot. En cas de problème Le bot ne quitte jamais « En attente de votre client de jeu » pendant que vous jouez : vérifiez botmanager.mitmGamePath, assurez-vous d'avoir lancé Dofus une fois le bot en attente, et jouez avec le compte Ankama auquel le bot s'est rattaché la première fois. Impossible de mettre le bot en attente : les causes sont les mêmes que pour Bot ajouté, mais il n'a pas pu être connecté à l'étape 2. Commencez par comparer la ligne Version= de votre Dofus avec le Gestionnaire de jeux. Dofus ne se connecte plus après un arrêt brutal d'Asterobot : relancez Asterobot. Il remet la ligne en place au démarrage, à condition que votre bot revienne avec lui. Sinon, remettez la ligne en place à la main. Problèmes en mode MITM détaille chaque erreur. Et ensuite Donnez quelque chose à faire à votre bot : Lancer un paquet, ou suivez le tutoriel Lancer un paquet du marché. Apprenez tout sur ce mode dans Mode MITM. Faites tourner un bot sans client de jeu avec le Mode Full socket.

C'est dans Asteroboard que vous faites tout avec Asterobot. Cette visite montre où se trouvent les choses, pour que le reste du guide soit clair quand il vous dit « ouvrez le Gestionnaire de jeux ». Elle suppose qu'Asterobot tourne et qu'Asteroboard y est connecté, comme dans Premier lancement. La barre latérale La barre latérale liste les pages d'Asteroboard. En haut, à côté du nom, le numéro de version d'Asteroboard renvoie vers ses notes de version sur asterobot.net. Entrée Ce que vous y faites Tableau de bord La page d'accueil, avec un court message de bienvenue. Gestionnaire de bots Ajouter des bots et les piloter. Voir Ajouter un bot. Gestionnaire de jeux Télécharger des versions de jeu auprès d'Ankama et extraire leurs données de jeu. Voir Télécharger une version de jeu. Gestionnaire de comptes Enregistrer des comptes Ankama et les connecter. Voir Ajouter un compte. Gestionnaire de bibliothèque Installer, créer et supprimer des paquets. Voir Gérer votre bibliothèque. Serveur Les onglets État, Console et Config d'Asterobot lui-même. Voir État et console et La page Config. À propos Des liens vers l'aide, le serveur Discord et la page d'état du service, ainsi que la version d'Asteroboard. Préférences La langue et l'apparence d'Asteroboard, et l'adresse de votre Asterobot. Voir Préférences. Les badges vous donnent un état d'un coup d'œil, sans ouvrir de page : Gestionnaire de bots, Gestionnaire de jeux, Gestionnaire de comptes et Gestionnaire de bibliothèque indiquent combien de bots, de versions de jeu, de comptes et de paquets ils contiennent. Gestionnaire de bots porte aussi un nombre vert sur son icône : le nombre de bots connectés à cet instant. Préférences affiche un point rouge pulsant tant qu'Asteroboard n'est pas connecté à Asterobot. Le bouton en haut à gauche de chaque page replie la barre latérale en icônes, et vous pouvez faire glisser le bord de la barre latérale pour l'élargir ou la rétrécir. Asteroboard mémorise la disposition dans votre navigateur. Le bouton de compte En bas de la barre latérale, le bouton de compte indique si Asterobot est connecté à asterobot.net. Une fois Asterobot connecté, le bouton affiche votre avatar et votre nom, et ouvre un menu avec Compte, Profil en ligne et Se déconnecter. Se connecter avec asterobot.net explique chaque état. Les notifications Asteroboard signale les événements par de petites notifications qui apparaissent par-dessus la page. Voici celles que vous rencontrerez en premier : Notification Quand Serveur connecté Asteroboard a joint Asterobot. Serveur déconnecté Asteroboard a perdu le contact avec Asterobot. Il tente de se reconnecter tout seul. Bonjour suivi de votre nom Asterobot a fini de se connecter à asterobot.net. Mise à jour d'Asterobot disponible Une version plus récente d'Asterobot est sur asterobot.net. Son bouton Voir sur asterobot.net ouvre la page de téléchargement. Elle reste affichée jusqu'à ce que vous la fermiez. Voir Mettre à jour Asterobot. Mise à jour disponible Une nouvelle version d'Asteroboard est prête. Voir Installer Asteroboard comme application. Un message avec une icône de mégaphone Une annonce de l'équipe Asterobot. Voir Messages et mises à jour. La plupart des erreurs apparaissent aussi sous forme de notifications, juste après l'action qui a échoué. Les pages de bot Cliquez sur le nom d'un bot dans le tableau du Gestionnaire de bots pour ouvrir sa page. Tous les onglets d'une page de bot partagent le même en-tête : Le nom du bot. Sa connexion : un état comme Déconnecté ou Connecté au serveur de jeu, à côté de Connecter et Commencer l'attente tant que le bot est déconnecté, ou de Déconnecter dès qu'il est en cours de connexion, en attente ou connecté. Voir États et commandes. Son paquet : le paquet que le bot exécute, à côté de Lancer (ou Arrêter pendant qu'il tourne) et d'un menu avec Charger un nouveau paquet, Charger un paquet et le lancer et Décharger le paquet. Voir Lancer un paquet. Ses onglets : Console, Informations, Carte, Inventaire, Outils et Réglages. Deux éléments peuvent apparaître sous l'en-tête : une carte Choisissez un serveur, quand la connexion d'un bot attend que vous choisissiez un serveur, et des alertes rouges quand le bot n'a pas pu se connecter ou que son script s'est arrêté sur une erreur. Page du bot décrit tout cela. Note Bientôt disponible. L'onglet Carte montrera où se trouve votre bot. Pour l'instant, il indique toujours « Ce bot n'a pas encore signalé de carte. » Pour consulter des cartes, utilisez la page Jeu, décrite plus bas. La page Jeu Chaque version de jeu installée a sa propre page. Ouvrez-la depuis le Gestionnaire de jeux, en cliquant sur le nom du jeu ou sur le bouton Inspecter de la ligne de la version. Ses onglets sont Informations, Textes, Cartes, Données de jeu et Musique. Tous les onglets sauf Informations et Musique ont un sélecteur Langue qui définit la langue d'affichage des textes du jeu. Voir Page du jeu. Dès que vous y lancez de la musique, de petites commandes de lecture restent dans la barre du haut pendant que vous parcourez d'autres pages. Les pages de paquet Dans le Gestionnaire de bibliothèque, cliquez sur le nom d'un paquet pour ouvrir sa page. Elle indique d'où vient le paquet, s'il fonctionne avec votre version d'Asterobot, son manifeste, les autres versions que vous avez installées et les bots réglés pour exécuter cette version. Un paquet local a aussi un bouton Modifier le code, qui ouvre l'éditeur. Voir Gérer votre bibliothèque et L'éditeur. Installer Asteroboard comme application Asteroboard peut s'installer comme une application depuis votre navigateur, et s'ouvre alors dans sa propre fenêtre. Installé ou non, il continue de fonctionner sans connexion internet une fois chargé, tant qu'il peut joindre Asterobot. Asteroboard se met à jour tout seul. Tant qu'il est ouvert, il vérifie toutes les 30 minutes si une nouvelle version existe. Quand une version est prête, il affiche Mise à jour disponible avec un bouton Actualiser, et passe à la nouvelle version quand vous cliquez dessus ou rechargez la page. Si votre navigateur ne peut pas préparer Asteroboard pour une utilisation hors ligne, il affiche Mode hors ligne indisponible : Asteroboard fonctionne toujours, mais certaines fonctionnalités peuvent alors nécessiter une connexion internet. Changer la langue Dans la barre latérale, cliquez sur Préférences. La section Apparence s'ouvre. Choisissez une langue sous Langue : anglais, français ou espagnol. Par défaut, Asteroboard suit la langue de votre navigateur. Si votre navigateur utilise une autre langue, Asteroboard démarre en français. Une fois une langue choisie, un bouton à côté de la liste, Utiliser la langue du système, permet de revenir à la langue du navigateur. Ce choix ne s'applique qu'à ce navigateur. Les textes du jeu sur la page Jeu suivent la langue d'Asteroboard, jusqu'à ce que vous en choisissiez une autre dans le sélecteur Langue propre à la page Jeu. La langue de chaque bot est un réglage distinct, propre au bot. L'adresse de votre Asterobot Préférences comporte aussi une section Serveur, avec l'URL du serveur à laquelle Asteroboard se connecte et un bouton Tester la connexion. L'adresse est remplie pour vous quand vous ouvrez l'adresse d'Asterobot lui-même : vous n'avez donc à y toucher que pour des installations particulières. Voir Préférences. Pour aller plus loin Votre premier bot

Asterobot doit être connecté à votre compte asterobot.net avant que vous puissiez ajouter un bot, et c'est aussi avec ce compte qu'il installe les paquets du marché. Vous ne saisissez jamais votre mot de passe dans Asterobot pour cela : Asterobot obtient un code de connexion, et vous confirmez ce code sur asterobot.net dans votre navigateur. Quand un code expire, Asterobot en demande un nouveau tout seul. Quand Asterobot vous demande de vous connecter Asterobot lance une connexion de lui-même dès qu'il n'en a aucune d'enregistrée, ce qui est le cas lors de son premier lancement. Il en lance aussi une quand asterobot.net cesse d'accepter la connexion qu'il avait, et quand vous cliquez sur Se connecter dans Asteroboard après vous être déconnecté. À chaque fois, vous trouvez le lien de connexion à trois endroits : Le terminal, sur la ligne qui suit Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized. Un onglet du navigateur qu'Asterobot ouvre tout seul, sur l'ordinateur où il tourne. Il ne le fait que pour le premier code : si ce code expire, les suivants n'ouvrent pas d'onglet. Le bouton de compte d'Asteroboard, en bas de la barre latérale, qui affiche désormais Connexion en attente. Confirmer le code Ouvrez le lien : cliquez sur le bouton de compte dans Asteroboard, ou passez à l'onglet ouvert par Asterobot. Si asterobot.net vous demande de vous connecter, connectez-vous avec votre compte asterobot.net. Si vous n'en avez pas encore, vous pouvez le créer maintenant. Autorisez Asterobot à accéder à votre compte. Fermez l'onglet. En quelques secondes, le terminal affiche Website sign-in completed, Asteroboard affiche Bonjour suivi de votre nom, et le bouton de compte affiche votre avatar et votre nom asterobot.net. Asterobot reste ensuite connecté, même quand vous le redémarrez. Le code Le code compte huit caractères, des chiffres et des lettres de A à F, et le lien le contient déjà, après code=. Ouvrir le lien le remplit pour vous. Si vous ouvrez l'adresse sans le code à la fin, par exemple parce que vous avez tapé le lien à la main sur un autre appareil, asterobot.net affiche à la place une page Connect a device. Tapez les huit caractères dans le champ Device code et confirmez. Les espaces, les tirets et les minuscules n'ont pas d'importance. Un code est valable 15 minutes. Si vous ne le confirmez pas à temps, le terminal affiche Sign-in was not completed in time; it will be offered again, et Asterobot demande tout seul un nouveau code dans les minutes qui suivent. Le bouton de compte ouvre alors le nouveau lien. Pour obtenir un nouveau code tout de suite, rechargez Asteroboard : si le bouton de compte affiche Se connecter, cliquez dessus. Messages sur asterobot.net Message Ce qui s'est passé Que faire « This code is invalid or has expired. Check the code displayed on your device and try again. » Le code a été mal saisi, a déjà servi ou date de plus de 15 minutes. Vérifiez le code, ou ouvrez le lien le plus récent qu'Asterobot vous a donné. « Too many incorrect codes have been entered. Wait a few minutes and try again. » 20 codes erronés ont été saisis depuis votre connexion en moins de 15 minutes. Patientez. Vous pourrez de nouveau saisir des codes au plus tard 15 minutes après le dernier code erroné. « The authorization was denied. You can close this page; your device will stop waiting shortly. » Vous avez refusé l'accès à Asterobot. Rien, si c'était voulu. Asterobot cesse d'attendre et redemande plus tard. « This authorization link is invalid or has expired. Start again from your device. » La page a été ouverte depuis un lien périmé ou abîmé. Ouvrez le lien le plus récent qu'Asterobot vous a donné. « This authorization session has expired. Start again from your device. » Le code a expiré pendant que vous vous connectiez. Ouvrez le lien le plus récent qu'Asterobot vous a donné. « The authorization could not be completed. Start again from your device. » asterobot.net n'a pas pu terminer la connexion. Ouvrez le lien le plus récent qu'Asterobot vous a donné, ou rechargez Asteroboard et cliquez sur Se connecter. Se connecter depuis un téléphone Quand Asterobot tourne sur une machine où vous ne pouvez pas ouvrir de navigateur, comme un serveur, il peut afficher le lien sous forme de QR code dans son terminal : Dans Asteroboard, ouvrez Serveur > Config et activez website.showQRCode. Attendez le code suivant. Le QR code apparaît dans le terminal au-dessus de la ligne Alternatively, scan the QR code above to open the link directly. Scannez-le avec votre téléphone et confirmez le code depuis celui-ci. Le réglage s'applique à partir du prochain code demandé par Asterobot. Si un code est déjà en attente, le QR code arrive avec le suivant, ou quand Asterobot redémarre sans connexion enregistrée. Le bouton de compte Le bouton de compte affiche Ce que cela signifie Ce que fait un clic Se connecter, avec un point rouge Asterobot n'est pas connecté et n'attend aucun code. Lance une nouvelle connexion. Connexion en attente Un code vous attend. Ouvre le lien de connexion dans un nouvel onglet. Votre avatar et votre nom, ou Connecté pendant le chargement de votre profil Asterobot est connecté. Ouvre un menu avec Compte, Profil en ligne et Se déconnecter. Compte ouvre une page consacrée à votre compte asterobot.net, décrite dans Votre compte. Se déconnecter puis se reconnecter Cliquez sur le bouton de compte, puis sur Se déconnecter. Le bouton Déconnecter de la page Compte fait la même chose. Confirmez. Asterobot oublie sa connexion, et le bouton de compte affiche de nouveau Se connecter. Après une déconnexion, Asterobot ne se reconnecte pas tout seul, pas même quand il redémarre. Pour vous reconnecter, cliquez sur Se connecter sur le bouton de compte. Asterobot demande un nouveau code et ouvre le lien dans un onglet du navigateur sur l'ordinateur où il tourne, et le bouton de compte l'ouvre aussi. Quand la connexion cesse de fonctionner asterobot.net peut cesser d'accepter la connexion d'Asterobot, par exemple une fois qu'elle a expiré ou qu'elle a été révoquée. Dans ce cas, Asterobot l'oublie et lance aussitôt une nouvelle connexion. Le terminal affiche un avertissement, comme Website rejected the token, puis un nouveau lien, et le bouton de compte passe à Connexion en attente. Confirmez le nouveau code comme décrit plus haut. Garder la connexion privée Asterobot enregistre sa connexion dans config.toml, sous le réglage website.token : c'est ce qui lui permet de rester connecté d'un redémarrage à l'autre. Quiconque obtient cette valeur peut s'en servir pour utiliser votre accès asterobot.net. Ne la partagez jamais, pas plus que le fichier config.toml qui la contient. Obtenir de l'aide liste ce que vous pouvez partager sans risque quand vous demandez de l'aide. Pour aller plus loin Visite d'Asteroboard Votre premier bot

Asterobot tourne dans une fenêtre de terminal et ouvre Asteroboard dans votre navigateur au démarrage. Il vous faut le programme décompressé comme indiqué dans Télécharger Asterobot. Démarrer Asterobot Sous Windows Double-cliquez sur asterobot.exe. Une fenêtre de terminal s'ouvre, et Asterobot tourne à l'intérieur. Tip Si Asterobot s'arrête juste après avoir démarré, sa fenêtre se ferme avant que vous puissiez lire pourquoi. Lancez-le plutôt depuis PowerShell, dans le dossier où vous l'avez placé, et les messages restent à l'écran : .\asterobot.exe Sous macOS et Linux Ouvrez un terminal dans le dossier où vous avez placé Asterobot et lancez : ./asterobot Commandes et version Lancer Asterobot sans commande le démarre normalement, exactement comme ./asterobot server. Le programme propose aussi des commandes pour d'autres tâches, comme télécharger une version de jeu ou réinitialiser les réglages, toutes listées dans Ligne de commande. Pour connaître votre version sans le démarrer, lancez ./asterobot --version (.\asterobot.exe --version sous Windows). La dernière ligne affichée indique Asterobot version suivi du numéro de version. Ce qu'affiche le terminal Asterobot écrit ce qu'il fait dans le terminal, ligne par ligne, en commençant par une ligne qui donne sa version et l'adresse du site. Lors d'un premier lancement, voici les lignes à repérer : Ligne Ce qu'elle signifie Bots restored from config Asterobot a chargé vos bots enregistrés. Lors d'un premier lancement, il n'y en a aucun. Server listening Asterobot est prêt à l'adresse qui suit : 127.0.0.1:8080 par défaut. Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized. Asterobot n'est pas connecté à asterobot.net. La ligne suivante contient le lien à ouvrir. Website sign-in completed Vous avez confirmé la connexion sur asterobot.net. An Asterobot update is available Une version plus récente est publiée sur asterobot.net. La ligne se termine par son numéro de version et son lien. Failed to open frontend Asterobot n'a pas pu ouvrir votre navigateur. Ouvrez Asteroboard vous-même, comme expliqué plus bas. Asterobot affiche aussi d'autres lignes. État et console explique la quantité de lignes qu'il affiche et comment la modifier. Asteroboard s'ouvre Une fois prêt, Asterobot ouvre votre navigateur à l'adresse http://127.0.0.1:8080. Cette adresse renvoie le navigateur vers https://asteroboard.asterobot.net en y joignant l'adresse d'Asterobot : c'est ainsi qu'Asteroboard sait où se connecter. Asteroboard enregistre l'adresse comme URL du serveur, la retire de la barre d'adresse, et affiche Serveur connecté une fois qu'il a joint Asterobot. Si aucune fenêtre de navigateur ne s'ouvre, allez vous-même sur http://127.0.0.1:8080 dans votre navigateur. Si vous préférez qu'Asterobot n'ouvre jamais le navigateur au démarrage, activez le réglage server.skipOpenFrontend dans Serveur > Config. Lors d'un premier lancement, un second onglet s'ouvre en même temps sur asterobot.net. C'est Asterobot qui vous demande de vous connecter : Se connecter avec asterobot.net explique quoi faire sur cette page. Ce qu'Asterobot crée sur votre ordinateur Au premier lancement, Asterobot crée ses dossiers dans votre profil utilisateur, pour ses réglages (un fichier config.toml, vide pour l'instant), ses données et son cache. Sous Linux, ce sont trois dossiers distincts. Sous Windows, les données et le cache partagent un même dossier, et sous macOS, ce sont les réglages et les données. Ces dossiers restent en place quand Asterobot s'arrête, et il y retrouve tout au démarrage suivant. Fichiers et dossiers indique où ils se trouvent sur chaque système. Le laisser tourner Asterobot ne fonctionne que pendant qu'il tourne. Laissez sa fenêtre de terminal ouverte tant que vous utilisez vos bots : vous pouvez la réduire, mais la fermer met fin à Asterobot. Fermer Asteroboard, en revanche, n'arrête rien, comme l'explique Les trois parties. Arrêter Asterobot Arrêtez Asterobot depuis son terminal ou depuis Asteroboard. Les deux méthodes lui permettent de tout fermer proprement : il déconnecte vos bots et remet en place la ligne qu'il a pu modifier dans votre dossier Dofus pour le mode MITM (« homme du milieu », de l'anglais man-in-the-middle), où un bot rejoint la partie que vous jouez. Depuis le terminal Appuyez sur Ctrl+C dans la fenêtre de terminal d'Asterobot. Asterobot affiche Shutting down server, ferme tout et quitte. Depuis Asteroboard Dans la barre latérale, cliquez sur Serveur. L'onglet État s'ouvre. Dans la carte Extinction, cliquez sur Éteindre le serveur. Dans la boîte de dialogue Éteindre le serveur ?, cliquez sur Oui, éteindre. Asteroboard affiche Extinction demandée, et Asterobot s'arrête environ deux secondes plus tard. Asteroboard affiche ensuite Serveur déconnecté. Important Asteroboard ne peut pas redémarrer Asterobot. Après un arrêt, il vous faut un accès à l'ordinateur sur lequel tourne Asterobot pour le relancer. Fermer la fenêtre de terminal met aussi fin à Asterobot, mais il n'aura peut-être pas le temps de tout fermer proprement. S'il a laissé votre dossier Dofus modifié, il le remet en état au démarrage suivant. Le relancer Démarrez Asterobot de la même façon que la première fois. Ce que vous avez configuré est toujours là : Asterobot est toujours connecté à asterobot.net : vous n'avez pas besoin d'un nouveau code. Vos bots reviennent, déconnectés. Rien ne se reconnecte ni ne se met à jouer tout seul : vous remettez chaque bot en ligne depuis Asteroboard. Voir Déconnecter, supprimer et redémarrer. Votre navigateur ouvre de nouveau Asteroboard, sauf si vous avez activé server.skipOpenFrontend. Si Asterobot s'arrête aussitôt avec An error occurred during the server's initialization process, c'est qu'il n'a pas pu utiliser son adresse, par exemple parce qu'une autre copie d'Asterobot tourne déjà. Asteroboard ne se connecte pas vous aide à régler le problème. Pour aller plus loin Se connecter avec asterobot.net Visite d'Asteroboard

Asterobot est un programme unique, livré dans une archive .7z. Il n'y a pas d'installateur : vous téléchargez l'archive prévue pour votre ordinateur, vous la vérifiez si vous le souhaitez, puis vous la décompressez là où vous voulez garder Asterobot. Choisir la bonne archive Asterobot est publié sur https://asterobot.net/files/category/3-asterobot/. Ouvrez-y le fichier Asterobot. Chaque version est fournie avec six archives, une par système et processeur, et un fichier checksums.txt. Le nom des archives suit le modèle Asterobot_VERSION_SYSTEM_PROCESSOR.7z, où VERSION est le numéro de version : Votre ordinateur Archive à télécharger Windows avec un processeur Intel ou AMD Asterobot_VERSION_windows_amd64.7z Windows avec un processeur ARM Asterobot_VERSION_windows_arm64.7z Mac avec Apple silicon Asterobot_VERSION_darwin_arm64.7z Mac avec un processeur Intel Asterobot_VERSION_darwin_amd64.7z Linux avec un processeur Intel ou AMD Asterobot_VERSION_linux_amd64.7z Linux avec un processeur ARM Asterobot_VERSION_linux_arm64.7z Dans ces noms, darwin désigne macOS, amd64 un processeur x86-64 d'Intel ou d'AMD, et arm64 un processeur ARM. Prérequis liste les ordinateurs pris en charge par chaque version. Connaître le type de votre processeur Windows : ouvrez Paramètres > Système > Informations système et lisez Type du système. La mention « processeur x64 » correspond à amd64, et « processeur ARM » à arm64. macOS : ouvrez le menu Pomme > À propos de ce Mac. Si une Puce comme Apple M1 est indiquée, il vous faut arm64. Si un Processeur Intel est indiqué, il vous faut amd64. Linux : lancez uname -m dans un terminal. x86_64 correspond à amd64, et aarch64 à arm64. Vérifier le téléchargement checksums.txt liste la somme de contrôle SHA-256 de chaque archive de la version. Si la somme de contrôle du fichier que vous avez téléchargé correspond à sa ligne, le fichier est exactement celui qui a été publié. La vérification prend quelques secondes : téléchargez checksums.txt dans le même dossier que votre archive, puis suivez les étapes pour votre système. Sous Linux Lancez cette commande dans le dossier qui contient les deux fichiers : sha256sum --ignore-missing -c checksums.txt Elle affiche le nom de votre archive suivi de OK. L'option --ignore-missing ignore les archives que vous n'avez pas téléchargées. Sous macOS Lancez cette commande dans le dossier qui contient l'archive, avec le vrai nom de votre archive : shasum -a 256 Asterobot_VERSION_darwin_arm64.7z Comparez le long code qu'elle affiche avec le code de la ligne de votre archive dans checksums.txt. Sous Windows Ouvrez PowerShell dans le dossier qui contient l'archive et lancez cette commande, avec le vrai nom de votre archive : Get-FileHash -Algorithm SHA256 .\Asterobot_VERSION_windows_amd64.7z Comparez le Hash qu'elle affiche avec le code de la ligne de votre archive dans checksums.txt. PowerShell l'écrit en majuscules et checksums.txt en minuscules, ce qui ne change rien. Si les codes ne correspondent pas, ne lancez pas le fichier. Supprimez-le et téléchargez-le de nouveau. Décompresser l'archive L'archive contient un seul fichier : asterobot.exe sous Windows, asterobot sous macOS et Linux. Windows : ouvrez l'archive avec 7-Zip ou tout autre programme capable de lire les fichiers .7z, et extrayez asterobot.exe. macOS : ouvrez l'archive avec une application capable de lire les fichiers .7z, et extrayez asterobot. Linux : extrayez-la avec la ligne de commande de 7-Zip. Sous Debian et Ubuntu, c'est la commande 7zz du paquet 7zip : 7zz x Asterobot_VERSION_linux_amd64.7z Choisir où le garder Placez le programme dans le dossier de votre choix. Asterobot ne stocke rien à côté de lui : vos réglages, bots, comptes Ankama, versions de jeu et paquets vont tous dans des dossiers de votre profil utilisateur, listés dans Fichiers et dossiers. Vous pouvez déplacer le programme plus tard sans rien perdre, et mettre à jour Asterobot revient à remplacer ce seul fichier (voir Mettre à jour Asterobot). Le rendre exécutable sous macOS et Linux Sous macOS et Linux, donnez au fichier le droit de s'exécuter avant de le lancer. Dans un terminal, depuis le dossier où vous l'avez placé : chmod +x asterobot Pour aller plus loin Premier lancement démarre Asterobot pour la première fois.

Asterobot fonctionne avec un compte sur asterobot.net, le site web d'Asterobot. Si vous en avez déjà un, vous pouvez passer directement à Télécharger Asterobot. À quoi sert ce compte Connecter Asterobot. Au premier démarrage, Asterobot vous demande de vous connecter avec votre compte asterobot.net, et vous ne pouvez pas ajouter de bot tant qu'il n'est pas connecté. Se connecter avec asterobot.net vous guide pas à pas. Le marché. Quand vous installez un paquet depuis le marché, Asterobot le récupère avec le compte auquel il est connecté. Pour y partager un paquet de votre cru, il faut aussi un compte. Voir Le marché. Le forum. Il vous faut un compte pour poser des questions et répondre aux autres joueurs sur https://asterobot.net/forums/. Le créer Ouvrez https://asterobot.net et créez votre compte avec l'option d'inscription du site. Vous pouvez aussi attendre qu'Asterobot vous demande de vous connecter. Le code de connexion qu'il vous donne reste valable 15 minutes, ce qui vous laisse le temps de créer d'abord le compte sur asterobot.net, puis de confirmer le code. Tip Asterobot ne vous demande jamais votre mot de passe asterobot.net. Vous ne le saisissez que sur asterobot.net même, et Asterobot obtient l'accès grâce au code que vous y confirmez. Pour aller plus loin Télécharger Asterobot

Cette documentation emploie le même mot pour la même chose sur toutes les pages. Quand un mot n'est pas clair, cherchez-le ici, puis suivez le lien vers la page qui le traite en détail. A Gestionnaire de comptes : la page d'Asteroboard où vous enregistrez des comptes Ankama et les connectez. Voir Ajouter un compte. actions : les boutons qu'un paquet déclare. Ils apparaissent dans l'onglet Réglages d'un bot et exécutent une partie du script du paquet quand vous cliquez dessus. Voir Réglages et actions d'un paquet. compte Ankama : le compte avec lequel vous jouez à Dofus. Un bot Full socket se connecte avec un compte enregistré dans le Gestionnaire de comptes. Un bot en mode MITM (« homme du milieu ») n'en a pas besoin. Voir Ajouter un compte. Ankama Launcher : le programme d'Ankama qui installe et met à jour Dofus. Le mode MITM fonctionne avec le Dofus qu'il installe. Voir Mode MITM. Ankama Shield : la protection supplémentaire d'Ankama à la connexion, comme l'authentification à deux facteurs. Les comptes qui utilisent l'une ou l'autre ne peuvent pas servir en mode Full socket, seulement en mode MITM. Voir Shield et authentification à deux facteurs. Asteroboard : l'interface web disponible à l'adresse https://asteroboard.asterobot.net, qui pilote votre Asterobot. Voir Les trois parties. Asterobot : le programme que vous téléchargez et lancez sur votre ordinateur. Vos bots, comptes Ankama, versions de jeu et paquets s'y trouvent tous. Voir Les trois parties. asterobot.net : le site web d'Asterobot, avec votre compte, les téléchargements d'Asterobot, le marché et le forum. Voir Les trois parties. compte asterobot.net : votre compte sur le site. Asterobot s'en sert pour se connecter. Voir Créer un compte asterobot.net. B bot : une configuration enregistrée qui se connecte à Dofus et exécute un paquet. Il a un nom, une version de jeu, une langue, des préférences de connexion, et éventuellement un compte Ankama et un paquet. Voir Qu'est-ce qu'un bot. Gestionnaire de bots : la page d'Asteroboard qui liste vos bots et où vous en ajoutez de nouveaux. Voir Qu'est-ce qu'un bot. C checksums.txt : le fichier publié à côté des archives d'Asterobot, avec une somme de contrôle SHA-256 pour chacune, afin que vous puissiez vérifier votre téléchargement. Voir Télécharger Asterobot. chunk : un morceau de contenu du jeu, tel que les serveurs de téléchargement d'Ankama le livrent. Asterobot stocke chaque chunk une seule fois, quelle que soit la version de jeu dont il provient, et reconstruit les fichiers du jeu à partir des chunks. Voir Gérer les versions de jeu. Communautaire : voir Local, Communautaire et Officiel. config.toml : le fichier où Asterobot enregistre les réglages que vous avez modifiés. Voir Fichiers et dossiers. script de connexion : un paquet qui fait entrer un bot Full socket en jeu, en l'identifiant sur le serveur de jeu puis en entrant en jeu avec un personnage. Voir Mode Full socket. console : l'onglet Console d'un bot, où vous lisez ce qu'Asterobot dit du bot, ce que son script journalise et, quand le chat en direct est activé, le chat du jeu. Asterobot a aussi sa propre console, sur la page Serveur. Voir Console. D dépendance : un paquet dont un autre paquet utilise le code. Installer un paquet depuis le marché télécharge aussi les paquets dont il dépend. Voir Qu'est-ce qu'un paquet. identifiant de machine : l'empreinte matérielle qu'un bot annonce quand il se connecte. Asterobot en génère un pour chaque bot qui a un compte Ankama. Un bot sans compte reprend celui du client Dofus qu'il relaie. Voir Réglages du bot. E extraire : transformer les fichiers du jeu d'une version de jeu en données de jeu. Une version de jeu doit être extraite avant que vous puissiez ajouter un bot qui l'utilise. Voir Extraire les données de jeu. F mode Full socket : le bot se connecte et dialogue avec les serveurs de jeu tout seul, sans client Dofus. Voir Mode Full socket. G données de jeu : ce qu'Asterobot extrait des fichiers du jeu : objets, monstres, cartes, textes et plus encore. Les paquets et la page Jeu les lisent. Voir Extraire les données de jeu. fichiers du jeu : les fichiers qu'Asterobot télécharge auprès d'Ankama pour une version de jeu. Par défaut, seulement ceux dont un bot a besoin. Voir Pourquoi Asterobot télécharge Dofus. Gestionnaire de jeux : la page d'Asteroboard où vous téléchargez, extrayez et supprimez des versions de jeu. Voir Gérer les versions de jeu. page Jeu : la page d'une version de jeu, avec ses onglets Informations, Textes, Cartes, Données de jeu et Musique. Voir Page du jeu. version de jeu : une version de Dofus téléchargée par Asterobot. Voir Télécharger une version de jeu. I Incompatible : le badge d'un paquet qui indique les versions d'Asterobot avec lesquelles il fonctionne, quand la vôtre n'en fait pas partie. Le paquet reste dans votre bibliothèque mais ne démarre pas. Voir Qu'est-ce qu'un paquet. intercepteur : une fonction d'un script qui est consultée à propos d'un message avant qu'il poursuive son chemin, et qui peut le laisser passer, le modifier ou le supprimer. Voir Interception. L raison de lancement : la raison pour laquelle un script démarre, qu'il lit dans launch.reason : "initial", "resume" ou "reload". Voir La fonction d'entrée. bibliothèque : les paquets installés dans votre Asterobot. Voir Gérer votre bibliothèque. Gestionnaire de bibliothèque : la page d'Asteroboard qui liste votre bibliothèque, où vous téléchargez, importez, créez et supprimez des paquets. Voir Gérer votre bibliothèque. chat en direct : l'interrupteur Chat en direct de l'onglet Console d'un bot. Tant qu'il est activé, le chat du jeu que reçoit le bot s'affiche dans sa console. Voir Console. inventaire en direct : l'interrupteur Inventaire en direct de l'onglet Inventaire d'un bot. Tant qu'il est activé, le bot envoie l'inventaire de son personnage à Asteroboard. Voir Inventaire. Local, Communautaire et Officiel : les trois badges de la colonne Provenance du Gestionnaire de bibliothèque, qu'Asterobot choisit d'après le nom d'un paquet. Local désigne un nom simple que vous avez créé, copié ou importé, Communautaire un nom du marché comme @some-author:auto-harvest, et Officiel un nom qui commence par @asterobot:. Voir Qu'est-ce qu'un paquet. M manifeste : asterobot.json, le seul fichier d'un paquet qui n'est pas du code. Il liste les paquets dont il dépend, les versions d'Asterobot avec lesquelles il fonctionne et les permissions qu'il déclare. Voir Le manifeste. man-in-the-middle : ce que signifie MITM, « homme du milieu » en français. Voir mode MITM. marché : la catégorie Library d'asterobot.net, où les joueurs partagent des paquets. Voir Le marché. message : une donnée échangée entre Dofus et les serveurs de jeu, comme un message de chat ou une mise à jour de l'inventaire. Voir Trafic réseau. mode MITM : de l'anglais man-in-the-middle, « homme du milieu ». Le bot relaie la session d'un client Dofus sur lequel quelqu'un joue, en se plaçant entre le jeu et les serveurs d'Ankama. Voir Mode MITM. N outil Réseau : l'outil Réseau, sous Outils sur la page d'un bot. Son panneau Réglages choisit les messages qu'Asteroboard affiche, et son panneau Trafic les liste au fur et à mesure qu'ils passent. Voir Trafic réseau. O Officiel : voir Local, Communautaire et Officiel. P paquet : ce que vous installez dans la bibliothèque et confiez à un bot. Il contient un script, et il peut déclarer des réglages du paquet et des actions. Voir Qu'est-ce qu'un paquet. réglages du paquet : les options qu'un paquet déclare, affichées dans l'onglet Réglages d'un bot. Voir Réglages et actions d'un paquet. Préférences : la page d'Asteroboard consacrée à sa langue, à son apparence et à l'adresse de votre Asterobot. Voir Préférences. Problèmes : les alertes en haut de la page d'un bot quand le bot n'a pas pu se connecter ou que son script s'est arrêté sur une erreur. Voir Page du bot. R Prêt pour un bot : ce qu'Asteroboard indique pour une version de jeu dont les fichiers du jeu sont téléchargés et dont les données de jeu sont extraites. Il vous faut une version dans cet état pour ajouter un bot. Voir Extraire les données de jeu. S script : le code JavaScript contenu dans un paquet. Voir Ce que peuvent faire les scripts. page Serveur : la page d'Asteroboard consacrée à Asterobot lui-même, avec ses onglets État, Console et Config. Voir État et console. réglage : une option d'Asterobot, comme server.listenAddress, modifiée dans Serveur > Config. Voir Référence des réglages. code de connexion : le code de huit caractères qu'Asterobot obtient quand il se connecte à asterobot.net. Vous le confirmez sur le site dans les 15 minutes. Voir Se connecter avec asterobot.net. Commencer l'attente : le bouton qui fait attendre votre client Dofus à un bot, en mode MITM. Voir Mode MITM. T version testée : la version de Dofus avec laquelle une version d'Asterobot a été testée. Une version de jeu qui lui correspond affiche Compatible, et toute autre affiche Version différente. Voir Pourquoi Asterobot télécharge Dofus. trafic : les messages qui transitent par un bot. Vous choisissez ceux qu'Asteroboard affiche. Voir Trafic réseau. authentification à deux facteurs : voir Ankama Shield.

Parcourez cette liste avant de télécharger Asterobot. La plupart des points se vérifient en quelques secondes, et quelques-uns dépendent du mode qu'utiliseront vos bots : Full socket ou MITM (« homme du milieu », de l'anglais man-in-the-middle ; voir Full socket et MITM). Un ordinateur pris en charge Asterobot est publié pour six combinaisons de système et de processeur : Système Processeur Par exemple Windows x86-64 (Intel ou AMD) La plupart des PC sous Windows Windows ARM64 Les portables équipés d'un processeur Snapdragon X macOS Apple silicon (ARM64) Les Mac équipés d'une puce de la série M macOS Intel (x86-64) Les Mac équipés d'un processeur Intel Linux x86-64 (Intel ou AMD) La plupart des PC et des serveurs Linux ARM64 Raspberry Pi 4 et 5, serveurs ARM comme Ampere ou AWS Graviton Les versions x86-64 nécessitent un processeur compatible avec le jeu d'instructions x86-64-v2, ce qui est le cas de tous les processeurs x86-64 fabriqués depuis 2009 environ. Sur un processeur plus ancien, elles ne se lancent pas. Un ordinateur Windows équipé d'un processeur ARM64 peut aussi faire tourner la version x86-64 grâce à l'émulation intégrée à Windows, mais la version ARM64 y est plus rapide et consomme moins de mémoire. Quel que soit le système sur lequel tourne Asterobot, il télécharge la version Windows des fichiers de Dofus. Un Mac ou une machine Linux convient aussi bien qu'un PC sous Windows. Télécharger Asterobot explique comment savoir quel processeur équipe votre ordinateur. Un navigateur web Asteroboard fonctionne dans un navigateur web, sur l'ordinateur où tourne Asterobot ou sur un autre appareil. La première fois, le navigateur a besoin d'une connexion internet pour charger https://asteroboard.asterobot.net. Ensuite, Asteroboard s'ouvre même sans connexion internet, tant qu'il peut joindre Asterobot. Un navigateur pour la connexion automatique à Ankama Ce point ne concerne que les bots Full socket, et seulement si vous voulez qu'Asterobot connecte vos comptes Ankama tout seul. Pour cela, Asterobot pilote un vrai navigateur sur l'ordinateur où il tourne : Google Chrome, Chromium ou Microsoft Edge, installé à son emplacement habituel. Un autre navigateur basé sur Chromium, comme Brave, Vivaldi ou Opera, fonctionne aussi une fois son chemin indiqué dans le réglage zaapmanager.browserPath. Sans l'un de ces navigateurs, vous pouvez toujours connecter chaque compte vous-même. Connexion automatique et Connexion manuelle expliquent les deux méthodes. Espace disque Quand vous téléchargez une version de jeu, Asterobot récupère les fichiers dont un bot a besoin, pas le jeu entier. Le total dépend de la version de Dofus, et l'extraction des données de jeu occupe de l'espace en plus des fichiers téléchargés. Quelques tailles sont utiles à connaître, toutes approximatives et variables au fil des mises à jour du jeu : Élément Taille approximative Quand il occupe de l'espace Illustrations de la carte du monde, incluses dans les fichiers dont un bot a besoin 545 Mo Pour chaque version de jeu que vous téléchargez Données des cartes, incluses dans les fichiers dont un bot a besoin 450 Mo, mesurés sur Dofus 3.6.10.10 Pour chaque version de jeu que vous téléchargez La musique du jeu 900 Mo Seulement si vous la téléchargez depuis l'onglet Musique de la page Jeu Fichiers et dossiers indique où tout cela est stocké. Accès réseau Asterobot écoute sur quelques ports et a besoin d'accéder à internet : Connexion Adresse par défaut À quoi elle sert D'Asteroboard vers Asterobot 127.0.0.1:8080 Tout ce qu'Asteroboard affiche et fait De Dofus vers Asterobot 127.0.0.1:5555 et 127.0.0.1:5556 Mode MITM uniquement : la connexion de votre jeu, puis sa session de jeu D'Asterobot vers internet Connexions sortantes asterobot.net et, côté Ankama, la connexion, les serveurs de jeu et les téléchargements du jeu Par défaut, ces trois ports n'acceptent que les connexions venant de l'ordinateur sur lequel tourne Asterobot : rien n'est donc ouvert sur votre réseau. Si un autre programme utilise déjà l'un d'eux, ou si vous voulez joindre Asterobot depuis un autre appareil, consultez Comment les parties communiquent. Les comptes et le jeu Un compte asterobot.net. Asterobot s'en sert pour se connecter dès son premier démarrage, et vous ne pouvez pas ajouter de bot tant qu'il n'est pas connecté. Voir Créer un compte asterobot.net. Pour le mode Full socket, un compte Ankama par bot. Les comptes protégés par Ankama Shield ou par l'authentification à deux facteurs ne peuvent pas servir dans ce mode. Voir Ajouter un compte. Pour le mode MITM, Dofus 3 installé avec l'Ankama Launcher. Vous n'enregistrez aucun compte Ankama dans Asterobot. Asterobot trouve le jeu dans le dossier habituel du launcher sous Windows et Linux ; sous macOS, vous indiquez le dossier vous-même. La version de jeu à laquelle vous jouez doit aussi être celle qu'Asterobot a téléchargée. Mode MITM donne les détails. Un outil pour ouvrir les archives .7z Asterobot est publié sous forme d'archives .7z : il vous faut donc un programme capable de les extraire, comme 7-Zip sous Windows ou la commande 7zz du paquet 7zip sous Debian ou Ubuntu. Télécharger Asterobot détaille chaque système. Pour aller plus loin Créer un compte asterobot.net si vous n'en avez pas encore. Télécharger Asterobot quand vous êtes prêt.

Un bot peut rejoindre Dofus de deux façons. En mode Full socket, il se connecte et joue seul, sans client de jeu. En mode MITM (« homme du milieu », de l'anglais man-in-the-middle), il rejoint la session d'un client Dofus sur lequel vous jouez. Mode Full socket Le bot fait lui-même ce que ferait un client Dofus. Asterobot se connecte à Ankama avec un compte Ankama que vous avez enregistré dans le Gestionnaire de comptes, choisit un serveur de jeu et ouvre la connexion vers celui-ci. Un paquet prend alors le relais : il identifie le bot sur le serveur de jeu, entre en jeu avec un personnage et joue. Personne n'a besoin de rester devant l'ordinateur et aucune fenêtre Dofus n'est ouverte. C'est ce qui fait du mode Full socket celui des bots qui tournent sans vous, y compris plusieurs comptes à la fois sur un même ordinateur. Le point délicat, c'est ce paquet. Asterobot n'identifie pas un bot sur le serveur de jeu par lui-même : un bot Full socket a donc besoin d'un script de connexion pour entrer en jeu. Note Bientôt disponible. Des scripts de connexion prêts à l'emploi sont en préparation. En attendant, Mode Full socket explique comment faire entrer un bot en jeu avec votre propre script. Mode MITM Vous lancez Dofus depuis l'Ankama Launcher et vous vous connectez comme d'habitude, et Asterobot se place au milieu, entre votre jeu et les serveurs d'Ankama, en faisant suivre tout ce qui passe dans les deux sens. Le bot qui reçoit votre session voit tout. Un paquet qui tourne sur ce bot peut réagir à ce qui se passe, envoyer ses propres messages, et même modifier ou bloquer des messages en chemin. Pour faire passer votre jeu par lui, Asterobot modifie une ligne d'un fichier de votre dossier Dofus, et remet cette ligne en place dès qu'aucun bot n'attend plus de jeu, ou quand Asterobot s'arrête. Vous ne donnez jamais votre identifiant ni votre mot de passe Ankama à Asterobot : vous vous connectez vous-même, dans le jeu, comme tous les jours. Côte à côte Full socket MITM Compte Ankama enregistré dans Asterobot Oui Non Client Dofus Pas nécessaire Nécessaire, installé avec l'Ankama Launcher Qui joue Un paquet Vous, avec un paquet si vous le souhaitez Paquet nécessaire pour entrer en jeu Oui, un script de connexion Non Comptes avec Ankama Shield ou authentification à deux facteurs Non pris en charge Pris en charge, puisque vous vous connectez vous-même Plusieurs bots Un compte Ankama par bot Un client Dofus par bot Version de jeu téléchargée par Asterobot Nécessaire Nécessaire, et ce doit être la même version que votre Dofus Un bot, deux façons Un bot n'appartient pas à un mode. Le mode, c'est ce que fait le bot quand vous le mettez en ligne, et la seule chose qui le limite, c'est d'avoir ou non un compte Ankama : Un bot avec un compte Ankama propose à la fois Connecter, qui le connecte tout seul, et Commencer l'attente, qui le fait attendre votre jeu. Un bot sans compte ne peut qu'attendre votre jeu. Connecter reste grisé, et son infobulle indique « Ce bot n'a aucun compte Ankama pour se connecter. » Un bot ne peut toutefois pas faire les deux en même temps. Un compte Ankama n'a qu'une session de jeu à la fois : un bot doit donc être déconnecté avant de passer d'un mode à l'autre. Lequel choisir Le mode MITM est le plus simple pour commencer. Il n'y a rien à enregistrer ni de script de connexion à trouver, c'est pourquoi Votre premier bot l'utilise. C'est aussi le mode pour observer ou enrichir la partie que vous jouez, et le seul qui fonctionne avec un compte protégé par Ankama Shield ou par l'authentification à deux facteurs. Le mode Full socket est fait pour les bots qui jouent sans vous : pas de fenêtre Dofus, personne au clavier, et autant de comptes Ankama que de bots. Choisissez-le dès que vous disposez d'un script de connexion pour vos bots. Pour aller plus loin Mode Full socket configure un bot qui se connecte tout seul. Mode MITM explique tout sur le relais de la partie que vous jouez. Prérequis liste ce dont chaque mode a besoin sur votre ordinateur.

Utiliser Asterobot, c'est utiliser trois éléments qui fonctionnent ensemble : Asterobot, le programme installé sur votre ordinateur ; Asteroboard, l'interface web depuis laquelle vous le pilotez ; et asterobot.net, le site web. Savoir quelle partie fait quoi rend la suite de ce guide plus facile à suivre, et vous indique ce qui continue de tourner quand vous fermez une fenêtre. Asteroboard, dans votre navigateur → Asterobot, sur votre ordinateur (127.0.0.1:8080) Votre client Dofus, en mode MITM → Asterobot, sur votre ordinateur Asterobot, sur votre ordinateur → asterobot.net Asterobot, sur votre ordinateur → Serveurs d'Ankama Asterobot Asterobot est le programme que vous téléchargez et lancez. Tout se passe à l'intérieur : vos bots et leurs connexions à Dofus, les comptes Ankama que vous enregistrez, les versions de jeu qu'il télécharge auprès d'Ankama, les paquets de votre bibliothèque et les scripts qu'ils exécutent. Il conserve vos réglages dans un fichier appelé config.toml, et le reste de ses données dans des dossiers de votre profil utilisateur, pas à côté du programme lui-même. Fichiers et dossiers les liste. Pendant qu'il tourne, Asterobot attend Asteroboard sur une adresse de votre ordinateur : 127.0.0.1:8080 par défaut. Cette adresse n'accepte que les connexions venant de l'ordinateur sur lequel tourne Asterobot. Ouvrez-la dans un navigateur et vous arrivez sur Asteroboard, déjà réglé pour dialoguer avec cet Asterobot. Asterobot n'a pas de fenêtre à lui. Sous Windows, il tourne dans une fenêtre de terminal, et sous macOS et Linux, vous le lancez depuis un terminal. Tant que ce terminal est ouvert, Asterobot tourne. Premier lancement montre comment le démarrer et l'arrêter. Asteroboard Asteroboard est l'interface web disponible à l'adresse https://asteroboard.asterobot.net. La page elle-même vient de cette adresse, mais tout ce qu'elle affiche vient de votre Asterobot : votre navigateur se connecte directement à l'adresse d'Asterobot, et Asteroboard affiche ce qu'Asterobot lui communique et lui transmet vos clics. C'est le même Asteroboard pour tout le monde. Il sait quel Asterobot est le vôtre parce que l'adresse est enregistrée dans votre navigateur, sur la page Préférences, sous URL du serveur. Cette adresse et vos préférences d'interface (langue, couleurs, disposition) sont les seules choses qu'Asteroboard conserve lui-même. Elles sont enregistrées dans le navigateur que vous utilisez : un autre navigateur ou un autre appareil démarre donc avec les valeurs par défaut. Vous pouvez installer Asteroboard comme une application depuis votre navigateur. Une fois chargé, il continue de fonctionner sans connexion internet, tant qu'il peut encore joindre votre Asterobot. Il se met aussi à jour tout seul : tant qu'il est ouvert, il vérifie toutes les 30 minutes si une nouvelle version existe et vous propose d'y passer quand vous êtes prêt. Visite d'Asteroboard détaille tout cela. Ce que la fermeture d'Asteroboard arrête Rien dans Asterobot. Quand vous fermez l'onglet ou l'application, vos bots restent connectés, leurs paquets continuent de tourner et les téléchargements se poursuivent. Rouvrez Asteroboard et il affiche l'état actuel des choses, et la console d'un bot commence par les 200 dernières lignes qu'Asterobot a conservées pour lui. Quelques éléments n'existaient que dans la page, et ils disparaissent avec elle : Les messages capturés par le panneau Trafic d'un bot, avec les lignes de chat que la console du bot en avait tirées. La liste des messages que le bot suit est enregistrée avec le bot et reste inchangée. L'inventaire affiché dans l'onglet Inventaire d'un bot, jusqu'à ce que le personnage entre de nouveau en jeu. Les lignes de Serveur > Console. Le choix Extraire les données après le téléchargement d'un téléchargement de jeu qui n'est pas terminé. Le téléchargement lui-même continue, mais son extraction ne démarrera pas toute seule. Vous pourrez la lancer plus tard depuis le Gestionnaire de jeux. La musique jouée depuis la page Jeu. Ce que l'arrêt d'Asterobot arrête Tout. Quand Asterobot s'arrête, tous les bots se déconnectent, y compris un bot qui relaie la partie que vous êtes en train de jouer : votre jeu est donc déconnecté lui aussi. Les scripts en cours s'arrêtent, tout comme les téléchargements en cours. Asteroboard affiche Serveur déconnecté et tente de se reconnecter jusqu'à ce qu'Asterobot tourne de nouveau. asterobot.net asterobot.net est le site web qui accompagne Asterobot. Vous vous en servirez pour : Votre compte asterobot.net. Asterobot s'en sert pour se connecter, grâce à un code que vous confirmez sur le site. Voir Se connecter avec asterobot.net. Télécharger Asterobot, depuis https://asterobot.net/files/category/3-asterobot/. Quand une version plus récente y est publiée, Asterobot vous le signale au démarrage. Le marché, la catégorie Library de https://asterobot.net/files/category/10-library/, où les joueurs partagent des paquets. Voir Le marché. Le forum, sur https://asterobot.net/forums/, pour demander de l'aide et discuter avec d'autres joueurs. La référence du protocole Dofus, sur https://asterobot.net/docs/dofus-protocol/, qui décrit les messages que le jeu échange. Ce sont surtout les auteurs de scripts qui s'en servent. Les annonces de l'équipe Asterobot vous parviennent aussi par Asterobot, sous forme de notifications dans Asteroboard. Sur des machines différentes Les trois parties n'ont pas besoin d'être sur le même ordinateur. Asteroboard peut s'ouvrir sur un téléphone ou un autre PC, et Asterobot peut tourner sur une machine distante. En mode MITM (« homme du milieu », de l'anglais man-in-the-middle), où un bot rejoint la partie que vous jouez, le client Dofus peut même se trouver sur un troisième ordinateur. Rien de tout cela ne fonctionne tel quel, car par défaut Asterobot n'accepte que les connexions venant de son propre ordinateur. Installations réseau explique chaque configuration et ce qu'il faut modifier. Pour aller plus loin Full socket et MITM explique les deux façons dont un bot se connecte. Prérequis liste ce qu'il vous faut sur chaque machine.

Asterobot est un programme que vous lancez sur votre propre ordinateur pour faire tourner des bots sur Dofus 3. Il fonctionne sous Windows, macOS et Linux, et vous le pilotez depuis Asteroboard, une interface web qui s'ouvre dans votre navigateur. Caution Utiliser des bots enfreint les conditions d'utilisation d'Ankama, et Ankama peut sanctionner les comptes concernés, quelle que soit la façon dont le bot se connecte. Lisez Comptes et sécurité avant d'utiliser Asterobot avec un compte auquel vous tenez. Ce que vous pouvez en faire Faire tourner des bots sans client de jeu En mode Full socket, un bot se connecte avec un compte Ankama que vous avez enregistré dans Asterobot et dialogue directement avec les serveurs d'Ankama, comme le fait le jeu lui-même. Aucune fenêtre Dofus n'est ouverte. Un seul ordinateur peut faire tourner plusieurs de ces bots, chacun avec son propre compte Ankama. Suivre la partie que vous jouez En mode MITM (« homme du milieu », de l'anglais man-in-the-middle), vous lancez Dofus depuis l'Ankama Launcher et jouez comme d'habitude, et un bot rejoint votre session de jeu. Depuis Asteroboard, vous pouvez lire votre chat et votre inventaire, observer les messages que votre jeu échange avec les serveurs, et donner au bot un paquet qui réagit à ce qui se passe. Pour cela, vous ne donnez ni votre identifiant ni votre mot de passe Ankama à Asterobot. Lancer des paquets Ce que fait réellement un bot vient d'un paquet : un petit programme JavaScript installé dans votre bibliothèque. Vous pouvez télécharger les paquets que d'autres joueurs partagent sur le marché d'asterobot.net, ou écrire les vôtres dans l'éditeur intégré à Asteroboard. Explorer les données de jeu Asterobot télécharge les fichiers du jeu Dofus auprès d'Ankama et en extrait le contenu : objets, monstres, cartes, textes et plus encore. La page Jeu d'Asteroboard vous permet de parcourir la carte du monde, d'inspecter une carte cellule par cellule, de chercher dans les données de jeu ou de les interroger en SQL, de consulter les textes du jeu et d'écouter sa musique. Rien de tout cela ne nécessite de bot. Observer et envoyer des messages Chaque bot dispose d'un panneau réseau. Il liste les messages que vous avez choisi de suivre au fur et à mesure qu'ils arrivent, avec leurs champs, et il vous permet d'envoyer vous-même un message, soit au serveur, soit au client de jeu. Ce qu'il ne fait pas tout seul Asterobot donne une connexion à un bot. Il ne lui donne pas d'objectif. Un bot sans paquet se connecte et s'en tient là : pas de combat, pas de récolte, aucune réponse aux autres joueurs. Tout cela vient d'un paquet, que vous l'installiez ou que vous l'écriviez. Le mode Full socket a une autre limite à connaître. Asterobot connecte le bot, choisit un serveur de jeu et ouvre la connexion vers celui-ci, mais il n'identifie pas le bot sur ce serveur : le bot n'entre donc jamais en jeu avec un personnage. Cette partie revient à un script de connexion, un paquet qui s'exécute quand le bot se connecte. Le mode MITM n'en a pas besoin, car le client Dofus sur lequel vous jouez s'en est déjà chargé. Note Bientôt disponible. Des scripts de connexion prêts à l'emploi sont en préparation. En attendant, utilisez le mode MITM, ou écrivez votre propre script de connexion à l'aide de la documentation développeur. À qui il s'adresse Asterobot s'adresse aux joueurs de Dofus qui veulent automatiser une partie de leur jeu, ou qui veulent voir ce que fait vraiment leur jeu. Vous n'avez pas besoin d'écrire de code pour l'utiliser : faire tourner un bot en mode MITM, installer un paquet depuis le marché et modifier ses réglages, tout se fait dans Asteroboard. Si vous écrivez du JavaScript, la documentation développeur couvre tout ce qu'un paquet peut faire. Vous pouvez aussi utiliser Asterobot sans jamais faire tourner de bot, simplement pour chercher des informations sur la carte du monde ou dans les données de jeu. Pour aller plus loin Les trois parties explique comment Asterobot, Asteroboard et asterobot.net s'articulent. Full socket et MITM vous aide à choisir comment vos bots se connectent. Prérequis liste ce qu'il vous faut avant de télécharger quoi que ce soit.

Asterobot signs in with your asterobot.net account, and the website is also where you ask for help. Why do I need an asterobot.net account? Because Asterobot signs in with it, and you can't add a bot until it's signed in. Asterobot also downloads marketplace packages with that account, and you need one to post on the forum. Create it on https://asterobot.net. See Create an asterobot.net account. Does Asterobot ask for my asterobot.net password? No. You only ever type it on asterobot.net. Asterobot gets a sign-in code, you confirm that code on the website, and Asterobot keeps its own sign-in from then on. See Sign in with asterobot.net. Where do I find the sign-in link? In three places: in the terminal, on the line after Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized.; in the browser tab Asterobot opens by itself, for the first code only; behind the account button at the bottom of Asteroboard's sidebar, which then reads Sign-in pending. See Sign in with asterobot.net. My sign-in code expired. What do I do? Wait a few minutes: Asterobot asks for a new code by itself. A code is valid for 15 minutes, and once it expires, the terminal prints Sign-in was not completed in time; it will be offered again. The account button then opens the new link. For a new code right away, reload Asteroboard, and click Sign in if the account button shows it. See Sign in with asterobot.net. Where's the code the Connect a device page asks for? In the sign-in link, after code=: eight characters, digits and letters from A to F. Opening the whole link fills it in for you. The Connect a device page shows up when the address was opened without it, and there, spaces, hyphens and small letters don't matter. See Sign in with asterobot.net. What does "Too many incorrect codes have been entered" mean? That 20 codes that didn't match were typed from your connection within 15 minutes. Wait: you can type codes again at most 15 minutes after the last wrong one. Next time, open the link from the account button rather than typing the code, since the link carries it. See Sign-in problems. Can I sign in from my phone? Yes. Turn on website.showQRCode on Server > Config, wait for the next code, and scan the QR code the terminal shows. It's handy when Asterobot runs on a machine without a browser. See Sign in with asterobot.net. Why is Asterobot asking me to sign in again? Because asterobot.net stopped accepting Asterobot's sign-in, for example once it expired or was revoked. Asterobot then forgets it and starts a new sign-in right away: the terminal shows a warning such as Website rejected the token, and the account button switches to Sign-in pending. Confirm the new code. See Sign in with asterobot.net. Is the sign-in shared between my devices? Yes, because it belongs to Asterobot, not to your browser. Every Asteroboard connected to the same Asterobot shows the same account, and signing out from one of them signs Asterobot out for all. Being signed in to asterobot.net in your browser doesn't sign Asterobot in. See Your account. How do I sign out, or switch to another account? Click the account button, then Log out, and confirm. Asterobot doesn't sign back in by itself afterwards, not even when it restarts, and if it starts while signed out, it skips every saved bot. To switch accounts, sign out of Asterobot, make sure your browser is signed in to asterobot.net with the other account, then click Sign in on the account button and confirm the new code. See Your account. Why does the Account page say Not signed in? Either Asterobot really isn't signed in, and the account button reads Sign in, or Asteroboard couldn't load your details from asterobot.net, and the button reads Signed in without your name. In the second case, the device you use Asteroboard on has to reach asterobot.net: check its internet access and the status page. See Your account. How do I know whether asterobot.net is down? Look at the status page, https://status.asterobot.net, also linked from Asteroboard's About page. Check it first when sign-in codes won't go through or marketplace previews fail. See Messages and updates. Where can I get help? On the forum and on Discord, and guides are at https://asterobot.net/help. Give your Asterobot and Asteroboard versions, how your bot connects, what you did and the exact error text. See Getting help. What must I never share when I ask for help? Your passwords, config.toml and the website.token it holds, accounts.toml, the sign-in browser profiles, Asterobot's data folder, the link you copy during a manual Ankama sign-in, and a session's game ticket. Anyone who gets one of them can use your accounts. See Getting help. Where are Asteroboard's release notes? At https://asterobot.net/release-note-asteroboard. The version number at the top of Asteroboard's sidebar links there. See Messages and updates.

Asteroboard talks to Asterobot over the network, even when both are on the same computer. Asteroboard says Server disconnected. What should I check? First, that Asterobot is running: its terminal window must be open. Then, that Asteroboard uses the right address. Open Preferences, look at Server URL, which is http://127.0.0.1:8080 by default, and click Test connection. Opening Asterobot's own address in the browser also sets Server URL for you. Meanwhile, Asteroboard keeps trying to reconnect by itself. See Asteroboard can't connect. How does Asteroboard know where my Asterobot is? It keeps the address as its Server URL, in your browser. When you open Asterobot's address, such as http://127.0.0.1:8080, Asterobot sends the browser on to https://asteroboard.asterobot.net with that address attached, and Asteroboard saves it. Each browser keeps its own. See How the parts connect. Does Asteroboard need an internet connection? Only to load the first time. After that, it opens without an internet connection, as long as it can reach your Asterobot. A few things still come from the internet, such as your asterobot.net name and avatar on the Account page. See The three parts. Does Asterobot need an internet connection? Yes, for anything that involves Ankama or asterobot.net. Asterobot reaches Ankama's servers to download game versions, sign accounts in and play, and asterobot.net to sign in, install packages and confirm your account. When it hasn't reached asterobot.net for more than an hour, it refuses to add a bot or to connect one in Full socket mode, and Connect shows this installation is not entitled to start bots. See How the parts connect and Many bots. Can I use Asteroboard on my phone? Yes, on your home network, once Asterobot serves HTTPS behind a password. On Server > Config, set server.basicAuth, turn on server.tls and set server.listenAddress to 0.0.0.0:8080, then restart Asterobot and allow port 8080 in the firewall. On the phone, open https:// followed by the computer's address and :8080, accept the certificate warning and enter the password. HTTPS and the password stop MITM mode from working. See Asteroboard on another device. Why can't my phone reach http://192.168.1.20:8080? Because browsers don't let the Asteroboard page, which comes over HTTPS, send plain http:// requests, except to the device the browser runs on. That's why http://127.0.0.1:8080 works on Asterobot's own computer while a network address doesn't. Use HTTPS on Asterobot, or an SSH tunnel. See Asteroboard on another device. Why does my browser warn about Asterobot's certificate? Because Asterobot makes its own certificate when you turn on server.tls. No authority your browser trusts signed it, and it only covers localhost, 127.0.0.1 and ::1, so browsers warn the first time and report that it doesn't match an address such as 192.168.1.20. Check that the address is your Asterobot's, then continue to the site. The certificate lasts 3 years and Asterobot doesn't renew it. See Asteroboard on another device. Why does Asteroboard stay disconnected after I typed an https address in Preferences? Because the certificate warning and the password prompt only appear on a page you open yourself, never for Asteroboard's own requests. Open the address in the browser first, accept the certificate and enter the password, and Asteroboard connects. See Asteroboard on another device. Why did MITM mode stop working after I turned on HTTPS or a password? Because MITM mode doesn't work while server.tls is on or server.basicAuth is set: Dofus can't fetch its connection settings from Asterobot then. Put both settings back to their defaults, restart Asterobot, and reach it from other devices through an SSH tunnel instead. See MITM mode. Can I reach my Asterobot from outside my home? Yes. Prefer an SSH tunnel: Asterobot keeps listening on its own computer only, nothing new is opened to the internet, and MITM mode keeps working. You can also open the port, with server.basicAuth and server.tls, but never without both. See Asterobot on a remote machine. Can I run Asterobot on a server or a Raspberry Pi? Yes. Asterobot doesn't need a screen, and there are Linux builds for x86-64 and ARM64 processors. You sign it in to asterobot.net with the link it prints or with a QR code, reach Asteroboard through an SSH tunnel, and keep it running with tmux, screen or a system service. See Asterobot on a remote machine. Can I play Dofus on one computer and run Asterobot on another? Yes, in MITM mode. On the computer that runs Asterobot, open its ports to the Dofus computer. On the Dofus computer, edit the ConfigUrl line of the version file yourself, since Asterobot can only edit files on its own computer, and put it back yourself when you're done. See MITM across machines. Which ports does Asterobot use? Port What it's for 8080 Asteroboard, and in MITM mode the connection settings Dofus fetches 5555 MITM mode: your game's sign-in. Open only while a bot waits. 5556 MITM mode: your game session. Open only while a bot waits. By default, all three only accept connections from Asterobot's own computer. See How the parts connect. What if port 8080 is already in use? Asterobot stops right after starting, with An error occurred during the server's initialization process, for example because another copy of Asterobot already runs. Asteroboard can't change the port while Asterobot isn't running, so edit config.toml: under [server], set listenAddress to another port, such as 127.0.0.1:8081, then start Asterobot and open that address. See How the parts connect. Can several devices use the same Asterobot? Yes. Every Asteroboard connected to the same Asterobot shows the same bots, library and asterobot.net account, since all of it lives in Asterobot. Each browser keeps its own preferences and its own Server URL. See How the parts connect. Can one Asteroboard control several Asterobots? One at a time. A browser keeps a single Server URL, so to switch, open the address of the Asterobot you want, or type it in Preferences. See Preferences. Who can control my Asterobot? Anyone who reaches its port. Asterobot has no user accounts of its own, so whoever gets through can use your bots and Ankama accounts, read every setting and shut it down. By default, only Asterobot's own computer can reach it. Read Security before you open it to anything else. Asteroboard shows an old version or behaves oddly after an update. What do I do? Use Reset offline data, in the Danger zone section of Preferences. It deletes the copy of Asteroboard your browser keeps and downloads it again, without touching Asterobot. See Preferences.

Questions people ask while writing packages. The developer docs cover each topic in full. Which language are scripts written in? JavaScript. Every file of a package is an ES module, and scripts can use the syntax of JavaScript up to ES2022, apart from three constructs: async generators, for await and import() called as a function. See JavaScript support. Can I write scripts in TypeScript? No. A package's files must end in .js or .mjs. You still get types: the editor checks your JavaScript the way TypeScript checks it, and JSDoc comments such as /** @type {BehaviorParameters} */ give your own code completion and checks. See JavaScript support. Can I use npm packages? No. There's no npm and no require(), and an import such as "lodash" is read as a dependency your package didn't declare, so the script doesn't load. To reuse code, import your own files with paths starting with ./, or turn the code into a package of your own and declare it as a dependency. See Modules and imports and Dependencies. Is there setTimeout or setInterval? No. sleep() from asterobot:timers is the only timer: await sleep(1500) pauses your function for 1.5 seconds without holding up the bot. For something that repeats, write a loop with await sleep() inside and start it from the entry function without awaiting it. For anything the game announces, a message handler is better than a loop. See Async and timing. Can a script use the internet? No. There's no fetch(), no WebSocket and no connection of any kind besides the bot's game connection. See What scripts can do. Can a script read or write files? No. A script only reaches the modules of its own package and of the packages it depends on. It has nowhere to keep data for its next run either: each start begins from scratch, and values is read-only. What a script needs again has to come from the game, or from a setting someone fills in. See Play, stop and reload. Can two bots share data? No. Each bot runs its own copy of the script, and two copies share no variables. A script can't see or control another bot either. See What scripts can do. Where do I find message names and fields? In three places: The Dofus protocol reference describes every message and what its fields mean. The package editor completes message names and payload fields as you type, and marks a field a message doesn't have. A bot's Tools > Network shows the messages the game really exchanges, with their values. On a MITM bot, do the action in Dofus and watch what goes through. Scripts read field names in camelCase, such as senderName for sender_name. See Finding messages. Are there functions to walk, fight or harvest? No. A script plays the way the Dofus client does: it sends the game's messages and reacts to what the server answers. Game data helps with the rest, such as finding which maps hold a given resource. See What scripts can do. Why doesn't my script get a Full socket bot into the game? Because a Full socket script has to identify the bot itself. Its first message on a new connection must be IdentificationRequest, sent when launch.reason is "initial", and choosing a character and entering the game are up to scripts too. Identify and run shows the lines every sample in these docs uses. Note Coming soon. Ready-made connection scripts will be available for you to run and reuse, so a package can depend on one instead of doing the identification itself. Until then, keep the identification in your own code, with the lines Identify and run shows. Which bot should I test my scripts on? A MITM bot on your own Dofus client. You make things happen in the game yourself and watch the script react, and no Ankama account has to be stored. Keep in mind that everything the script sends goes out as your character. See Identify and run. How do I restart a script after changing its code? Click Run in the editor, or Stop then Play on the bot's page. There's no Reload button. Saving alone doesn't change a script that's already running: the next start loads what you saved. See Play, stop and reload. How do I debug a script? Start with the bot's console: Check the editor's error badge before running. Write to the bot's Console with botInfo() and the other functions of asterobot:bot, and keep only Script in Sources. When the script stops on an error, The behavior stopped with an error appears at the top of the bot's page, with the full text and a Copy button. When a handler never seems to run, look at what really arrives in the Network tool. Logging and debugging goes through the whole routine. Why does my log show map[] instead of the error? Because Asterobot turns logged values into text itself, and an Error object comes out as map[]. Log String(error) or error.message instead. Other objects come out as map[...] too: JSON.stringify() reads better, once BigInt values are converted, since it throws on them. See Logging and debugging. Why did my script stop with JavaScript execution deadline exceeded? Some of your code ran for more than 250 ms without awaiting anything. Split long work with await sleep(0) now and then, and replace thousands of record() or text() calls in a row with one find() or query(). See Async and timing. Why are game texts and item names in French? Because every script started from Asteroboard uses the language fr, whatever language the bot is set to. text() and search() answer in that language. To read another one, query the _names table, which has a language column. See Game data overview. Can a script change its own settings? No. values is read-only: assigning to one of its properties throws a TypeError, and the setting keeps its value. Settings change when someone applies them on the bot's Settings tab. See Read settings. Will my script break when Dofus updates? It can. As long as Asterobot knows the game version, it keeps readable message names when the scrambled names on the wire change. But a patch can add, remove or change messages, an Asterobot update can rename a message, and game data tables and columns follow the game version. Read fields with ?., give every wait() a timeout, and check your script after each update. See After a game update. Are there example scripts? Yes. The tutorials are small complete scripts to copy and adapt, and the samples throughout the developer docs work on Full socket and MITM bots alike.

Packages are what bots run. You get them from the marketplace or write them yourself. What is a package? The code that tells a bot what to do. A package is a small set of JavaScript files, often with settings and buttons that show on the bot's page. You install packages in your library, then give one to each bot. See What is a package. Does a bot need a package? To do anything in the game, yes. A MITM bot connects without one, and you can already read its chat, inventory and messages in Asteroboard. A Full socket bot needs a connection script just to enter the game. See What is a package. Where do I find packages? On the marketplace, the Library category of asterobot.net: https://asterobot.net/files/category/10-library/. Copy the address of a file's page, then in Library Manager click Download package, paste it in File ID or URL, click Preview, then Install. Asterobot has to be signed in to asterobot.net. See Install from the marketplace. Is a package from the marketplace safe? Asterobot can't tell you. A package runs with your bot's game session and can do anything your character can. Asterobot's own check only proves that a marketplace package's files haven't changed since you downloaded them, not that its code is safe. Before you play one, read its file page on asterobot.net, look at its dependencies, read the code if you can, and keep the bot's console open the first time. See Trusting a package. What do Local, Community and Official mean? They say where a package's name comes from: Badge Name Where the package comes from Local A plain name, such as my-harvester You created, copied or imported it. Only local packages can be edited. Community @ the author, : the title, such as @some-author:auto-harvest A marketplace file published by an asterobot.net member Official @asterobot: and the title A marketplace file that asterobot.net marks as official The badge comes from the name alone, so a package imported from a .zip file can show Community or Official too. Only a package installed from the marketplace has a Source row on its page. See What is a package. Does the Official badge mean the code is safe? No. It tells you who published the package, not what its code does, and it doesn't replace reading the file's page. See The marketplace. Why can't I download a package? The two messages you can get mean different things: You don't have permission to download this file. under the preview card: the file's rules on asterobot.net don't let your account download it. There's nothing to fix in Asterobot. File not found, or you don't have permission to view it. after Preview: the file doesn't exist, the account can't see it, or Asterobot couldn't ask asterobot.net, for example because it isn't signed in. Check the address, then the account button at the bottom of the sidebar. See The marketplace. How do I update a package? In Library Manager, click Check for updates, then Update to followed by the version. The new version installs next to the old one, and your bots keep playing the old one until you move them. Nothing is checked automatically, and only packages installed from the marketplace can be updated this way. See Update packages. Do I lose my package settings when I update? No. Package settings are saved for each bot under the package's name, not its version, so a bot moved to the new version keeps them. Only a setting the new version removed, renamed or gave another type starts again from its default. See Update packages. Why does a package say Incompatible? The package states which versions of Asterobot it works with, and yours isn't one of them. It stays in your library but won't start. Update the package, or Asterobot, until the two match. See What is a package. Play only says Couldn't start the behavior. Where's the reason? On the bot's Settings tab, under Package settings. When the package can't be loaded, for example because it's incompatible or its files fail the integrity check with package source integrity mismatch, Couldn't read this package's settings appears there with the reason. Check first that the bot is Connected to game server: a package can't start on a bot that isn't. See Package errors. Can I edit a package I downloaded from the marketplace? No. Marketplace packages are read-only: Edit code isn't offered for them, and a package whose files were changed by hand is refused. To change one, Export it and bring it back with Import a .zip under a local name. That copy is yours to edit, but it no longer gets updates. See The editor. Can several bots play the same package? Yes. Each bot runs its own copy of the script, with its own package settings. See What scripts can do. How do I give a package to a friend? Export it as a .zip from its menu in Library Manager, and have your friend add it with Import a .zip. A package shared that way has no link to the marketplace, so it gets no updates. To share with everyone, publish it. See Share your package. How do I publish a package? Any asterobot.net member can. Export your package as a .zip, then submit a file in the Library category of asterobot.net, with that .zip as its only attachment, a title, which becomes part of the package's name, and your package's version. See Before you publish and Publish on asterobot.net. Where are packages stored? In the library/packages/ folder of Asterobot's data folder, one folder per version. See Files and folders.

Asterobot keeps its own copy of Dofus, separate from the one you play, and neither that copy nor Asterobot updates itself. Why does Asterobot download Dofus when I already have it? Because Asterobot works from its own copy of the game files. Bots, scripts and the Game page all read the game data, maps and texts from that copy, never from the Dofus you play. By default it only downloads the files a bot needs, not the whole game, and always the Windows version. See Why Asterobot downloads Dofus. How much disk space does it need? It depends on the Dofus version, and Asterobot doesn't give a total. A few sizes, all approximate: 545 MB for the world map artwork and 450 MB for the map data (measured on Dofus 3.6.10.10), both part of every game version you download, and 900 MB for the game's music, only if you download it from the Game page's Music tab. Extracting the game data takes more space on top of the files. Asterobot doesn't check the free space before a download. When the disk fills up, the download stops and its status turns to Failed. See Why Asterobot downloads Dofus. How do I free disk space? From Game Manager. Remove all chunks deletes the stored pieces game versions are rebuilt from, at the cost of a slower next download. Uninstall deletes a version's files and keeps its extracted game data, and Delete removes the version completely. Neither Uninstall nor Delete checks whether a bot still uses the version. See Manage game versions. Dofus just got a patch. What do I do? Download the new game version, move your bots to it, then remove the old one: In Game Manager, click Download a game, keep latest in Version and Extract data after downloading checked, and click Download. Keep Asteroboard open until the new row shows Ready for bot. On each bot, click Disconnect, choose the new version on its Settings tab, and click Save settings. Once no bot uses the old version, delete or uninstall it. It matters most in MITM mode, where your bot's game version must be the Dofus version you play. See When Dofus updates. Why does my MITM bot refuse to start waiting after a patch? Because the Dofus you play and your bot's game version are no longer the same version. Asteroboard shows Couldn't put the bot into waiting, without saying why. Download the new version, move the bot to it and click Start waiting again. When your bots use different game versions, keep them all on the version you play. See MITM mode. What do Compatible and Different version mean? Compatible means your release of Asterobot was tested with that Dofus version, and Different version means it wasn't. A different version isn't blocked, but the game's messages change from one version to the next, so a bot on it may fail to connect, and its game data may not match what you expect. See Why Asterobot downloads Dofus. What happens when Asterobot doesn't support the new Dofus version yet? Your bots may not work on it. You can meet Different version in Game Manager, a Full socket bot that doesn't connect and shows Couldn't connect this bot, a MITM game that gets disconnected as it reaches the bot, and scripts that can't start, with an error beginning with the game engine is not available:. When the reason tells you to update Asterobot, download its new release. See When Dofus updates. Does Asterobot update the Dofus I play? No. The Ankama Launcher updates your Dofus. Asterobot doesn't follow patches either: each patch is a new game version you download in Game Manager, and the versions already there stay as they were. See When Dofus updates. Can I keep several game versions? Yes. Each version has its own row in Game Manager, each bot uses the version set on it, and pieces of content that several versions share are stored once. See Manage game versions. How do I know a new Asterobot is out? Asterobot checks asterobot.net each time it starts. When a newer version is published, the terminal prints An Asterobot update is available, and Asteroboard shows Asterobot update available with a View on asterobot.net button. A version published while Asterobot runs is only noticed at its next start. See Messages and updates. How do I update Asterobot? Download the new archive, stop Asterobot, replace the program file with the new one, and start it again. On macOS and Linux, make the new file executable with chmod +x asterobot first. Your bots, accounts, packages, game versions and settings stay, since they live in other folders. After the update, bring your bots back online and look at the Compatibility column of Game Manager. See Updating Asterobot. Will my packages still work after an update? They can stop working in two cases. A package that states which versions of Asterobot it works with can turn Incompatible after you update Asterobot, and it won't start then. And a Dofus patch can change the messages a script relies on, until its author adapts it. Authors can read After a game update.

How bots connect, how many you can run, and what happens to them when things stop. Should I use Full socket mode or MITM mode? Start with MITM mode. You play Dofus as usual and the bot joins your session: there's nothing to store in Asterobot and no connection script to find, and it works with accounts protected by Ankama Shield or two-factor authentication. Full socket mode is for bots that play without you and without a Dofus window, but each bot needs its own Ankama account and a connection script to enter the game. See Full socket and MITM. Why doesn't my Full socket bot enter the game? Because Asterobot's part ends once the connection to the game server is open. It signs the account in, picks a server and connects, but it doesn't identify the bot on the game server or choose a character. A connection script does that: a package you start with Play. Connected to game server only means the connection is open, whether the bot got into the game or not. Note Coming soon. Ready-made connection scripts will take a Full socket bot into the game. Until then, use MITM mode, or write your own by following Identify and run. Full socket mode explains it in full, and Bot doesn't connect covers the errors. Can I play Dofus while a bot uses my account? In MITM mode, yes: that's what the mode is for. You keep playing, and a package running on the bot controls the same character as you, with nothing to coordinate the two of you. In Full socket mode, no. An Ankama account has one game session at a time, and a bot that connects while the account is already in the game fails with identification was refused: account already connected elsewhere. See MITM mode, and for script authors, Sessions. Does Asterobot change my Dofus installation? Only one line, and only in MITM mode. Asterobot edits the ConfigUrl line of Dofus_Data/StreamingAssets/version, in your Dofus folder, so your game signs in through Asterobot. It puts the original line back when no bot is waiting any more and when Asterobot stops normally, or the next time it starts after an abrupt stop, provided one of your bots comes back as it starts. It never installs or updates your Dofus. See MITM mode. Dofus won't sign in since Asterobot stopped. What do I do? Start Asterobot again. While that line points at Asterobot, Dofus can't sign in without it, and Asterobot puts the line back as it starts, provided one of your bots comes back with it. If the log doesn't show Restored a game install left pointing at Asterobot by a previous run, put the line back by hand. See MITM problems. Why does my MITM bot stay on Waiting for your game client? Your game isn't reaching the bot. The usual causes: Dofus was already open when the bot started waiting. Close it and start it again. botmanager.mitmGamePath is empty or points at the wrong folder. Asterobot's log shows Pointed the played game at Asterobot when it edited your Dofus folder. The bot is attached to another Ankama account. It only takes the sessions of the account it attached to the first time. server.tls is on or server.basicAuth is set. MITM mode doesn't work with either of them. See MITM mode and MITM problems. What happens to my game when I stop a bot? That depends on the button. Stop only stops the bot's script, and your game carries on. Disconnect on a MITM bot ends the session it relays, so your Dofus is disconnected if you're in the game. Stopping Asterobot does the same to every bot. See Disconnect, delete and restart. What happens when I quit Dofus in MITM mode? The bot goes back to Waiting for your game client and takes your next session by itself. The script it was running stopped, though: press Play again once your game is back. See MITM mode. How many bots can I run? As many as your asterobot.net account allows. Every bot listed in Bot Manager counts, connected or not, and past that number Add a bot fails with Couldn't add the bot. In Full socket mode, each bot also needs its own Ankama account, and in MITM mode each bot relays one Dofus client. See Many bots. Can two bots use the same Ankama account? No. An Ankama account can belong to one bot only, since Dofus allows one game session per account. Adding a second bot with it fails with Couldn't add the bot, and choosing it on a bot's Settings is refused with this account is already associated with a bot. Store one account for each Full socket bot. See Many bots. Can one bot use both modes? Yes, but not at the same time. A bot with an Ankama account offers both Connect and Start waiting, and a bot without one can only wait for your game. Disconnect the bot before you switch. See Full socket and MITM. Do my bots reconnect by themselves? No. Asterobot never connects a bot or starts a script on its own. After Asterobot restarts, every bot is Disconnected and nothing plays. When a Full socket bot's connection drops, click Disconnect, then Connect, then Play. See Disconnect, delete and restart. Are my bots kept when Asterobot restarts? Yes. Every bot is saved in bots.toml, with its settings, its package, its package settings and its message selection, and comes back disconnected when Asterobot starts. Its console history doesn't come back, and neither does an inline script loaded on it. See Disconnect, delete and restart. Why is a bot missing after I restarted Asterobot? Asterobot skipped it. That happens when the bot's Ankama account is no longer in Account Manager, when its game version is no longer installed, when Asterobot couldn't prepare Ankama sign-ins, or when it couldn't confirm your asterobot.net account in its first seconds. The terminal shows a warning starting with skipping bot restore:, followed by the reason. The bot's configuration is still saved: fix the cause and restart Asterobot. Don't add a new bot with the same name, which replaces the saved one for good. See Disconnect, delete and restart. I play several accounts in MITM mode. Which bot gets which game? Each game goes to the waiting bot attached to its Ankama account. The first time, a bot without an account attaches itself to the first account whose session it takes, in alphabetical order of the waiting bots, and keeps that attachment for good. To decide which bot relays which account, start waiting on one bot at a time and sign in with the account you want on it. See Many bots. Can I use other computers? Yes. Asteroboard can run on a phone or another computer, Asterobot on a server or a computer you don't sit at, and in MITM mode Dofus can even be on a third computer. None of this works with the default settings, which only accept connections from Asterobot's own computer. How the parts connect shows each setup, and Asteroboard and network answers the common questions.

Read these answers before you use Asterobot with an Ankama account you care about. Can my Ankama account get banned? Yes. Using a bot breaks Ankama's terms of use, and Ankama can sanction the accounts involved at any time. That holds in Full socket mode and in MITM mode, with a package you wrote or one from the marketplace. Nobody can promise that an account stays safe, and these docs give no advice on avoiding detection. Only use an Ankama account with Asterobot if you accept that risk. Is MITM mode safer for my account? No. A bot in MITM mode is still a bot, and it breaks Ankama's terms of use just the same. What MITM mode changes is who holds your login: you sign in yourself, in Dofus, and never give Asterobot your Ankama login or password. See Full socket and MITM. Where does Asterobot keep my Ankama password? In a file called accounts.toml, in Asterobot's data folder, as plain text, and only if you chose to store one. It isn't encrypted because Asterobot has to type it into Ankama's sign-in page. The same file holds each account's Login ID and the tokens Ankama gave Asterobot. On Linux and macOS, Asterobot restricts the file so only your user account can read it. On Windows that restriction has no effect. Either way, anyone who can open files as your user, or who gets a copy of the file, can read the password and use the tokens. Asterobot never sends the password back to Asteroboard. Add an account has the details, and Files and folders shows where the data folder is. Do I have to store my Ankama password? No. The password only serves automatic sign-in. Without one, you sign the account in yourself from Asteroboard whenever its sign-in stops working, as Manual sign-in shows. MITM mode needs no stored account at all. What else on my computer gives access to my accounts? A few files and folders, each worth protecting like a password: What Where What it gives access to accounts.toml The data folder Your Ankama Login IDs, the passwords you stored, and Ankama's tokens zaapmanager/browser-profiles/ The data folder A live Ankama session for each account that signed in automatically website.token config.toml, in the settings folder Your asterobot.net account, through Asterobot's sign-in server.basicAuth config.toml Asterobot's port, with passwords written in plain text On Linux and macOS, only your user can read these. On Windows, that protection has no effect. Never share any of them, not even to get help: Getting help lists what must stay private. Can I use an account protected by Ankama Shield or two-factor authentication? Only in MITM mode. Full socket mode doesn't support these accounts: Asteroboard has no field for a verification code, and automatic sign-in only types the Login ID and the password. In MITM mode, you sign in yourself in Dofus, codes included, and the bot relays that session. See Shield and two-factor authentication. What happens when Ankama shows a captcha during automatic sign-in? Asterobot gives up, and a person has to sign in. You have two ways out: Sign in yourself from the sign-in dialog. This always works, wherever Asterobot runs. When Asterobot runs on a computer you're sitting at, turn off zaapmanager.browserHeadless on Server > Config, start the automatic sign-in again, and answer the challenge in the browser window that opens. Turn the setting back on afterwards. See Automatic sign-in. Why doesn't Asteroboard say why automatic sign-in failed? Because its message is the same whatever went wrong, starting with ankama account authorization required. The real reason is only in Asterobot's log. In the terminal or on Server > Console, look for the warning Automatic Ankama sign-in failed, a person has to sign in: its error says what happened. When you started the sign-in from the dialog's own button, the dialog also shows a picture of the page the browser was on, which often tells a captcha from a wrong password. See Automatic sign-in. What can a package do with my account? Everything your character can do in the game. A package's script can send any message to the game server as your character, to move, fight, trade, sell or delete items. It reads everything the game sends, can read the session's game ticket and can close the game connection. On a MITM bot, it can also change or block what your Dofus and the server send each other. It can't read your Ankama login or password, open files on your computer, use the internet or reach your other bots. Only play packages from authors you trust. Trusting a package lists everything. Do package permissions limit what a package can do? Not yet. A package can list permissions in its manifest, but Asterobot doesn't enforce them: a package that lists none can still do everything described above. Note Coming soon. Asterobot will enforce the permissions a package lists. Until then, don't count on them to limit what a package does. See Trusting a package. What do I do if I think someone used my Asterobot? Stop Asterobot, or put server.listenAddress back to 127.0.0.1:8080 and restart it. Then change the basic auth passwords, click Disconnect on each Ankama account in Account Manager, change the Ankama passwords you had stored, and log Asterobot out of asterobot.net before signing in again. Security goes through each step, and explains who can reach Asterobot in the first place.

The basics: what Asterobot is, where it runs, and what keeps working when you close things. What is Asterobot? Asterobot is a program you run on your own computer to run bots for Dofus 3. A bot either signs in and plays on its own, in Full socket mode, or joins the game you play, in MITM mode (short for man-in-the-middle). What a bot does in the game comes from a package: a small JavaScript program from the marketplace, or one you write. Asterobot also lets you browse the game's data, maps and texts without any bot. What is Asterobot gives the full tour. What's the difference between Asterobot, Asteroboard and asterobot.net? Asterobot is the program that does the work, Asteroboard is the web interface you control it from, and asterobot.net is the website. Asteroboard opens at https://asteroboard.asterobot.net, but everything it shows comes straight from your Asterobot. asterobot.net holds your account, the downloads, the marketplace and the forum. See The three parts. Which systems does Asterobot run on? Windows, macOS and Linux, each on x86-64 (Intel or AMD) and ARM64 processors. That makes six builds, including one for Macs with Apple silicon and one for ARM boards such as the Raspberry Pi 4 and 5. The x86-64 builds need a processor with the x86-64-v2 instruction set, which every x86-64 processor made since about 2009 has. Requirements lists everything else you need. Which Dofus does it work with? Dofus 3. Bots only play Dofus 3, and Asterobot always downloads the Windows version of its game files, even on macOS or Linux. Each release of Asterobot is tested with one Dofus version, which Asteroboard marks Compatible. Why Asterobot downloads Dofus explains the tested version. Do I need Dofus installed? Only for MITM mode, where you play Dofus yourself and a bot joins your session. A Full socket bot needs no Dofus client at all. Either way, Asterobot downloads its own copy of the game files, separate from the Dofus you play. Full socket and MITM compares the two modes. Do I need to know how to code? No. Running a bot in MITM mode, installing a package from the marketplace and changing its settings all happen in Asteroboard. You need JavaScript to write packages of your own, and for now to get a Full socket bot into the game. Note Coming soon. Ready-made connection scripts will take a Full socket bot into the game without any code from you. Until then, use MITM mode, or write your own with Identify and run. Can I use Asterobot without running a bot? Yes. With a game version downloaded and extracted, the Game page lets you browse the world map, inspect maps cell by cell, search the game data, query it in SQL, read the game's texts and listen to its music. See Game page. Can I leave my bots running all day? Yes, as long as Asterobot keeps running and each bot's connection lasts. Asteroboard doesn't need to stay open. Keep in mind that nothing reconnects or starts again by itself: when a bot's connection drops, or when Asterobot restarts, you bring the bot back online and press Play yourself. In MITM mode, every session also starts with someone launching Dofus. Disconnect, delete and restart covers each case, and Asterobot on a remote machine shows how to keep Asterobot running on a machine you don't sit at. What happens when I close the browser or Asteroboard? Nothing stops. Your bots stay connected, their scripts keep running and downloads carry on, because all of that happens inside Asterobot. What only lived in the page goes away with it: the messages a bot's Traffic panel had captured and the chat lines its console showed from them, the contents of a bot's Inventory tab until the character enters the game again, the lines on Server > Console, the Extract data after downloading choice of a download that hasn't finished, and the music playing from the Game page. See The three parts. What happens when I close Asterobot's terminal window? Asterobot stops, and everything with it. Every bot disconnects, including a bot relaying the game you play, so your Dofus is disconnected too, and scripts and downloads stop. To stop it cleanly, press Ctrl+C in its terminal or click Shutdown server on Server > Status. Asterobot then also puts back the line it changed in your Dofus folder for MITM mode. After an abrupt stop, it puts that line back the next time it starts, provided one of your bots comes back with it (MITM problems). See First launch. Can Asteroboard start Asterobot again? No. Once Asterobot has stopped, you need access to the computer it runs on to start it. Meanwhile Asteroboard shows Server disconnected, and connects again by itself as soon as Asterobot is back. See First launch. Does Asterobot update itself? No. When a new version is out, Asterobot tells you as it starts, and you replace the program by hand. Your bots, accounts, packages, game versions and settings are kept. Asteroboard, on the other hand, updates itself. See Updating Asterobot. Is there an app? Asterobot has no window of its own: on Windows it runs in a terminal window, and on macOS and Linux you start it from a terminal. Asteroboard can be installed as an app from your browser, and then opens in its own window. See Tour of Asteroboard. Which languages is Asteroboard available in? English, French and Spanish. It follows your browser's language, and starts in French when your browser uses another one. To change it, open Preferences and pick one under Language. See Preferences. Where does Asterobot keep its files? In folders of your user profile, not next to the program: one for its settings, with config.toml, one for its data, such as bots, Ankama accounts and packages, and one for its cache, which holds the game versions. Files and folders shows where they are on each system and how to back them up. How do I reset Asterobot or start over? Pick the smallest reset that fixes your problem, since each one deletes something for good. Reset offline data and Reset preferences, on Preferences, only clear what Asteroboard keeps in your browser. Reset all, on Server > Config, puts your settings back to their defaults and signs Asterobot out of asterobot.net. cache reset deletes every game version, and keeps your settings, bots, Ankama accounts and library. Reset and start over helps you choose.

Everything you do in Dofus turns into messages between your game and Ankama's servers. This tutorial shows a few of them live on the MITM bot from Your first bot, while you walk and chat. No package is needed. Caution Don't tick IdentificationRequest for this tutorial. It's the first message your game sends, and it carries the ticket that opens your game session: never share a screenshot or a copy of it. 1. Bring your bot online On your bot's page, click Start waiting. Start Dofus from the Ankama Launcher, sign in and enter the game with your character. The bot's status turns to Connected to game server. 2. Choose a few messages On the bot's page, click Tools. The Network tool opens on its Traffic panel. Click Settings. The list holds every message Asterobot can name, with a box to tick for each. Type MapMovement in Filter messages..., then tick MapMovementRequest and MapMovementEvent. Replace the filter with ChatChannelMessage, and tick ChatChannelMessageEvent. If you turned on Live chat in Your first bot, it's ticked already. Click Apply. The button shows how many messages are ticked, and a notification confirms how many message types the bot now mirrors. Message Sent by What it says MapMovementRequest Your game Your character asks to walk along a path of cells. MapMovementEvent The server Someone on your map walks along a path: your character or another one. ChatChannelMessageEvent The server A chat message reaches you. 3. Play and watch Click Traffic. In Dofus, click a cell to walk there. A MapMovementRequest row marked Out appears, and a MapMovementEvent row marked In comes after it. Wait for other players to move on your map: each of their walks adds a MapMovementEvent row. When a chat message reaches you, a ChatChannelMessageEvent row appears, marked In. New rows arrive at the bottom, and the list follows them while you're at the bottom. Pause freezes the list, but messages that arrive while it's on aren't kept. The colour of each row tells the kind of message: Network traffic explains them. 4. Read a message Click a MapMovementEvent row. It opens and shows every field of the message as JSON. Find cells: the path the character walks, as a list of cell numbers. Another field holds the id of the character that moves, which tells your own walks from other players'. Click a ChatChannelMessageEvent row and find content: the text of the message. Large numbers, such as ids, show as text in quotes. To keep one kind of message in the list, type name:MapMovementEvent in the search box above it. The Dofus protocol reference describes every message and field. 5. Tidy up The messages you chose stay selected with the bot, and Asterobot keeps passing them on to Asteroboard, until you untick them. When you no longer need them, untick them in Settings and click Apply again. Clear, on Traffic, empties the list, and removes the chat lines from the Console tab too. When you're done, quit Dofus, and click Disconnect if you want the bot to stop waiting. Where to go next Network traffic, for the search syntax and every part of the panel. Send messages by hand React to messages, to act on a message in a script of your own.

This tutorial takes a package from the marketplace on asterobot.net to your bot, and runs it while you watch what it does. It uses the MITM bot from Your first bot: set that one up first if you haven't yet. Caution A package acts as your character: it can send any message to the game server in your name. Read Trusting a package before you run one, and remember that using bots breaks Ankama's terms of use (Accounts and safety). 1. Pick a package Open the marketplace, https://asterobot.net/files/category/10-library/. Open the page of a package that interests you, and read what it does, what its author says it needs, and who published it. Copy the page's address from your browser. 2. Install it In Asteroboard, open Library Manager and click Download package. Paste the address in File ID or URL, then click Preview. Check the card. Official or Community tells whether asterobot.net marks the file as official, and Will install as gives the name and version the package will have in your library. Click Install. Package installed appears, and the package gets a row in Library Manager, along with its dependencies if it has any. If a message shows up instead, Install from the marketplace explains it. 3. Give it to your bot Bring your bot online: on its page, click Start waiting, then start Dofus, sign in and enter the game with your character. The status turns to Connected to game server. Open the bot's Settings tab. It opens on Bot configuration. Under Package, pick the package you installed, listed as name@version. Click Save settings. Asteroboard shows Settings saved, and the bot's header now shows the package. The bot keeps this package from now on, across restarts. Run a package shows the other ways to choose one. 4. Change its settings Still on Settings, click Package settings, next to Bot configuration. The first card belongs to your package, and it's open. Its fields and their descriptions come from the package. Change a value. Not applied appears on the card's title. Click Apply. A notification confirms that the package's settings are applied. If the section says "This behavior declares no settings and no actions.", the package has nothing to adjust: go on to the next step. Package settings and actions covers every kind of field, and what happens when a value is refused. 5. Play and watch In the bot's header, click Play. It turns into Stop: the package's script is running. Open the Console tab. Lines from the Asterobot and Script sources appear as they're written. To follow the script alone, keep only Script ticked under Sources. Play as usual, or let the package do its job, and follow the console. Settings you apply while the script runs reach it straight away, without a restart. Whether it acts on them at once depends on how the package is written. If Play stays greyed out, the bot isn't connected to a game yet. If Couldn't start the behavior appears, or the alert The behavior stopped with an error shows up at the top of the page, see Run a package. When you quit Dofus, the relayed session ends and the script stops with it, with The behavior stopped with an error. Click Play again the next time you're in the game. 6. Stop Click Stop in the bot's header. The script ends and the bot stays connected: your game carries on as usual. When you're done playing, quit Dofus. The bot goes back to Waiting for your game client. To stop it waiting, click Disconnect. Next time, click Start waiting, enter the game and click Play: the bot still has the package and its settings. Where to go next Update packages, when the author publishes a new version. Console, for everything the console can filter and copy. Developer docs, to write a package of your own.

This tutorial finds where a resource grows, using the world map of a game version, then opens the maps of that region. It takes a few minutes and needs no bot. You only need a Dofus version that's downloaded and extracted in Game Manager: Download a game version sets one up. 1. Open the world map In the sidebar, open Game Manager. On your Dofus version's row, click the game's name or Inspect. The version's Game page opens. Open the Maps tab. It starts on the World view. In the page's header, set Language to the language you know the resource's name in. 2. Search for the resource Click the search box, "Search for a monster, resource, item...", and type the start of the resource's name. Each word you type matches the start of a word in the name. Results appear as buttons while you type. A resource is an item: its button shows its name, the table it comes from, items, and its number after #. Two records can share a name, and the number tells them apart. Click the resource. The world map highlights the regions where the resource can be found, and a button above the map shows its name with the number of highlighted regions. Click that button later to remove the highlight. Two things to know about the highlight: It covers the regions where the resource is gathered, and also the regions of the monsters that drop it. Step 3 tells them apart. Regions on another world map, or without an outline, can't be highlighted. They're listed after "Also in:", and clicking one shows it in the region panel. When the button says the resource "appears on no region here", look at "Also in:", or pick another world map in the list at the top left. 3. Check a region Click a highlighted square. The region panel under the map describes its region. Look at Harvestables, with its count. If the resource is in that list, it grows in this region. Point at it to read "Gathered with" and the job that gathers it. If it isn't there, look at Drops: the region is highlighted because one of its monsters drops the resource. Note the region's Level badge, and whether it has a Zaap button, which opens the map of the zaap that serves the region. The game data lists resources by region, not by map or by cell, so the panel can't say on which maps of the region the resource grows. Its note, "Gathered on the maps of this area.", is a reminder of that. 4. Walk through the region's maps In the region panel, click the button that opens its maps, such as Open the 12 map(s). The Map view opens on the first map of the region. Under View, keep Terrain. Cells the game marks for harvesting take the Harvest colour of the legend, and Summary, under the map, counts them as Harvest cells. Under Layers, check that Interactive is on: it puts a dot on each cell where an interactive element stands. Click the arrows on the sides of the map, or press the arrow keys, to move to the neighbouring maps. To go back to the world map, click the button that shows the map's coordinates, such as Show at [4, -19] on the world map. Neither the cell colours nor the dots say what stands on a cell: the map data doesn't name the resource of each spot. They show you where to look, and the game shows the rest once you're there. Tip Click Split at the top of the tab to keep the world map next to the map you walk through, and turn on Follow the map so the world map stays centred on it. Where to go next World map and Map viewer explain everything these views show. Game data shows a resource's full record, which the "Open in game data" button next to each search result opens.

When something is broken and nothing else helps, a reset puts part of Asterobot or Asteroboard back in a clean state. Every reset deletes something for good, so start with the smallest one that can fix your problem. The resets below go from the lightest to the most drastic. Choose a reset Problem Reset Section Asteroboard shows an old version, or behaves oddly after an update Reset offline data Reset offline data Asteroboard's language, colors or layout are wrong Reset preferences Reset preferences A setting you changed broke something That setting's reset, or Reset all Asterobot's settings Asterobot won't start because of a setting Edit config.toml, or run config reset Asterobot won't start because of a setting One game version is broken, or the disk is full Verify files, Re-extract data, Uninstall, Delete or Remove all chunks Game versions Every game version at once cache reset cache reset One bot, account or package is broken, or Asterobot uses the wrong asterobot.net account Remove that one thing One thing at a time Everything, as on a new computer Delete Asterobot's folders Start completely over In your browser Asteroboard keeps a few things in each browser you use it in. Both of these buttons are on Preferences, in the Danger zone section, and neither touches Asterobot: your bots, accounts, packages and settings stay as they are. Your browser asks you to confirm each one, then the page reloads. Reset offline data Deletes the copy of Asteroboard your browser keeps to open quickly and to work offline, then downloads Asteroboard again, which needs an internet connection. Click Reset offline data. Confirm "This clears all offline data cached by Asteroboard and reloads the page. Continue?" It keeps your preferences and your Server URL. The button is greyed out when your browser can't run Asteroboard offline at all. If the reset fails, Asteroboard shows Couldn't reset offline data, with "Try again, or clear this site's data from your browser's settings." Reset preferences Puts Asteroboard's language, color mode, colors, radius and sidebar layout back to their defaults, and the language of game texts on the Game page back to following Asteroboard's language. Click Reset preferences. Confirm "This resets language, appearance and dashboard layout preferences back to their defaults and reloads the page. Continue?" It keeps the Server URL, the level buttons of Server > Console, and a few other choices such as the world map layers and the music volume. Preferences compares the two buttons. To remove everything Asteroboard stored in a browser, the Server URL included, clear the site data of asteroboard.asterobot.net in that browser's settings. Afterwards, open Asterobot's own address, http://127.0.0.1:8080 by default, to set the Server URL again. Asterobot's settings On Server > Config, you can reset one setting with Reset to default at the end of its row, one group with the button in its card's header, or every setting you changed with Reset all, which asks Reset every modified setting? first. A reset puts the default back and removes the value from config.toml. Settings marked Restart required take their default at the next start. Warning Once Asterobot is signed in to asterobot.net, its sign-in is a modified setting, website.token. Reset all, or resetting the website group, signs Asterobot out, and you'll have to confirm a new sign-in code. Your bots, Ankama accounts, packages and game versions are kept. The Config page explains each button. Asterobot won't start because of a setting When a setting keeps Asterobot from starting, such as a server.listenAddress it can't listen on, Asteroboard can't reach it to change anything. Fix config.toml instead: Open config.toml with a text editor. Files and folders shows where it is. Remove the line of the setting that causes the problem. A setting without a line takes its default. Save the file and start Asterobot. If you don't know which setting it is, use config reset. config reset config reset empties config.toml and puts every setting back to its default. Stop Asterobot, if it runs. Open a terminal in the folder where you put Asterobot and run: ./asterobot config reset On Windows, in PowerShell: .\asterobot.exe config reset If you start Asterobot with --config-dir or ASTEROBOT_CONFIG_DIR, give the command the same folder. When it asks Put every setting back to its default value? [y/N], type y and press Enter. It prints Resetting the configuration.. then All configuration settings have been reset to their default values. Start Asterobot, and confirm the asterobot.net sign-in code it asks for. Any other answer to the question stops the command, and nothing changes. It deletes It keeps Every setting you changed Your bots The asterobot.net sign-in Your Ankama accounts and their sign-ins server.listenAddress, server.basicAuth and server.tls, which go back to accepting this computer only, without a password Your packages Your MITM ports, hosts and Dofus folder, and your automatic sign-in settings Your game versions and their game data If you had clicked Log out before, that choice goes too: Asterobot asks you to sign in again by itself. Command line has more about the command. Game versions These actions are in each version's menu in Game Manager, except Remove all chunks, which sits above the table. From the gentlest: Action It deletes It keeps Verify files The files that don't match, which it downloads again Everything else Re-extract data The game data, which it builds again from the files The files Remove extracted data The game data, the extracted pictures and the extracted music The files and the row Uninstall The downloaded files The row and the game data Delete The files, the game data and the row The shared chunks Remove all chunks Every stored chunk, for every version Every version's files and game data Warning None of these checks whether a bot uses the version. A bot that signs in on its own can't connect with a version that isn't ready, and a bot whose version was deleted is skipped when Asterobot starts. Move your bots first, as When Dofus updates shows. Manage game versions explains each action. cache reset cache reset deletes Asterobot's whole cache folder, then creates it again, empty. Stop Asterobot with Ctrl+C in its terminal, or with Shutdown server. It must not run during the reset, and stopping it normally puts back the line it may have changed in your Dofus folder, which it can't do once its copy of the game is gone. Open a terminal in the folder where you put Asterobot and run ./asterobot cache reset, or .\asterobot.exe cache reset in PowerShell on Windows. If you start Asterobot with --cache-dir or ASTEROBOT_CACHE_DIR, give the command the same folder. When it asks Delete <folder> with everything in it? [y/N], check that <folder> is the cache folder you mean, then type y and press Enter. It prints Resetting the cache.. then All cache have been removed. Start Asterobot, then download and extract the game versions your bots use. It deletes It keeps Every game version, with its files and game data The settings folder: config.toml and the asterobot.net sign-in Every stored chunk The data folder: bots, Ankama accounts and library Ankama's download lists The screenshots of failed automatic sign-ins Bots set to a deleted game version are skipped when Asterobot starts, until you download and extract that version again. Command line has more about the command. One thing at a time To remove Where What goes What stays A bot Delete bot in the bot's menu in Bot Manager, then Yes, delete The bot, its settings, package settings, message selection, console history and MITM attachment Its Ankama account An Ankama account's sign-in Disconnect in the account's menu in Account Manager Its tokens. Asterobot asks Ankama to revoke them, and forgets them either way The account and its stored password An Ankama account Remove in the account's menu in Account Manager, then Yes, remove The account, with its password and tokens. Nothing is revoked with Ankama Its browser profile, its last failure screenshot, and the bots that use it A package version Remove in the package's menu in Library Manager, then Yes, remove That version Other versions, the packages it depends on, and the bots set to it The asterobot.net sign-in Log out in the account button's menu Asterobot's sign-in. It stays signed out, even after a restart, until you click Sign in Everything else What follows from each: A bot that used a removed account can't connect, and it's skipped at the next start until the account is back with the same Login ID. See Account status and actions. A bot set to a removed package version can't start its script until you move it to another version. See Manage your library. While Asterobot is signed out, it can't add bots or download packages, and it skips every saved bot when it starts. See Your account. A deleted bot only comes back if you add it again from scratch. See Disconnect, delete and restart. Start completely over Deleting Asterobot's folders takes it back to its first launch. Nothing is stored next to the program, so deleting or replacing the program file alone changes nothing. Caution These folders hold your Ankama passwords and tokens and your asterobot.net sign-in. Deleting them is final: back up anything you might need first (Files and folders). Stop Asterobot with Ctrl+C in its terminal, or with Shutdown server on Server > Status, so it puts back the line it may have changed in your Dofus folder. Once its cache folder is gone, it can no longer read the original line back. Delete the folders you want to reset. Files and folders shows where each one is on your system. Start Asterobot. It creates the folders again, empty, and asks you to sign in to asterobot.net, as on its first launch. What each folder takes with it: Folder Deleting it loses Settings config.toml: every setting you changed, and the asterobot.net sign-in Data bots.toml with every bot, accounts.toml with your Ankama accounts, your library of packages, the HTTPS certificate and the sign-in browser profiles Cache Every game version with its game data, the stored chunks, Ankama's download lists and the screenshots of failed sign-ins If you start Asterobot with folder options or their environment variables, the folders to delete are the ones they name (Command line). Asteroboard's Server URL and preferences live in each browser, not in these folders. Clear them as described in In your browser if you want them gone too. Where to go next Files and folders Command line Getting help