En mode Full socket, un bot fait de lui-même ce que ferait un client Dofus. Asterobot connecte le compte Ankama du bot, choisit un serveur de jeu et ouvre la connexion vers celui-ci, sans la moindre fenêtre Dofus. Ensuite, c'est un paquet qui prend le relais.
Caution
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é.
Ce qu'il vous faut
- Asterobot connecté à asterobot.net. Voir Se connecter avec asterobot.net.
- Un compte Ankama enregistré et connecté, qu'aucun autre bot n'utilise, et qui n'est protégé ni par Ankama Shield ni par l'authentification à deux facteurs. Voir Ajouter un compte et Shield et authentification à deux facteurs.
- Une version de jeu prête pour un bot : fichiers du jeu téléchargés et données de jeu extraites. Voir Télécharger une version de jeu et Extraire les données de jeu.
- Un bot avec ce compte et cette version de jeu. Voir Ajouter un bot.
- Un script de connexion, pour faire entrer le bot en jeu une fois connecté. La section suivante explique pourquoi.
Pourquoi un paquet doit identifier le bot
Le rôle d'Asterobot s'arrête une fois la connexion au serveur de jeu ouverte. Il n'envoie pas l'identification que le serveur de jeu attend ensuite, et il ne choisit pas de personnage. Tant que rien ne s'en charge, le bot est connecté à un serveur de jeu, mais pas en jeu. C'est le travail d'un script de connexion : un paquet que vous lancez sur le bot avec Lancer, qui l'identifie et entre en jeu.
Note
Bientôt disponible. Des scripts de connexion prêts à l'emploi, un basique et un complet, seront publiés pour que vous puissiez les lancer et les réutiliser. En attendant, vous pouvez écrire le vôtre en suivant Identifier et lancer dans la documentation développeur, ou utiliser le mode MITM, pour « homme du milieu » (man-in-the-middle), qui ne demande aucun script de connexion.
Connecter
- Ouvrez la page du bot : cliquez sur son nom dans le Gestionnaire de bots.
- Cliquez sur Connecter dans l'en-tête. Pour un bot sans compte, le bouton est grisé, avec l'infobulle « Ce bot n'a aucun compte Ankama pour se connecter. »
- Surveillez l'état affiché à côté. Il indique Connexion…, puis finit sur Connecté au serveur de jeu.
- Cliquez sur Lancer pour démarrer le script de connexion. Voir Lancer un paquet.
Connecter se trouve aussi dans le menu du bot dans le Gestionnaire de bots, et Se connecter maintenant fait la même chose juste après l'ajout d'un bot.
Quand la connexion échoue, Asteroboard affiche Impossible de connecter le bot avec la raison, et une alerte Impossible de connecter ce bot reprenant la même raison reste affichée sous l'en-tête du bot. Un échec a sa propre notification : quand la version de jeu du bot n'est pas prête, Asteroboard affiche La version du jeu du bot n'est pas encore prête, en vous invitant à vérifier la version dans le Gestionnaire de jeux.
Les étapes d'une connexion
Avant d'envoyer quoi que ce soit sur le réseau, Asterobot vérifie qu'il peut confirmer votre compte asterobot.net et que la version de jeu du bot est prête. La connexion passe ensuite par trois étapes. L'onglet Console du bot raconte chacune d'elles.
| Étape | Ce que fait Asterobot | État | Lignes de la console |
|---|---|---|---|
| Connexion Ankama | Utilise la connexion du compte pour obtenir un ticket à usage unique pour le jeu. Quand cette connexion ne fonctionne plus, Asterobot la renouvelle, ou reconnecte le compte via le navigateur s'il a un mot de passe enregistré. | Connexion… | Connecting to Zaap..., Connected to Zaap |
| Serveur de connexion | S'identifie avec le ticket et l'identifiant de machine du bot, reçoit la liste des serveurs du compte et sélectionne un serveur. | Connexion…, ou En attente de votre réponse pendant que vous choisissez un serveur | Connecting to login server..., Connected to login server, Identified with login server, Server selected, Login completed, Disconnected from login server |
| Serveur de jeu | Ouvre la connexion vers le serveur de jeu sélectionné. | Connecté au serveur de connexion un instant, puis Connexion… | Connecting to game server..., Connected to game server |
Une fois terminé, l'état indique Connecté au serveur de jeu. L'onglet Informations du bot affiche alors le compte Ankama et le serveur sur lequel se trouve le bot, comme décrit dans Informations.
Chaque échange avec le serveur de connexion et chaque connexion à un serveur de jeu est limité à 30 secondes. Quand le serveur de connexion ne répond pas à temps, la connexion échoue avec connect to login server: timed out waiting for a response.
Comment le serveur est choisi
Chaque bot a un réglage Choix du serveur, choisi dans Ajouter un bot et modifiable dans les Réglages du bot.
| Choix du serveur | Ce que fait le bot |
|---|---|
| Le plus récemment joué | Le choix par défaut. Choisit le serveur du personnage joué le plus récemment sur le compte, parmi les serveurs en ligne et ouverts au compte. S'il n'y a pas de tel personnage, il prend le serveur auquel ce bot s'est connecté en dernier, puis le premier serveur en ligne et ouvert. |
| Toujours ce serveur | Se connecte à chaque fois au serveur choisi dans Forcer un serveur. Quand ce serveur est hors ligne ou pas ouvert au compte, le bot ne va nulle part ailleurs : il s'arrête et vous demande. |
| Me demander à chaque fois | S'arrête toujours pour vous demander de choisir un serveur. |
Le plus récemment joué vous demande aussi quand aucun serveur n'est en ligne et ouvert au compte. Après chaque passage réussi par le serveur de connexion, Asterobot retient le serveur sélectionné comme celui auquel ce bot s'est connecté en dernier, quel que soit le choix qui l'a désigné.
L'encart Choisissez un serveur
Quand un bot vous demande, son état passe à En attente de votre réponse, et un encart Choisissez un serveur apparaît sous l'en-tête, sur chaque onglet de la page du bot. Son texte, « Ce bot est configuré pour toujours demander - choisissez ci-dessous le serveur de connexion. », reste le même quand le bot demande parce que votre serveur forcé n'est pas disponible. Où que vous soyez dans Asteroboard, une notification signale aussi que le bot a besoin de votre saisie, avec un bouton Aller au bot.
Chaque fiche de serveur affiche l'image du serveur, son nom et son numéro, puis des badges : En ligne ou Maintenance, le type du serveur, Mono-compte pour les serveurs mono-compte, et le nombre de personnages que le compte y possède. L'icône d'information à côté du nom affiche la description du serveur. Seuls les serveurs en ligne et ouverts au compte sont cliquables ; les autres sont grisés.
Cliquez sur un serveur : le bot continue aussitôt, passe par le serveur de connexion et rejoint le serveur de jeu, sans autre clic. Si la réponse n'aboutit pas, Asteroboard affiche Impossible d'envoyer votre réponse.
Asterobot ne fixe aucune limite de temps à cette question. Pour abandonner, cliquez sur Déconnecter.
Connecté au serveur de jeu, mais pas en jeu
Connecté au serveur de jeu signifie que la connexion au serveur de jeu est ouverte, rien de plus. Asterobot ne peut pas savoir si le bot s'est identifié : l'état est le même, que le script de connexion ait fait son travail ou non.
- Si aucun script ne tourne, rien n'identifie le bot. Appuyez sur Lancer avec un script de connexion chargé.
- Les lignes écrites par le script lui-même dans l'onglet Console du bot vous indiquent comment s'est passée l'identification.
Si le serveur de jeu ferme la connexion, la console affiche Game connection lost et l'état revient à Connecté au serveur de connexion, et non à Déconnecté. Un script en cours s'arrête, et la page du bot affiche Le comportement s'est arrêté sur une erreur avec un message mentionnant Game session closed. Rien ne se reconnecte tout seul : cliquez sur Déconnecter, puis sur Connecter, puis sur Lancer.
Le bot ne se connecte pas traite le cas d'un bot qui se connecte mais n'entre jamais en jeu.
Erreurs de connexion courantes
| La raison contient | Ce que cela signifie |
|---|---|
this bot's game version is not ready to connect yet |
Les fichiers du jeu ou les données de jeu du bot ne sont pas prêts. Finalisez-les dans le Gestionnaire de jeux. |
ankama account authorization required |
La connexion du compte ne fonctionne plus, et il n'a pas de mot de passe enregistré pour se reconnecter. Connectez-le depuis le Gestionnaire de comptes. |
account not found |
Le compte du bot a été supprimé du Gestionnaire de comptes. |
identification was refused: account already connected elsewhere |
Le compte est déjà en jeu, dans Dofus ou avec un autre bot. |
this installation is not entitled to start bots |
Asterobot n'a pas pu confirmer votre compte asterobot.net. Vérifiez qu'il est connecté, depuis le bouton du compte dans la barre latérale, et qu'il peut joindre asterobot.net. |
Le bot ne se connecte pas liste chaque erreur avec sa solution.
Déconnecter
Cliquez sur Déconnecter dans l'en-tête, ou dans le menu du bot dans le Gestionnaire de bots. Cela fonctionne à toutes les étapes : pendant la connexion, pendant que le bot attend votre choix de serveur, et une fois qu'il est connecté. Le script en cours s'arrête, les connexions se ferment et l'état passe à Déconnecté. Le bot conserve tous ses réglages. Voir Déconnecter, supprimer et redémarrer.
Un bot connecté en mode Full socket ne peut pas en même temps attendre votre client de jeu : un compte Ankama n'a qu'une session de jeu à la fois. Déconnectez-le d'abord pour passer en mode MITM.
Pour aller plus loin
- Lancer un paquet, pour démarrer le script de connexion.
- États et commandes, pour chaque état et chaque bouton.
- Plusieurs bots, pour faire tourner plusieurs comptes.