Votre premier bot

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.

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.

1. Dans la barre latérale, ouvrez le Gestionnaire de jeux et cliquez sur Télécharger un jeu.
2. 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.
3. Laissez Filtre de fichiers (regex) tel quel. Il limite le téléchargement aux fichiers dont un bot a besoin.
4. Vérifiez que la case Extraire les données après le téléchargement est cochée.
5. 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.

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

1. Ouvrez le Gestionnaire de bots et cliquez sur Ajouter un bot.
2. 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.
3. 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.
4. 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.
5. Dans l'onglet Comportement / Script, laissez Aucun sélectionné.
6. 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.

3. Lancer Dofus et jouer

1. Lancez Dofus depuis l'Ankama Launcher, maintenant que le bot attend. Si Dofus était déjà ouvert, fermez-le et relancez-le.
2. 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 :

1. 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.
2. 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.

5. Observer les messages de votre jeu

1. Sur la page du bot, ouvrez Outils. L'outil Réseau s'ouvre sur son panneau Trafic.
2. Passez à Réglages. La liste contient tous les messages qu'Asterobot sait nommer. Ceux qu'utilisent vos deux interrupteurs sont déjà cochés.
3. Tapez un mot dans Filtrer les messages... pour réduire la liste, cochez les messages que vous voulez suivre, puis cliquez sur Appliquer.
4. 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.