La connexion d'un bot et son script ont chacun un état, et la page du bot comme le Gestionnaire de bots vous donnent les boutons pour les changer.
États de connexion
| État | Signification | Ce que vous pouvez faire |
|---|---|---|
| Déconnecté | Aucune connexion, et pas d'attente d'un client de jeu. | Connecter, avec un compte, ou Commencer l'attente. |
| Connexion… | Une tentative de connexion est en cours : connexion à Ankama, échange avec le serveur de connexion ou ouverture de la connexion au serveur de jeu. | Attendre, ou cliquer sur Déconnecter pour l'annuler. |
| En attente de votre réponse | Le bot a besoin que vous choisissiez un serveur dans l'encart Choisissez un serveur. | Choisir un serveur, ou cliquer sur Déconnecter. |
| Connecté au serveur de connexion | L'étape du serveur de connexion est terminée, mais aucune connexion à un serveur de jeu n'est ouverte. Cet état s'affiche un instant entre deux étapes d'une connexion Full socket, et il reste affiché quand un bot Full socket a perdu sa connexion au jeu. | Cliquer sur Déconnecter, puis de nouveau sur Connecter. |
| En attente de votre client de jeu | Le bot attend un client Dofus que vous jouez, en mode MITM, pour « homme du milieu » (man-in-the-middle). Il peut rester ainsi indéfiniment. | Lancer Dofus et vous connecter, ou cliquer sur Déconnecter. |
| Connecté au serveur de jeu | Le bot a une connexion à un serveur de jeu : la sienne en mode Full socket, ou la session de votre jeu en mode MITM. | Lancer, ou Déconnecter. |
Un bot ne change d'état que parce que vous le lui avez demandé, ou parce qu'une tentative de connexion s'est terminée, qu'une session relayée est arrivée ou qu'une connexion a été perdue. Quand une connexion est perdue, rien ne se reconnecte : un bot Full socket reste sur Connecté au serveur de connexion, et un bot MITM revient à En attente de votre client de jeu.
Mode Full socket et Mode MITM décrivent le parcours à travers ces états dans chaque mode.
États du script
La colonne Comportement du Gestionnaire de bots affiche l'état du script du bot :
| État | Signification |
|---|---|
| En cours | Le script du paquet chargé tourne. |
| Arrêté | Aucun script ne tourne. Le bot peut quand même avoir un paquet chargé. |
| Échec | Le script s'est arrêté sur une erreur. La page du bot en indique la raison. |
L'en-tête de la page d'un bot
L'en-tête comporte deux groupes de commandes, l'un pour la connexion et l'autre pour le paquet.
Connexion
- Tant que le bot est Déconnecté, le groupe affiche Connecter et Commencer l'attente. Connecter est grisé pour un bot sans compte, avec l'infobulle « Ce bot n'a aucun compte Ankama pour se connecter. »
- Dans tous les autres états, il affiche Déconnecter, qui met fin à ce qui est en cours : une tentative de connexion, une attente ou une connexion.
Quand Connecter échoue, Asteroboard affiche Impossible de connecter le bot avec la raison. Quand Commencer l'attente échoue, il affiche Impossible de mettre le bot en attente, et quand Déconnecter échoue, Impossible de déconnecter le bot.
Paquet
- Le paquet que le bot lancera : son nom et sa version, Script direct pour un script collé, ou Aucun paquet sélectionné. Quand plusieurs versions de ce paquet sont installées, c'est un menu qui permet de passer le bot sur une autre version, avec un lien vers la page du paquet. Lancer un paquet explique le changement de version.
- Lancer démarre le script du paquet chargé. Il reste grisé tant que le bot n'est pas Connecté au serveur de jeu, avec l'infobulle « Connectez le bot à une partie avant d'exécuter un comportement. » Si rien n'est chargé, il ouvre la fenêtre de chargement au lieu de lancer quoi que ce soit. Si le script ne peut pas démarrer, Asteroboard affiche Impossible de démarrer le comportement.
- Arrêter remplace Lancer pendant que le script tourne. Il arrête le script et laisse la connexion telle quelle. Impossible d'arrêter le comportement signifie que l'arrêt a échoué.
- Le menu au bout du groupe contient trois entrées :
- Charger un nouveau paquet ouvre la fenêtre Charger une sélection de comportement. Choisissez Paquet de la bibliothèque, puis sélectionnez un paquet installé ou cliquez sur En télécharger un, ou choisissez Script direct et collez un script, puis cliquez sur Charger un nouveau paquet en bas de la fenêtre. Le script en cours est d'abord arrêté, et le nouveau choix n'est pas démarré : appuyez ensuite sur Lancer. La description de la fenêtre indique que le chargement n'affecte pas un script en cours, mais il l'arrête bel et bien. Si le chargement échoue, Asteroboard affiche Impossible de charger la sélection.
- Charger un paquet et le lancer ouvre la même fenêtre et appuie sur Lancer une fois le paquet chargé.
- Décharger le paquet arrête le script en cours et retire le paquet du bot, qui affiche alors Aucun paquet sélectionné. Impossible de décharger le paquet signifie que l'opération a échoué.
Il n'y a pas de bouton de rechargement : pour redémarrer un script, cliquez sur Arrêter, puis sur Lancer. Charger un paquet avec la fenêtre remet aussi la langue du bot en français, comme l'explique Réglages du bot. Lancer un paquet détaille le lancement des paquets.
Actions de ligne dans le Gestionnaire de bots
Les trois points au bout de la ligne d'un bot dans le Gestionnaire de bots ouvrent les mêmes actions, regroupées de la même façon, plus Supprimer le bot :
| Action | Disponible |
|---|---|
| Connecter | Tant que le bot est Déconnecté et qu'il a un compte. |
| Commencer l'attente | Tant que le bot est Déconnecté. |
| Déconnecter | Dans tous les autres états. |
| Lancer, ou Arrêter pendant que le script tourne | Lancer dès que le bot est Connecté au serveur de jeu. |
| Charger un nouveau paquet | Toujours. |
| Décharger le paquet | Seulement quand le bot a un paquet ou un script direct chargé. |
| Supprimer le bot | Toujours. Voir Déconnecter, supprimer et redémarrer. |
Charger un paquet et le lancer ne se trouve que dans l'en-tête de la page du bot, et Supprimer le bot que dans ce menu.
Alertes de problème
Quand quelque chose échoue, une alerte rouge apparaît sous l'en-tête, sur chaque onglet de la page du bot :
| Alerte | Quand elle apparaît |
|---|---|
| Impossible de connecter ce bot | La dernière tentative de connexion du bot a échoué. L'alerte affiche la raison. |
| Le comportement s'est arrêté sur une erreur | Le script s'est terminé sur une erreur, y compris quand sa connexion au jeu a été perdue. L'alerte affiche l'erreur. |
Le texte peut être sélectionné, Copier le place dans votre presse-papiers, et Masquer cache l'alerte. Une alerte masquée reste cachée jusqu'à l'arrivée d'une autre erreur ou jusqu'au rechargement de la page. L'alerte de connexion disparaît quand vous cliquez à nouveau sur Connecter.
Certaines erreurs de script n'atteignent jamais cette alerte. Quand un script ne peut même pas être chargé, par exemple à cause d'une erreur de syntaxe ou d'un import introuvable, Asteroboard affiche seulement Impossible de démarrer le comportement, sans la raison. Pour un paquet de votre bibliothèque, l'onglet Réglages du bot indique la raison, sous Réglages du paquet. Les erreurs levées une fois le script démarré atteignent bien l'alerte. Erreurs de paquet vous aide dans les deux cas.
Une seule tentative de connexion à la fois
Un bot n'effectue qu'une tentative de connexion à la fois. Asteroboard ne propose Connecter et Commencer l'attente que lorsqu'un bot est déconnecté, vous rencontrerez donc rarement ce cas. Si une seconde tentative arrive malgré tout, par exemple depuis un autre onglet Asteroboard ouvert, Asterobot la refuse et Asteroboard affiche Impossible de connecter le bot.
Un bot n'a également qu'une session de jeu à la fois : il ne peut pas attendre votre client de jeu pendant qu'il est connecté tout seul, ni se connecter tout seul pendant qu'il relaie votre jeu.
Pour aller plus loin
- Page du bot, pour les onglets de la page d'un bot.
- Lancer un paquet
- Déconnecter, supprimer et redémarrer