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.