Smooth

Ankama Shield et l'authentification à deux facteurs ajoutent une étape à la connexion d'un compte, comme un code à saisir ou un appareil à approuver. Asterobot ne prend pas en charge ces comptes en mode Full socket. Ils fonctionnent en mode MITM, pour « homme du milieu » (man-in-the-middle), où vous vous connectez vous-même, dans Dofus. Non pris en charge en mode Full socket En mode Full socket, Asterobot doit franchir la connexion d'Ankama puis le serveur de connexion du jeu sans personne pour l'aider. Il n'a rien pour l'étape supplémentaire qu'exigent ces comptes : Asteroboard n'a aucun champ pour un code de vérification, et la connexion automatique ne saisit que l'identifiant et le mot de passe. Quand Asterobot identifie le bot sur le serveur de connexion du jeu, le certificat Shield qu'il envoie est toujours vide, tout comme le certificat qu'il transmet à Ankama quand il demande une connexion au jeu. Donc, même si un tel compte finit par afficher Connecté, le mode Full socket ne le prend pas en charge : ne l'utilisez pas pour des bots en Full socket. Ce que vous verriez Asterobot n'a pas de message dédié à ces comptes. Ce que vous rencontrez dépend de l'étape où Ankama bloque : La connexion automatique échoue. Le journal d'Asterobot affiche ankama did not accept the sign-in (wrong password, a verification step, or a challenge raised after submitting), parce que le navigateur ne peut pas passer l'étape de vérification. Voir Connexion automatique. La connexion manuelle se fait dans votre propre navigateur, où vous pouvez répondre vous-même à la vérification d'Ankama : le compte peut donc arriver à Connecté. La connexion d'un bot est l'étape où tout s'arrête. Quand Ankama refuse, la raison qu'il donne apparaît dans l'alerte Impossible de connecter ce bot du bot. Un refus du serveur de connexion du jeu s'affiche sous la forme identification was refused: suivi de la raison d'Ankama. Le bot ne se connecte pas liste les erreurs de connexion. Utiliser plutôt le mode MITM En mode MITM, vous lancez Dofus depuis l'Ankama Launcher et vous vous connectez comme d'habitude, Shield et codes compris. Asterobot se place entre votre jeu et les serveurs d'Ankama, et le bot relaie la session ouverte par votre jeu. Asterobot ne connecte jamais le compte, et vous ne l'enregistrez pas du tout dans le Gestionnaire de comptes. Ajoutez un bot sans compte, et choisissez Attendre mon client de jeu sur son onglet Connexion. Voir Ajouter un bot. Lancez Dofus depuis l'Ankama Launcher et connectez-vous avec le compte protégé. Le bot affiche alors Connecté au serveur de jeu, et il peut lancer des paquets comme n'importe quel autre bot. Votre premier bot détaille cette installation étape par étape, et Mode MITM l'explique en entier. La contrepartie : quelqu'un doit lancer Dofus et se connecter à chaque session. Full socket et MITM compare les deux modes. Pour aller plus loin Mode MITM Comptes et sécurité

Chaque compte du Gestionnaire de comptes affiche des badges pour son état et dispose d'un menu d'actions. Un badge Connecté signifie seulement qu'Asterobot détient la connexion du compte, pas qu'Ankama l'accepte encore. Badges d'état Badge Signification Connecté Asterobot détient une connexion pour ce compte, reçue d'Ankama. Non connecté Asterobot ne détient aucune connexion pour le compte. Connectez-le avant de l'utiliser pour un bot. Se connecte tout seul Un mot de passe est enregistré. Asterobot reconnecte le compte tout seul quand il en a besoin. Ce que « Connecté » veut vraiment dire Connecté indique seulement qu'Asterobot possède les jetons du compte. Asterobot ne surveille pas leur expiration, et Ankama peut y mettre fin à tout moment : un compte peut donc afficher Connecté longtemps après que sa connexion a cessé de fonctionner. Deux choses permettent d'en avoir le cœur net. Vérifier interroge Ankama immédiatement. Et chaque fois qu'un bot se connecte avec le compte, Asterobot utilise la connexion pour de bon : si elle ne fonctionne plus, Asterobot la renouvelle discrètement si Ankama l'accepte, reconnecte le compte via le navigateur s'il a un mot de passe enregistré, et sinon la connexion du bot échoue avec un message qui contient ankama account authorization required. L'option Se connecter maintenant de la fenêtre Ajouter un bot n'accepte qu'un compte qui affiche Connecté. Actions Ouvrez le menu d'un compte avec les trois points au bout de sa ligne. Action Disponible Rôle Connecter automatiquement Seulement quand un mot de passe est enregistré Connecte le compte grâce au navigateur d'Asterobot, en un clic. Voir Connexion automatique. Connecter Pour un compte non connecté Ouvre la fenêtre de connexion. Voir Connexion manuelle. Reconnecter Pour un compte connecté Ouvre la même fenêtre. Le compte garde sa connexion actuelle jusqu'à ce que la nouvelle fonctionne. Vérifier Pour un compte connecté Vérifie immédiatement la connexion auprès d'Ankama. Forcer le rafraîchissement du jeton Pour un compte connecté Renouvelle aussitôt la connexion auprès d'Ankama, même si elle fonctionne encore. Déconnecter Pour un compte connecté Révoque la connexion et oublie ses jetons. Supprimer Toujours Supprime le compte d'Asterobot. Vérifier Demande à Ankama si la connexion du compte fonctionne en ce moment. Si c'est le cas, Asteroboard affiche Vérifié en tant que suivi du pseudo Ankama du compte. Quand la connexion ne fonctionne plus, Vérifier la répare d'abord, comme le ferait un bot qui se connecte : un renouvellement discret, puis une connexion via le navigateur pour un compte avec un mot de passe enregistré. Si rien ne fonctionne, Asteroboard affiche Échec de la vérification - essayez de vous reconnecter. Utilisez alors Reconnecter. Vérifier ne connecte rien au jeu. Forcer le rafraîchissement du jeton Échange immédiatement auprès d'Ankama le jeton de rafraîchissement du compte contre un nouveau, que la connexion fonctionne encore ou non. Asterobot le fait déjà tout seul quand une connexion cesse de fonctionner, vous en aurez donc rarement besoin. L'action sert pour des tests, ou pour remplacer une connexion que vous préférez ne pas garder. En cas de succès, Asteroboard affiche Jeton rafraîchi. Quand Ankama refuse le jeton de rafraîchissement, ou qu'il n'y en a pas, il affiche Impossible de rafraîchir le jeton - essayez de vous reconnecter, et seule une nouvelle connexion peut régler le problème. Contrairement à Vérifier, cette action ne se rabat jamais sur le navigateur. Déconnecter Demande à Ankama de révoquer la connexion du compte, puis oublie les jetons dans Asterobot. Les jetons sont oubliés même quand Ankama refuse la révocation ou ne répond pas : Asteroboard affiche Compte déconnecté et le badge passe à Non connecté dans tous les cas. Deux choses restent inchangées : Les bots ne sont pas touchés. Asterobot ne déconnecte pas un bot connecté avec ce compte. Le mot de passe enregistré est conservé. Un compte marqué Se connecte tout seul se reconnecte de lui-même la prochaine fois qu'un bot se connecte avec. Pour l'empêcher, supprimez le compte. Si Asteroboard affiche Impossible de déconnecter le compte, rien n'a changé et le compte est toujours connecté. Asterobot n'a pas pu joindre Ankama pour préparer la demande, ou n'a pas pu enregistrer son fichier de comptes. Supprimer Cliquez sur Supprimer. La fenêtre Supprimer ce compte ? s'ouvre. Cliquez sur Oui, supprimer. Asterobot efface le compte du fichier accounts.toml, avec son mot de passe et ses jetons. Il ne révoque rien auprès d'Ankama au préalable : cliquez sur Déconnecter avant Supprimer si vous le souhaitez. Le profil de navigateur du compte et sa dernière capture d'échec restent dans les dossiers d'Asterobot. Si la suppression échoue, Asteroboard affiche Impossible de supprimer le compte. Supprimer un compte ne supprime pas les bots qui l'utilisent, mais cela change ce qu'ils peuvent faire : Un bot déjà connecté avec le compte reste connecté, et un bot en attente de votre client de jeu continue d'attendre. Ni l'un ni l'autre n'a besoin du compte enregistré pour cela. La prochaine fois que vous cliquez sur Connecter pour un tel bot, la connexion échoue avec account not found: LoginID suivi de l'identifiant. Les Réglages du bot ne peuvent pas être enregistrés tant que vous ne lui avez pas choisi un autre compte connecté. Au prochain démarrage d'Asterobot, le bot n'est pas rétabli et disparaît du Gestionnaire de bots. Sa configuration reste enregistrée, et le bot revient lors d'un démarrage ultérieur une fois que le compte existe à nouveau. Voir Déconnecter, supprimer et redémarrer. Ajouter de nouveau le compte avec le même identifiant, puis le connecter, annule tout cela. Pour aller plus loin Ajouter un bot avec un compte connecté. Mode Full socket, pour voir comment un bot utilise le compte. Problèmes de connexion aux comptes, quand un compte ne reste pas connecté.

La connexion manuelle fonctionne pour n'importe quel compte enregistré et ne demande rien d'installé à côté d'Asterobot. Vous vous connectez sur la page d'Ankama dans votre propre navigateur, puis vous recopiez un lien dans Asteroboard. Utilisez-la pour un compte sans mot de passe enregistré, quand la connexion automatique échoue, ou quand Asterobot tourne sur une machine où aucun navigateur ne peut être lancé. Ouvrir la fenêtre de connexion Dans le Gestionnaire de comptes, ouvrez le menu du compte, les trois points au bout de sa ligne, et cliquez sur Connecter. Pour un compte déjà connecté, la même entrée s'appelle Reconnecter, et la nouvelle connexion ne remplace l'ancienne qu'une fois qu'elle fonctionne. La fenêtre s'ouvre aussi depuis la fenêtre Ajouter un bot : juste après l'ajout d'un compte avec le bouton à côté de Compte, et depuis le bouton Connecter qui apparaît sous ce champ quand le compte choisi n'est pas connecté. Quand le compte a un mot de passe enregistré, la fenêtre commence par Connecter automatiquement. La méthode manuelle se trouve en dessous, après « ou connectez-vous vous-même ». Se connecter Cliquez sur Ouvrir la connexion Ankama. La page de connexion d'Ankama s'ouvre dans un nouvel onglet de votre navigateur, et la fenêtre affiche un champ pour le code. Dans cet onglet, connectez-vous avec le compte, comme vous le feriez dans l'Ankama Launcher. Répondez à tout ce qu'Ankama demande en chemin. Ankama termine sur une page Félicitations avec un bouton Continuer. Ne cliquez pas dessus. Faites plutôt un clic droit dessus et copiez l'adresse du lien. Elle commence par zaap://login?code=. De retour dans Asteroboard, collez-la dans Code d'autorisation. Le lien complet fonctionne, et le code seul aussi, c'est-à-dire la partie après code=. Cliquez sur Valider. Le bouton reste grisé tant que le champ est vide. Asterobot échange le code contre la connexion du compte et la vérifie aussitôt auprès d'Ankama. Quand tout fonctionne, Asteroboard affiche l'identifiant suivi de est connecté, la fenêtre se ferme et le compte affiche Connecté. Si vous avez fermé l'onglet d'Ankama trop tôt, Rouvrir la page de connexion le rouvre sans tout recommencer. Asterobot n'ouvre aucun port et n'attend pas qu'Ankama le rappelle : le lien que vous collez est le seul moyen pour le code de lui parvenir. C'est pourquoi cela fonctionne tout aussi bien quand Asteroboard tourne sur un téléphone ou sur un autre ordinateur que celui d'Asterobot. Quand Valider échoue Asteroboard affiche Impossible de terminer la connexion - le code a peut-être expiré, réessayez. Un code ne sert qu'une fois, pour la connexion pour laquelle il a été créé. Causes fréquentes : Le lien a été copié en partie, ou il s'agit de l'adresse de la page Félicitations elle-même plutôt que du lien du bouton Continuer. Le code a déjà été utilisé, ou il provient d'un ancien onglet : chaque clic sur Ouvrir la connexion Ankama démarre une nouvelle connexion, et seul son propre code correspond. Asterobot a redémarré après votre clic sur Ouvrir la connexion Ankama. Une connexion en cours ne survit pas à un redémarrage. Dans tous les cas, fermez la fenêtre, rouvrez-la et reprenez à l'étape 1. Si c'est Ouvrir la connexion Ankama qui échoue, Asteroboard affiche Impossible de démarrer la connexion. La première fois qu'Asterobot prépare une connexion Ankama après son démarrage, il récupère auprès d'Ankama la version actuelle de l'Ankama Launcher, et c'est cette étape qui a échoué. Vérifiez la connexion internet de l'ordinateur où tourne Asterobot, puis réessayez. Enregistrer ou modifier le mot de passe La même fenêtre gère le mot de passe utilisé pour la connexion automatique. En bas de la fenêtre, cliquez sur Enregistrer un mot de passe Ankama pour la connexion automatique. Pour un compte qui en a déjà un, l'intitulé devient Modifier le mot de passe Ankama enregistré. Tapez le mot de passe dans Mot de passe Ankama. Cliquez sur Enregistrer le mot de passe. Asteroboard affiche Mot de passe enregistré, et le compte reçoit le badge Se connecte tout seul. Enregistrer un mot de passe ne connecte pas le compte. Cliquez sur Connecter automatiquement, qui apparaît maintenant en haut de la fenêtre, ou connectez-vous manuellement comme ci-dessus. Si l'enregistrement échoue, Asteroboard affiche Impossible d'enregistrer le mot de passe. Asteroboard ne réaffiche jamais un mot de passe enregistré. Le texte sous le champ indique que vous pouvez l'effacer pour désactiver la connexion automatique, mais Enregistrer le mot de passe reste grisé tant que le champ est vide : ce n'est donc pas possible ici. Pour qu'un compte ne se connecte plus tout seul, supprimez-le dans le Gestionnaire de comptes et ajoutez-le à nouveau sans mot de passe. État et actions d'un compte explique ce que la suppression change pour les bots qui l'utilisent. Le mot de passe est enregistré en clair sur l'ordinateur où tourne Asterobot. Ajouter un compte indique où. Saisir les jetons manuellement (debug) La dernière partie de la fenêtre, Saisir les jetons manuellement (debug), sert aux jetons obtenus d'une autre façon. Elle contourne entièrement la connexion. Champ Ce qu'il faut saisir Jeton d'accès Le jeton d'accès du compte. Jeton de rafraîchissement Son jeton de rafraîchissement. Expiration La date d'expiration du jeton d'accès, sous forme de date et heure ISO 8601, comme 2026-12-31T23:59:59Z. Enregistrer les jetons reste grisé tant que les trois champs ne sont pas remplis. Asterobot enregistre les jetons tels quels, sans demander à Ankama s'ils fonctionnent : le compte affiche donc Connecté dans tous les cas. Cliquez ensuite sur Vérifier dans le menu du compte pour en avoir le cœur net. Si Asterobot refuse les valeurs, par exemple une date qu'il ne sait pas lire, Asteroboard affiche Impossible de terminer la connexion - le code a peut-être expiré, réessayez. Les jetons donnent accès au compte Ankama au même titre qu'un mot de passe. N'utilisez que des jetons que vous avez obtenus vous-même. Pour aller plus loin État et actions d'un compte, pour vérifier le compte et connaître chaque action. Ajouter un bot, maintenant que le compte est connecté. Problèmes de connexion aux comptes, si Ankama continue de refuser.

Quand un compte a un mot de passe enregistré, Asterobot peut le connecter pour vous. Il lance un vrai navigateur sur l'ordinateur où il tourne, remplit la page de connexion d'Ankama et lit le résultat, sans afficher de fenêtre par défaut. Quand Ankama ne le laisse pas passer, le journal d'Asterobot en donne la raison. Ce qu'il faut Un mot de passe enregistré pour le compte. Voir Ajouter un compte. Connecter automatiquement n'apparaît que pour les comptes qui en ont un. Google Chrome, Chromium ou Microsoft Edge sur l'ordinateur où tourne Asterobot. Pas sur l'appareil depuis lequel vous ouvrez Asteroboard, si c'en est un autre. Asterobot cherche d'abord Chrome ou Chromium, et n'essaie Edge que si aucun des deux ne peut être lancé : Système Où Asterobot cherche Windows chrome dans le chemin des commandes ; Chrome dans C:\Program Files\Google\Chrome\Application ou C:\Program Files (x86)\Google\Chrome\Application ; Chrome ou Chromium dans le dossier AppData\Local de votre utilisateur ; puis Edge dans le chemin des commandes ou dans C:\Program Files (x86)\Microsoft\Edge\Application ou C:\Program Files\Microsoft\Edge\Application macOS Chromium ou Google Chrome dans /Applications, puis Microsoft Edge dans /Applications Linux chromium, chromium-browser, google-chrome, google-chrome-stable, chrome ou /snap/bin/chromium, entre autres noms, dans le chemin des commandes ; puis microsoft-edge, microsoft-edge-stable ou /opt/microsoft/msedge/msedge Pour un navigateur installé ailleurs, ou pour un autre navigateur basé sur Chromium comme Brave, Vivaldi ou Opera, indiquez son chemin complet dans le réglage zaapmanager.browserPath, décrit plus bas. Firefox et Safari ne peuvent pas être utilisés. Connecter un compte Le plus rapide est de passer par le Gestionnaire de comptes : Ouvrez le menu du compte, les trois points au bout de sa ligne. Cliquez sur Connecter automatiquement. Patientez. Une connexion peut prendre jusqu'à deux minutes. Quand elle réussit, Asteroboard affiche l'identifiant suivi de s'est connecté tout seul, et le badge passe à Connecté. Vous pouvez aussi passer par la fenêtre de connexion : cliquez sur Connecter ou Reconnecter dans le même menu, puis sur Connecter automatiquement en haut de la fenêtre. Quand la connexion réussit, Asteroboard affiche l'identifiant suivi de est connecté et ferme la fenêtre. Quand elle échoue, la fenêtre reste ouverte avec Échec de la connexion automatique - connectez-vous vous-même ci-dessous et une image de la page, comme expliqué plus bas. La raison elle-même ne figure que dans le journal d'Asterobot. Vous n'avez pas toujours besoin de cliquer. Quand un bot se connecte avec ce compte et que la connexion du compte ne fonctionne plus, Asterobot reconnecte le compte de la même manière pendant la connexion du bot. Mode Full socket décrit cette connexion, et Vérifier dans État et actions d'un compte peut aussi la déclencher. Ce qui se passe pendant une connexion Si la connexion actuelle du compte fonctionne encore, Asterobot la garde et s'arrête là. Aucun navigateur n'est lancé. Sinon, il demande à Ankama de renouveler la connexion discrètement, toujours sans navigateur. Ce n'est qu'en cas de refus qu'il lance le navigateur, avec le profil propre au compte, et ouvre la page de connexion d'Ankama. Son journal, dans le terminal et dans Serveur > Console, affiche Signing in to Ankama through a browser. Si le profil contient encore une session Ankama valide, Ankama saute le formulaire et passe directement à sa page de confirmation. Sinon, le navigateur saisit l'identifiant et le mot de passe dans le formulaire d'Ankama et l'envoie. Sur la page de confirmation d'Ankama, Asterobot lit le lien derrière le bouton Continuer. Ce lien contient un code à usage unique, qu'Asterobot échange contre la connexion du compte. Asterobot vérifie aussitôt la nouvelle connexion auprès d'Ankama, puis ferme le navigateur. Trois délais s'appliquent : 30 secondes pour que le formulaire de connexion d'Ankama apparaisse, 60 secondes après son envoi pour la page de confirmation, et deux minutes pour l'ensemble de la tentative. Pas de fenêtre par défaut Le navigateur tourne sans aucune fenêtre, parce que zaapmanager.browserHeadless est activé par défaut. C'est ce qui permet à la connexion automatique de fonctionner sur un ordinateur devant lequel personne n'est assis, comme un serveur. Vous pouvez activer la fenêtre quand vous avez besoin de voir ce qu'Ankama demande, comme expliqué ci-dessous. Un profil de navigateur par compte Chaque compte a son propre profil de navigateur, conservé d'une connexion à l'autre dans le dossier zaapmanager/browser-profiles du dossier de données d'Asterobot. Les comptes n'en partagent jamais. Comme le profil garde la session Ankama du compte, une connexion ultérieure va souvent directement à la page de confirmation sans repasser par le formulaire. Le profil est donc tout aussi sensible que le mot de passe lui-même. Quand Ankama réclame un humain Il arrive qu'Ankama place un contrôle ou un captcha devant son formulaire de connexion. Asterobot n'essaie pas de le franchir : il abandonne et laisse une personne prendre le relais. Vous avez deux solutions. Connectez-vous vous-même, dans votre propre navigateur. La fenêtre de connexion le propose juste sous le bouton automatique, sous « ou connectez-vous vous-même ». Voir Connexion manuelle. Cela fonctionne toujours, où que tourne Asterobot. Répondez au contrôle dans la fenêtre du navigateur de connexion. Cela ne fonctionne que si Asterobot tourne sur un ordinateur doté d'un écran devant lequel vous êtes assis : Dans Serveur > Config, désactivez zaapmanager.browserHeadless. Le changement s'applique dès la prochaine connexion, sans redémarrer Asterobot. Relancez la connexion automatique. Une fenêtre de navigateur s'ouvre sur l'ordinateur où tourne Asterobot. Répondez rapidement à ce qu'Ankama demande dans cette fenêtre : le formulaire doit apparaître dans les 30 secondes, et la page de confirmation dans les 60 secondes qui suivent l'envoi du formulaire. Quand le compte affiche Connecté, réactivez zaapmanager.browserHeadless. Quand elle échoue Une tentative ratée affiche Échec de la connexion automatique - connectez-vous vous-même ci-dessous dans la fenêtre, ou Échec de la connexion automatique en notification quand vous l'avez lancée depuis le menu. Le message en dessous commence par ankama account authorization required, suivi de l'adresse de la page de connexion d'Ankama. Ignorez la fin de ce message, qui parle d'enregistrer un code dans la configuration : la connexion se fait dans la fenêtre, comme le montre Connexion manuelle. Ce message est le même quelle que soit l'erreur. La vraie raison se trouve dans le journal d'Asterobot. Trouver la raison Dans le terminal où tourne Asterobot, ou dans Serveur > Console, cherchez l'avertissement Automatic Ankama sign-in failed, a person has to sign in. Son erreur dit ce qui s'est passé, et la plupart du temps elle se termine par le titre et l'adresse de la page sur laquelle se trouvait le navigateur : L'erreur contient Ce qui s'est passé Que faire failed to start a browser (is Chrome, Chromium or Edge installed?) Asterobot n'a trouvé aucun navigateur qu'il puisse lancer. Installez Chrome, Chromium ou Edge sur l'ordinateur où tourne Asterobot, ou renseignez zaapmanager.browserPath. ankama's sign-in page is asking for a human (bot challenge or captcha) Le formulaire de connexion d'Ankama n'est pas apparu dans les 30 secondes, ou la page n'était pas le formulaire qu'attend Asterobot. C'est à cela que ressemble un contrôle du point de vue d'Asterobot. Voir Quand Ankama réclame un humain. the request was refused by Ankama's edge network before Ankama saw it Le navigateur a reçu une page de blocage du réseau placé devant Ankama. Le compte lui-même n'a pas été vérifié. Réessayez plus tard, ou connectez-vous manuellement. ankama did not accept the sign-in (wrong password, a verification step, or a challenge raised after submitting) Le formulaire a été envoyé, mais la page de confirmation d'Ankama n'est pas arrivée dans les 60 secondes. Vérifiez le mot de passe et enregistrez-le à nouveau si besoin. Si Ankama demande une étape de vérification pour ce compte, celui-ci ne peut pas se connecter automatiquement : voir Shield et authentification à deux facteurs. failed to open ankama's sign-in page, failed to fill ankama's sign-in form ou failed to submit ankama's sign-in form Le navigateur n'a pas pu charger la page d'Ankama, ou n'a pas pu remplir ou envoyer son formulaire. Vérifiez la connexion internet de l'ordinateur où tourne Asterobot, puis connectez-vous manuellement. browser signed in but the Continue link carried no code La connexion a abouti, mais le lien derrière Continuer ne contenait aucun code. Connectez-vous manuellement. Problèmes de connexion aux comptes passe ces erreurs en revue une par une. La capture d'écran Quand le navigateur est allé jusqu'à afficher une page, Asterobot en prend une image au moment où il abandonne. Juste après un échec lancé depuis le bouton Connecter automatiquement de la fenêtre elle-même, la fenêtre affiche cette image sous l'alerte, avec la légende « Ce que le navigateur avait sous les yeux en abandonnant - cliquez pour l'ouvrir en grand ». Cliquez dessus pour la voir en taille réelle. C'est souvent le moyen le plus rapide de distinguer un captcha d'un mauvais mot de passe. Asterobot garde une image par compte, dans le dossier zaapmanager de son dossier de cache, et la remplace au prochain échec. Le terminal affiche Captured what the browser saw when the Ankama sign-in failed avec le chemin du fichier. Quand le navigateur n'a pas pu démarrer du tout, il n'y a pas d'image. Réglages de la connexion automatique Ces trois réglages se trouvent dans Serveur > Config. Aucun ne nécessite de redémarrage : chaque connexion les relit. Réglage Par défaut Ce qu'il change zaapmanager.browserHeadless Activé Lance le navigateur de connexion sans fenêtre. Désactivez-le pour suivre la connexion et répondre à un contrôle à la main. zaapmanager.browserPath Vide Chemin complet du navigateur à utiliser. Vide, Asterobot cherche Chrome, Chromium, puis Edge. Quand vous le renseignez, Asterobot utilise uniquement ce navigateur et n'en cherche pas d'autre s'il ne démarre pas. zaapmanager.browserUserAgent Vide La façon dont le navigateur de connexion s'identifie auprès des pages qu'il ouvre. Vide, il se présente comme Chrome sous Windows 11, avec le numéro de version majeure du navigateur réellement installé. Ce que vous saisissez remplace cette identité. Référence des réglages liste tous les réglages, et La page Config montre comment en modifier un. Pour aller plus loin Connexion manuelle, quand la connexion automatique n'est pas possible. État et actions d'un compte, pour vérifier qu'un compte connecté fonctionne toujours. Problèmes de connexion aux comptes, pour le détail de chaque erreur.

Un bot en mode Full socket se connecte à Ankama tout seul : il lui faut donc un compte Ankama enregistré dans Asterobot. Vous l'ajoutez dans le Gestionnaire de comptes, avec ou sans son mot de passe. Si vos bots n'utilisent que le mode MITM, pour « homme du milieu » (man-in-the-middle), où un bot relaie le jeu auquel vous jouez vous-même, rien de tout cela ne vous concerne : ces bots n'utilisent jamais de compte enregistré. Caution Utiliser des bots enfreint les conditions d'utilisation d'Ankama, et Ankama peut sanctionner les comptes concernés. Lisez Comptes et sécurité avant d'enregistrer un compte auquel vous tenez. Ouvrir le Gestionnaire de comptes Dans la barre latérale, cliquez sur Gestionnaire de comptes. La page liste vos comptes enregistrés, un par ligne : Colonne Ce qu'elle affiche Identifiant L'identifiant que vous saisissez sur la page de connexion d'Ankama. Statut Connecté ou Non connecté, plus Se connecte tout seul quand un mot de passe est enregistré. État et actions d'un compte explique ce que chaque badge veut vraiment dire. Tapez dans Filtrer... pour retrouver un compte dans une longue liste. Avant tout ajout, le tableau indique « Aucun compte enregistré pour le moment. » Ajouter le compte Cliquez sur Ajouter un compte. La fenêtre Ajouter un compte de bot s'ouvre. Dans Identifiant, tapez l'identifiant que vous utilisez sur la page de connexion d'Ankama. Les espaces autour sont retirés. Remplissez Mot de passe Ankama (facultatif) uniquement si vous voulez qu'Asterobot connecte ce compte tout seul. La section suivante explique la différence. Cliquez sur Ajouter. Le bouton reste grisé tant que le champ Identifiant est vide. Le compte apparaît dans le tableau comme Non connecté. L'ajout ne contacte pas du tout Ankama : un identifiant ou un mot de passe erroné n'est donc pas détecté à ce stade. Connectez ensuite le compte, avec la Connexion automatique si vous avez enregistré un mot de passe, ou avec la Connexion manuelle sinon. Si Asteroboard affiche Impossible d'ajouter le compte, la raison habituelle est qu'un compte avec le même identifiant est déjà enregistré. Un identifiant ne peut être enregistré qu'une seule fois. Vous n'avez pas besoin de quitter la fenêtre Ajouter un bot pour cela. Le bouton à côté de son champ Compte ouvre la même fenêtre, puis la fenêtre de connexion, et sélectionne le nouveau compte pour le bot. Voir Ajouter un bot. Avec ou sans mot de passe Le mot de passe est à lui seul l'interrupteur de la connexion automatique. Il n'existe aucun autre réglage pour l'activer. Avec un mot de passe, le compte reçoit le badge Se connecte tout seul. Vous pouvez le connecter en un clic, et quand un bot a plus tard besoin du compte alors que sa connexion ne fonctionne plus, Asterobot le reconnecte tout seul, grâce à un navigateur qu'il pilote. Asterobot tente toujours d'abord un renouvellement discret auprès d'Ankama et n'ouvre ce navigateur que si le renouvellement est refusé. Sans mot de passe, le compte fonctionne exactement de la même façon tant que sa connexion est valide. La différence apparaît quand cette connexion cesse de fonctionner et ne peut pas être renouvelée discrètement : quelqu'un doit alors reconnecter le compte, et un bot qui tente de se connecter avant cela échoue. Vous pouvez enregistrer un mot de passe plus tard, ou le remplacer, depuis la fenêtre de connexion. Voir Connexion manuelle. En revanche, Asteroboard ne permet pas d'effacer un mot de passe enregistré : pour désactiver à nouveau la connexion automatique, supprimez le compte et ajoutez-le de nouveau sans mot de passe. Ce qu'Asterobot garde, et où Asterobot enregistre vos comptes dans un fichier nommé accounts.toml, dans son dossier de données. Fichiers et dossiers indique où se trouve ce dossier sur chaque système. Pour chaque compte, le fichier contient : l'identifiant ; le mot de passe, si vous en avez enregistré un ; la connexion qu'Ankama a donnée à Asterobot : un jeton d'accès et un jeton de rafraîchissement, avec leur date d'émission et leur date d'expiration. Le mot de passe n'est pas chiffré. Il est écrit en clair dans le fichier, parce qu'Asterobot doit le saisir sur la page de connexion d'Ankama. Sous Linux et macOS, Asterobot restreint le fichier pour que seul votre compte utilisateur puisse le lire ou le modifier, et réapplique cette restriction à chaque démarrage. Sous Windows, cette restriction n'a aucun effet. Dans tous les cas, toute personne qui peut ouvrir des fichiers avec votre compte utilisateur, ou qui obtient une copie du fichier, peut lire le mot de passe et utiliser les jetons. Les comptes qui se connectent automatiquement laissent deux autres choses derrière eux : Un profil de navigateur par compte, dans le dossier zaapmanager/browser-profiles du dossier de données d'Asterobot. Il contient la session Ankama du compte dans le navigateur de connexion, ce qui permet à une connexion ultérieure de passer le formulaire d'Ankama. Sous Linux et macOS, seul votre utilisateur peut l'ouvrir. Traitez-le comme le mot de passe. Une capture d'écran de la dernière connexion automatique échouée, dans le dossier zaapmanager du dossier de cache d'Asterobot. Il y en a une par compte, remplacée à chaque nouvel échec. Connexion automatique explique à quoi elle sert. Asterobot ne renvoie jamais le mot de passe à Asteroboard : tout ce qu'il indique à Asteroboard sur un compte, c'est si un mot de passe est enregistré et si le compte est connecté. Caution Ne partagez jamais accounts.toml, les profils de navigateur ou le dossier de données d'Asterobot, pas même pour obtenir de l'aide. Obtenir de l'aide liste ce qui peut être partagé sans risque. Un bot par compte Un compte Ankama ne peut appartenir qu'à un seul bot. Dofus autorise une session de jeu par compte, et Asterobot applique la même règle : ajouter un second bot avec un compte qui en a déjà un échoue avec Impossible d'ajouter le bot, et choisir ce compte sur l'onglet Réglages d'un bot est refusé avec this account is already associated with a bot. Pour faire tourner plusieurs bots en mode Full socket, enregistrez un compte pour chacun. Voir Plusieurs bots. Les comptes et le mode MITM Un bot en mode MITM n'utilise jamais de compte enregistré, même s'il en a un : vous vous connectez vous-même, dans Dofus, et le bot relaie cette session. C'est pourquoi les comptes protégés par Ankama Shield ou par l'authentification à deux facteurs restent utilisables en mode MITM. Voir Shield et authentification à deux facteurs. Pour aller plus loin Connexion automatique, si vous avez enregistré un mot de passe. Connexion manuelle, pour connecter le compte vous-même. Ajouter un bot, une fois que le compte affiche Connecté.

Asterobot ne suit pas de lui-même les mises à jour de Dofus. Chaque mise à jour est une nouvelle version de jeu, et la version qu'Asterobot a déjà téléchargée reste exactement telle qu'elle était. Après une mise à jour, suivez ces étapes, dans cet ordre. Elles comptent surtout en mode MITM, pour « homme du milieu » (man-in-the-middle), où la version de jeu de votre bot doit correspondre au Dofus auquel vous jouez. Un bot qui se connecte tout seul garde la version qui lui est attribuée jusqu'à ce que vous la changiez. 1. Vérifier s'il existe une nouvelle version Dans le Gestionnaire de jeux, ouvrez le menu de la version que vous utilisez. Cliquez sur Vérifier la dernière version. Asteroboard répond À jour ou Une nouvelle version est disponible, suivi dans les deux cas de « La dernière version d'Ankama est » et du numéro de version. Le même bouton se trouve sur l'onglet Informations de la page du jeu de la version. En mode MITM, c'est l'Ankama Launcher qui met à jour votre Dofus. Mode MITM montre où lire la version à laquelle vous jouez. 2. Télécharger et extraire la nouvelle version Cliquez sur Télécharger un jeu. Gardez les valeurs par défaut, avec latest dans Version et Extraire les données après le téléchargement coché. Si la nouvelle version ne figure pas dans les suggestions, cliquez d'abord sur Vérifier les mises à jour. Cliquez sur Télécharger. Gardez Asteroboard ouvert jusqu'à ce que la nouvelle ligne affiche Prêt pour un bot, pour que l'extraction démarre d'elle-même. La nouvelle version a sa propre ligne, à côté de l'ancienne. Les chunks qu'Asterobot a déjà stockés pour l'ancienne version ne sont pas retéléchargés. Télécharger une version de jeu détaille chaque champ de la fenêtre. 3. Regarder la compatibilité Vérifiez la colonne Compatibilité de la nouvelle ligne : Compatible : votre version d'Asterobot a été testée avec cette version. Version différente : elle ne l'a pas été. L'icône d'information à côté du badge indique la version avec laquelle Asterobot est testé. Version différente ne bloque rien, mais vos bots risquent de ne pas encore fonctionner sur cette version. Quand Asterobot ne prend pas encore en charge la nouvelle version décrit ce que vous pouvez voir. 4. Passer vos bots sur la nouvelle version Répétez ceci pour chaque bot qui utilise l'ancienne version. Ouvrez la page du bot. Si le bot est connecté, en cours de connexion ou en attente de votre jeu, cliquez sur Déconnecter. Sa version de jeu ne peut pas changer tant qu'il est en ligne : l'onglet Réglages indique « Déconnectez ce bot pour changer son compte ou sa version du jeu. » et grise les champs jusqu'à ce que vous le fassiez. Ouvrez l'onglet Réglages. Sous Version du jeu, choisissez la nouvelle version. S'il s'agit de la version testée, le bouton Utiliser la version testée la sélectionne en un clic. Cliquez sur Enregistrer. Asteroboard affiche Réglages enregistrés. Remettez le bot en ligne avec Connecter ou Commencer l'attente. En mode MITM, ne cliquez sur Commencer l'attente qu'une fois votre Dofus à jour : tant que les deux versions diffèrent, le bot refuse d'attendre. Réglages du bot décrit le reste de l'onglet Réglages. 5. Supprimer l'ancienne version Une fois que plus aucun bot n'utilise l'ancienne version, ouvrez son menu dans le Gestionnaire de jeux : Supprimer libère le plus d'espace : les fichiers, les données de jeu extraites et la ligne disparaissent. Désinstaller efface les fichiers et garde la ligne avec ses données de jeu extraites. Aucune des deux actions ne vérifie si un bot utilise encore la version : terminez donc d'abord l'étape précédente. Gérer les versions de jeu compare les deux. Quand Asterobot ne prend pas encore en charge la nouvelle version Asterobot lit et écrit les messages que Dofus échange avec ses serveurs, et ces messages changent d'une version à l'autre. Juste après une mise à jour, votre version d'Asterobot peut ne pas encore connaître les messages de la nouvelle version. Voici ce que vous pouvez rencontrer : Version différente dans la colonne Compatibilité, sur l'onglet Informations de la page du jeu et sous Version du jeu dans les réglages d'un bot. Un bot qui se connecte tout seul n'arrive pas à se connecter. Une alerte intitulée Impossible de connecter ce bot apparaît en haut de sa page, avec la raison. En mode MITM, votre jeu est déconnecté quand il atteint le bot, et le journal d'Asterobot affiche Failed to relay a game session suivi de la raison. Un script ne peut pas démarrer, et son erreur commence par the game engine is not available:. Quand votre version d'Asterobot est trop ancienne pour la version de jeu que l'équipe d'Asterobot prend actuellement en charge, la raison vous indique de mettre Asterobot à jour. Dans ce cas : Téléchargez la nouvelle version d'Asterobot. Quand une nouvelle version est publiée, Asteroboard affiche Mise à jour d'Asterobot disponible avec un bouton Voir sur asterobot.net au démarrage d'Asterobot, et le terminal affiche An Asterobot update is available. Mettez-le à jour comme l'explique Mettre à jour Asterobot. Regardez de nouveau la colonne Compatibilité. Quand la raison est seulement the game engine is not available, Asterobot n'a pas du tout pu obtenir ce dont il a besoin pour lire les messages du jeu, quelle que soit la version de jeu. Vérifiez qu'Asterobot est connecté à asterobot.net et a accès à internet, puis réessayez. Si le problème persiste, Obtenir de l'aide indique où demander. Les auteurs de scripts trouveront comment garder leurs scripts fonctionnels d'une mise à jour à l'autre dans Après une mise à jour du jeu. Pour aller plus loin Mode MITM Réglages du bot Jeu et mises à jour dans la FAQ

Le Gestionnaire de jeux liste toutes les versions de jeu qu'Asterobot connaît, avec les outils pour les garder en bon état : vérifier les fichiers d'une version, lui ajouter des fichiers, libérer de l'espace disque ou la supprimer. La page Au-dessus du tableau se trouvent Rescanner, Vérifier tous les chunks et Supprimer tous les chunks à gauche, et Télécharger un jeu à droite (Télécharger une version de jeu). Juste au-dessus des lignes, Filtrer... garde les lignes qui contiennent ce que vous tapez, et Colonnes masque ou affiche des colonnes. Cliquez sur le titre d'une colonne pour trier selon celle-ci. En bas de la colonne Version, un compte comme « 2 / 3 installés » indique combien de versions sont installées sur l'ensemble des lignes, et des boutons de pagination apparaissent quand la liste s'allonge. Quand rien n'a encore été téléchargé, le tableau indique « Aucun jeu pour le moment. » Colonnes Colonne Ce qu'elle affiche Jeu L'icône et le nom du jeu, une fois son téléchargement terminé, avec son code, comme dofus, en dessous. Pour une version de Dofus pour Windows installée, le nom ouvre la page du jeu de la version. Environnement L'environnement, dofus3 pour le Dofus qu'utilisent les bots. Plateforme La plateforme, windows pour le Dofus qu'utilisent les bots. Version Le numéro de version. Statut Où en est le téléchargement : En attente, Téléchargement, Vérification, Installé ou Échec. Une barre de progression et un compteur suivent le téléchargement ou la vérification, et une icône d'information à côté d'Échec affiche la raison. Voir Télécharger une version de jeu. Extraction Où en est l'extraction : Non extrait, Extraction en cours, Extrait ou Échec de l'extraction. Voir Extraire les données de jeu. Prêt Prêt pour un bot ou Pas prêt. Voir Extraire les données de jeu. Compatibilité Compatible ou Version différente, par rapport à la version de Dofus avec laquelle cette version d'Asterobot a été testée. Uniquement pour les versions dont l'environnement est dofus3 et la plateforme windows. Voir Pourquoi Asterobot télécharge Dofus. Sans titre Un bouton Inspecter qui ouvre la page du jeu de la version, sur les mêmes lignes que le lien de la colonne Jeu. Actions sur une version Chaque ligne se termine par un bouton de menu, et un clic droit sur une ligne ouvre le même menu. L'onglet Informations de la page du jeu de la version propose les mêmes actions sous forme de boutons (Page du jeu). Action Rôle Indisponible Vérifier les fichiers Vérifie les fichiers téléchargés et télécharge à nouveau ceux qui ne correspondent pas. Pendant que la version est en attente, en téléchargement ou en vérification, et quand elle est en Échec Télécharger plus de fichiers Télécharge d'autres fichiers pour cette version, choisis avec des filtres. Devient Réessayer sur une version en Échec. Pendant que la version est en attente, en téléchargement ou en vérification Extraire les données Extrait les données de jeu. Devient Réextraire les données une fois l'extraction faite. Tant que le statut de la version n'est pas Installé, et pendant son extraction Supprimer les données extraites Efface les données de jeu extraites et garde les fichiers. Quand rien n'est extrait, et pendant l'extraction Vérifier si prêt pour un bot Vérifie sur le disque si un bot peut utiliser la version, et répond par une notification. Toujours disponible Vérifier la dernière version Demande aux serveurs de téléchargement d'Ankama la version la plus récente pour le même jeu, la même plateforme et le même environnement, et répond À jour ou Une nouvelle version est disponible avec « La dernière version d'Ankama est » et son numéro. Toujours disponible Désinstaller Efface les fichiers téléchargés, garde la ligne et les données de jeu extraites. Tant que le statut de la version n'est pas Installé, et pendant qu'elle est en attente, en téléchargement ou en vérification Supprimer Efface les fichiers, les données de jeu extraites et la ligne. Pendant que la version est en attente, en téléchargement ou en vérification Vérifier les fichiers Vérifier les fichiers lit chaque fichier de la version présent sur le disque, le compare à la liste qu'Ankama publie pour cette version, efface les fichiers qui ne correspondent pas et les télécharge à nouveau. Le Statut indique Vérification dès que vous cliquez, même pendant que la vérification attend son tour, puis Installé. Cette action ne vérifie que les fichiers qui ont été téléchargés. Elle n'ajoute jamais les fichiers qu'un téléchargement plus restreint a laissés de côté : c'est le rôle de Télécharger plus de fichiers. Les vérifications attendent dans la même file que les téléchargements, donc aucune ne démarre pendant qu'une version se télécharge. Si la demande ne peut pas être envoyée, Asteroboard affiche Impossible de démarrer la vérification. Télécharger plus de fichiers et Réessayer Télécharger plus de fichiers ouvre la fenêtre Télécharger plus de fichiers. Jeu, Plateforme, Environnement et Version sont verrouillés sur ceux de la version, et le reste fonctionne comme dans la fenêtre de téléchargement : Filtre de fichiers (regex) contient au départ le motif des fichiers dont un bot a besoin. Videz-le pour télécharger tous les fichiers restants de la version. Filtre de fragments (regex) est vide au départ. Extraire les données après le téléchargement est coché au départ. Les fichiers déjà sur le disque ne sont pas touchés : seul ce qui correspond nouvellement aux filtres est téléchargé. Sur une version en Échec, le menu affiche Réessayer et la fenêtre s'intitule Réessayer le téléchargement. Le téléchargement reprend alors là où il s'est arrêté, en gardant les fichiers terminés. Si le téléchargement ne peut pas être mis en file d'attente, Asteroboard affiche Impossible de mettre en file d'attente le téléchargement. Désinstaller ou Supprimer Les deux actions libèrent l'espace qu'occupent les fichiers de la version, et les deux demandent une confirmation. Elles diffèrent par ce qu'elles laissent derrière elles : Désinstaller Supprimer Fichiers téléchargés Effacés Effacés Données de jeu extraites Conservées Effacées La ligne de la version Conservée, avec le statut Installé Retirée Prêt Pas prêt Plus de ligne Chunks partagés Conservés Conservés Récupérer les fichiers Télécharger plus de fichiers sur la ligne Télécharger un jeu à nouveau Désinstaller convient à une version dont vous pourriez avoir de nouveau besoin bientôt : une fois que Télécharger plus de fichiers a ramené ses fichiers, elle repasse à Prêt pour un bot sans nouvelle extraction. Son Statut continue d'indiquer Installé même quand il ne reste aucun fichier : regardez donc la colonne Prêt. Confirmez dans la fenêtre Désinstaller cette version du jeu ? avec Oui, désinstaller. Supprimer oublie complètement la version. Confirmez dans la fenêtre Supprimer cette version de jeu ? avec Oui, supprimer. Comme l'indique la fenêtre, les chunks partagés sont conservés : retélécharger la version plus tard sera donc plus rapide que la première fois. Warning Aucune des deux actions ne vérifie si des bots utilisent la version. Un bot qui se connecte tout seul ne peut pas se connecter avec une version désinstallée, et un bot dont la version a été supprimée est ignoré au démarrage d'Asterobot. Passez d'abord vos bots sur une autre version, comme le montre Quand Dofus se met à jour. Si Asterobot refuse, par exemple parce qu'un téléchargement de cette version a démarré entre-temps, Asteroboard affiche Impossible de désinstaller ou Impossible de supprimer. Rescanner Asterobot garde la trace des versions qu'il a téléchargées. Si vous ajoutez ou retirez à la main le dossier d'une version dans son dossier de cache, cliquez sur Rescanner. Asterobot examine le disque, ajoute chaque dossier de version qu'il trouve avec le statut Installé, et oublie les versions installées dont le dossier a disparu. Les lignes en attente, en téléchargement, en vérification ou en échec ne sont pas touchées. Asteroboard répond Analyse terminée avec le nombre de versions de jeu modifiées, ou Impossible de relancer l'analyse. Asterobot fait la même vérification à chaque démarrage. Un dossier compte comme installé dès qu'il existe, quel que soit son contenu : regardez donc la colonne Prêt des versions qu'il ajoute. Comment les chunks sont stockés Les serveurs de téléchargement d'Ankama livrent le contenu du jeu en chunks. Asterobot enregistre chaque chunk une seule fois, dans un stockage partagé par tous les jeux et toutes les versions, et reconstruit les fichiers de chaque version à partir de ces chunks. Cela a trois conséquences : Un chunk déjà présent dans le stockage n'est jamais retéléchargé, quelle que soit la version qui le demande. Supprimer une version laisse ses chunks dans le stockage, car d'autres versions peuvent s'en servir. Les chunks restent une fois les fichiers reconstruits : ils occupent donc de la place en plus des fichiers. Vérifier tous les chunks Vérifier tous les chunks lit chaque chunk stocké et efface ceux dont le contenu ne correspond plus, par exemple après une erreur de disque. Pendant l'opération, le bouton affiche une barre de progression et un compteur. La vérification peut tourner pendant qu'une version se télécharge. Quand elle est terminée, Asteroboard affiche Vérification des chunks terminée, ou Échec de la vérification des chunks avec la raison, quelle que soit la page où vous êtes. Un chunk effacé est retéléchargé la prochaine fois qu'un téléchargement en a besoin. La vérification ne répare pas les fichiers qu'une version a déjà reconstruits : c'est le rôle de Vérifier les fichiers sur cette version. Si la vérification ne peut pas démarrer, Asteroboard affiche Impossible de démarrer la vérification des chunks. Supprimer tous les chunks Supprimer tous les chunks efface tous les chunks stockés, pour tous les jeux et toutes les versions. Rien n'est perdu pour de bon : le prochain téléchargement ou la prochaine vérification récupère à nouveau les chunks dont il a besoin, ce qui le rend plus lent. Cliquez sur Supprimer tous les chunks. Dans la fenêtre Supprimer tous les chunks stockés ?, cliquez sur Oui, supprimer tous les chunks. Le bouton est grisé pendant qu'une version est en attente, en téléchargement ou en vérification, et pendant que Vérifier tous les chunks tourne. Si l'une de ces opérations démarre avant que votre clic n'atteigne Asterobot, Asteroboard affiche Impossible de supprimer les chunks. Libérer de l'espace disque De la méthode la plus douce à la plus radicale : Supprimer tous les chunks. Vos versions continuent de fonctionner : les bots et la page du jeu lisent les fichiers reconstruits et les données de jeu extraites, pas les chunks. Désinstaller les versions qu'aucun bot n'utilise mais que vous voudrez peut-être retrouver sans nouvelle extraction. Supprimer les versions dont vous n'avez plus besoin. La commande cache reset efface tout cela d'un coup : chaque version de jeu, ses données de jeu extraites et chaque chunk, avec le reste du cache d'Asterobot. Réinitialiser et repartir de zéro montre comment faire. En ligne de commande La ligne de commande d'Asterobot permet aussi de télécharger une version, de lister les versions, de vérifier les fichiers d'une version, de supprimer une version, et de vérifier ou supprimer les chunks, sans passer par Asteroboard. Ligne de commande décrit ces commandes. Pour aller plus loin Quand Dofus se met à jour Problèmes de téléchargement du jeu

Une version de jeu téléchargée est un dossier de fichiers du jeu que les bots, les scripts et la page du jeu ne savent pas lire tels quels. L'extraction les transforme en données de jeu : les tables et les textes du jeu sous une forme qu'Asterobot peut rechercher et interroger, plus les images qu'affiche la page du jeu. Une version doit être extraite avant que vous puissiez ajouter un bot qui l'utilise. Si Extraire les données après le téléchargement était coché quand vous avez téléchargé la version, l'extraction a déjà commencé ou est terminée. Sinon, lancez-la vous-même, comme le montre Extraire une version. Ce que construit l'extraction L'extraction ne lit que des fichiers déjà téléchargés : elle ne télécharge rien. Elle enchaîne ces étapes dans l'ordre, et le compteur de progression repart de zéro à chaque étape, plusieurs fois pendant les données de jeu : Les images : les illustrations des serveurs affichées quand vous choisissez un serveur, les icônes des objets et les icônes dessinées sur la carte du monde. Les visuels de la carte du monde : 1 216 images qui couvrent les 40 cartes du monde à chaque niveau de zoom. Les données de jeu : les tables propres au jeu (objets, monstres, sorts, cartes, quêtes et le reste), les tables qu'Asterobot en dérive, comme l'index de chaque nom dans chaque langue, le graphe de déplacement du monde, et les textes de chaque langue dont le fichier de textes a été téléchargé. La musique, uniquement quand les banques audio de la version ont été téléchargées depuis l'onglet Musique. Si la musique ne peut pas être extraite, l'extraction réussit quand même. Le résultat est stocké à part des fichiers du jeu, dans le dossier de cache d'Asterobot (Fichiers et dossiers). Données de jeu montre comment le parcourir, et les scripts le lisent avec asterobot:gamedata. Extraire une version Ouvrez le Gestionnaire de jeux. Ouvrez le menu au bout de la ligne de la version, ou faites un clic droit sur la ligne. Cliquez sur Extraire les données. La colonne Extraction passe à Extraction en cours, avec une barre de progression et un compteur. L'extraction s'exécute dans Asterobot : vous pouvez fermer Asteroboard pendant ce temps. Extraire les données n'est disponible qu'une fois le Statut de la version à Installé, et pas pendant que cette version est déjà en cours d'extraction. Vous trouverez le même bouton sur la page du jeu de la version, dans la carte Données extraites de l'onglet Informations. Dans la fenêtre Ajouter un bot, vous pouvez aussi cliquer sur le badge Non extrait ou Échec de l'extraction de la version choisie. Chaque version s'extrait indépendamment des autres. L'extraction n'attend pas dans la file des téléchargements : elle tourne pendant qu'une autre version se télécharge, et deux versions peuvent s'extraire en même temps. La colonne Extraction Statut Signification Non extrait Aucune extraction complète de cette version n'est sur le disque. Extraction en cours Une extraction tourne. Le compteur suit l'étape actuelle. Extrait Chaque étape a laissé son résultat sur le disque : les images, les visuels de la carte du monde et les données de jeu. Échec de l'extraction La dernière extraction s'est arrêtée sur une erreur. Asteroboard n'affiche pas pourquoi une extraction a échoué. La raison se trouve dans le journal d'Asterobot, sur une ligne qui commence par Failed to extract game data, que vous pouvez lire dans le terminal d'Asterobot ou dans Serveur > Console (État et console). Échec de l'extraction reste affiché jusqu'à ce que vous relanciez l'extraction ou redémarriez Asterobot. Après un redémarrage, Asterobot regarde ce qui se trouve sur le disque et affiche Extrait ou Non extrait. La cause habituelle est un fichier manquant. Une version téléchargée avec un Filtre de fichiers (regex) plus restrictif que celui par défaut n'a pas tout ce que lit l'extraction. Ouvrez la page du jeu de la version : si sa carte Fichiers requis indique Manquants, cliquez sur Télécharger les fichiers requis, attendez la fin du téléchargement, puis relancez l'extraction. Prêt pour un bot La colonne Prêt indique Prêt pour un bot quand une version réunit les deux moitiés dont un bot a besoin, et Pas prêt sinon : les fichiers dont un bot a besoin sont téléchargés : les textes du jeu, les tables de données, les données des cartes et le graphe de déplacement du monde ; les données de jeu sont extraites, ainsi que les illustrations des serveurs. Aucune des deux moitiés n'implique l'autre. Une version fraîchement téléchargée affiche Pas prêt tant qu'elle n'est pas extraite, et une version dont vous avez désinstallé les fichiers garde ses données de jeu extraites mais affiche Pas prêt elle aussi. Les visuels de la carte du monde et les icônes des objets ne font pas partie de la vérification : seule la page du jeu s'en sert. Ajouter un bot n'accepte qu'une version marquée Prêt pour un bot. Un bot qui se connecte tout seul refuse aussi de le faire tant que sa version n'est pas prête : Asteroboard affiche alors La version du jeu du bot n'est pas encore prête, avec « Ses fichiers de jeu ou ses données extraites ne sont pas complètement prêts ». Le badge se met à jour quand un téléchargement ou une extraction de la version se termine. Pour vérifier tout de suite, cliquez sur Vérifier si prêt pour un bot dans le menu de la version ou sur sa page du jeu. Asterobot examine le disque et Asteroboard répond Prêt pour un bot, Pas prêt pour un bot, ou Impossible de vérifier l'état quand Asterobot n'a pas pu être interrogé. Extraire à nouveau Une fois qu'une version affiche Extrait, l'entrée du menu devient Réextraire les données. Elle relance toute l'extraction depuis le début et écrase ce qui existait. Utilisez-la quand les données de jeu semblent incomplètes, ou après avoir téléchargé des fichiers supplémentaires pour la version. Les scripts qui tournent déjà sur cette version prennent en compte les nouvelles données de jeu à leur prochaine recherche, comme l'explique Vue d'ensemble des données de jeu. Supprimer les données extraites Supprimer les données extraites, dans le menu de la version ou dans la carte Données extraites de sa page du jeu, efface les données de jeu de la version, ses images extraites et sa musique extraite. Les fichiers du jeu téléchargés restent. La version passe à Non extrait et Pas prêt : un bot qui se connecte tout seul ne peut donc plus s'en servir pour se connecter tant que vous ne l'avez pas extraite à nouveau. L'action n'est pas disponible pendant l'extraction de la version, ni quand rien n'est extrait. Si une extraction démarre avant que votre clic n'atteigne Asterobot, Asteroboard affiche Impossible de supprimer les données extraites. Supprimer efface aussi les données de jeu extraites, en même temps que les fichiers et la ligne de la version : voir Gérer les versions de jeu. Si l'extraction ne démarre pas Impossible de démarrer l'extraction signifie que la demande n'a pas atteint Asterobot. Vérifiez qu'Asteroboard est connecté : l'entrée Préférences de la barre latérale n'a pas de point rouge. Puis réessayez. Pour aller plus loin Gérer les versions de jeu Page du jeu Ajouter un bot

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.