L'outil Réseau montre les messages échangés entre un bot et le jeu : ce qu'envoie le serveur, et ce que le bot ou votre client Dofus lui renvoie. Ouvrez-le depuis l'onglet Outils du bot. Il comporte trois panneaux : Trafic liste les messages, Réglages choisit lesquels, et Envoyer un message de jeu en envoie un à la main, ce que couvre Envoyer des messages à la main.
Pourquoi Trafic est vide au départ
Un bot échange énormément de messages. Asterobot n'en envoie aucun à Asteroboard tant que vous n'avez pas choisi ceux qui vous intéressent : sur un nouveau bot, Trafic indique donc « Aucun message renvoyé pour l'instant. Choisissez-en dans Réglages. »
Ce que vous choisissez ne change que ce qu'affiche Asteroboard. Le script du bot reçoit tous les messages dans tous les cas, et la partie se déroule de la même façon.
Chat en direct dans l'onglet Console et Inventaire en direct dans l'onglet Inventaire sont des raccourcis : ils cochent des messages dans cette même liste.
Choisir les messages
Le panneau Réglages contient tous les messages qu'Asterobot sait nommer, avec une case à cocher pour chacun.
Caution
Sur un bot MITM, où le bot relaie la session de jeu de votre client Dofus (« homme du milieu », man-in-the-middle), cocher IdentificationRequest affiche le premier message qu'envoie votre client. Il contient le ticket qui ouvre votre session de jeu. Ne partagez jamais une capture d'écran ni une copie de ce message.
- Sur la page du bot, cliquez sur Outils, puis sur Réglages dans l'outil Réseau.
- Tapez une partie du nom d'un message dans Filtrer les messages... pour réduire la liste.
- Cochez les messages voulus. Le bouton Sélectionner les, qui indique combien de messages le filtre laisse passer (par exemple Sélectionner les 12 affichés), les coche tous, et Désélectionner les affichés les décoche.
- Cliquez sur Appliquer. Le bouton indique combien de messages sont cochés, par exemple Appliquer (3).
Une notification confirme combien de types de messages le bot renvoie désormais, et la ligne à côté du bouton indique combien sont sélectionnés sur le nombre total existant. Appliquer reste grisé tant que rien n'a changé, et Rétablir, qui apparaît dès que vous modifiez quelque chose, remet la liste telle qu'elle a été appliquée la dernière fois.
La sélection appartient au bot. Elle est enregistrée avec lui, reste après un redémarrage d'Asterobot, et elle est la même dans tous les navigateurs qui ouvrent ce bot. Après une mise à jour du jeu, les messages qu'Asterobot ne connaît plus par leur nom sont retirés de la sélection au démarrage suivant d'Asterobot.
Quand la liste ne peut pas être chargée, ou qu'Appliquer échoue, l'alerte Impossible de charger le catalogue de messages apparaît avec la raison, par exemple unknown game protocol message names: [...] pour des noms qu'Asterobot ne connaît pas.
Renvoyer aussi les messages non identifiés
Certains messages n'ont pas encore de nom connu d'Asterobot : on ne peut donc pas les cocher un par un. L'interrupteur Renvoyer aussi les messages non identifiés les couvre tous d'un coup : « Ils arrivent sous leur nom obfusqué, décodés depuis le schéma lorsqu'il les décrit. » Appliquez-le comme la liste. Attendez-vous à en recevoir beaucoup.
Messages perdus
Quand les messages arrivent plus vite qu'Asterobot ne peut les transmettre à Asteroboard, il en saute certains plutôt que de ralentir le bot. Un badge à côté d'Appliquer indique alors combien, par exemple « 12 message(s) perdu(s) - le flux n'a pas suivi ». Le compteur couvre ce bot depuis le démarrage d'Asterobot, et rien n'est perdu pour le bot ni pour son script. S'il continue d'augmenter, cochez moins de messages.
Regarder passer les messages
Ouvrez Trafic. Les messages choisis apparaissent à mesure qu'ils passent, les plus anciens en haut.
Chaque ligne affiche, de gauche à droite :
| Élément | Signification |
|---|---|
| Barre de couleur et icône | Le genre de message : vert pour un événement annoncé par le serveur, rouge pour une requête, bleu pour une réponse à une requête, gris quand le genre est inconnu. |
| Heure | Le moment où la connexion du bot a vu le message, en UTC, à la milliseconde près. |
| Nom | Le nom du message. Un message sans nom connu affiche son nom obfusqué en italique. |
| Schéma ou Brut | Seulement pour les messages sans nom connu. Schéma : ses champs ont tout de même pu être lus, sous des noms obfusqués. Brut : seuls ses octets ont pu être lus. |
| Entrant ou Sortant | Entrant vient du serveur de jeu. Sortant part vers lui, depuis le bot ou depuis votre client Dofus. |
# et un nombre |
Le numéro d'ordre du message sur cette connexion. |
uid et un nombre |
Affiché pour les requêtes et les réponses, pour associer une réponse à sa requête. |
| Erreur de décodage | Asterobot n'a pas pu lire entièrement le message. |
Dessous, un aperçu du contenu du message sur une ligne. Cliquez sur une ligne, ou sur la flèche à son début, pour l'ouvrir : vous obtenez tous ses champs en JSON, l'erreur de décodage s'il y en a une et, pour un message que rien n'a pu lire, ses octets bruts. Les champs à leur valeur par défaut sont aussi affichés, et les grands nombres apparaissent sous forme de texte entre guillemets. La référence du protocole Dofus explique la signification des champs.
Les requêtes et les événements nommés ont aussi un bouton en forme d'avion en papier, Renvoyer ce message. Il est censé copier le message dans Envoyer un message de jeu, mais dans cette version ce panneau s'ouvre sans lui : ouvrez Envoyer un message de jeu, choisissez le même message et recopiez ses champs depuis ici.
Suivre, mettre en pause et vider
- Tant que vous êtes en bas, la liste défile à chaque nouveau message. Remontez et elle s'arrête ; le bouton Suivre vous ramène au message le plus récent.
- Pause fige la liste pour ce bot. Les messages qui arrivent pendant la pause ne sont pas conservés, même si l'avis indique « En pause - les nouveaux messages sont toujours enregistrés. » : ils n'apparaissent pas quand vous la désactivez. Les lignes de chat de l'onglet Console s'arrêtent aussi.
- Vider efface la liste pour ce bot, y compris les lignes de chat de l'onglet Console.
Ce qui est conservé
Asteroboard récupère les messages dès son ouverture, quelle que soit la page où vous êtes, et garde environ les 2 000 derniers par bot. Ils sont perdus quand vous rechargez ou fermez Asteroboard : Asterobot n'en garde aucun historique.
Sur un bot MITM, le relais de votre partie peut aussi sauter des messages quand il ne parvient pas à les transmettre assez vite. Votre partie n'est pas affectée, mais un badge au-dessus de la liste indique alors combien de messages la session du bot a écartés, et que la liste est incomplète.
Rechercher
La zone « Rechercher, ou filtrer avec name:Ping direction:inbound » filtre la liste pendant la saisie. Le compteur à côté indique combien de messages correspondent sur combien.
- Séparez les mots par des espaces : un message doit tous les contenir. La casse n'a pas d'importance, et une partie de mot suffit.
field:valuecherche dans un seul champ :name,wirename,kind,direction,bot,uid,sequence,erroroupayload. Les genres sontevent,request,responseetunspecified, les directionsinboundetoutbound.- Un
-devant un mot ou unfield:valueexclut ce qui y correspond. - Un nombre seul est cherché dans tous les champs, par exemple l'identifiant d'un personnage, sans avoir à savoir quel champ le contient.
| Recherche | Affiche |
|---|---|
Chat |
Tous les messages qui contiennent « chat » quelque part. |
name:ChatChannelMessageEvent |
Uniquement ce message. |
kind:request |
Les requêtes. |
direction:inbound -kind:event |
Ce que le serveur a envoyé, sauf les événements. |
Quand rien ne correspond, la liste indique « Aucun message ne correspond à cette recherche. »
Pour creuser davantage les messages, les auteurs de scripts peuvent lire Trouver des messages et Trafic.