Un bot ne lance qu'un paquet à la fois. Vous choisissez lequel et le bot s'en souvient ; son script s'exécute ensuite chaque fois que vous appuyez sur Lancer, tant que le bot est connecté à une partie. Les auteurs de scripts trouveront ce qui se passe à l'intérieur du script dans Lancer, arrêter et recharger.
Paquet choisi et script en cours
Le paquet sur lequel un bot est réglé et le fait qu'il le lance réellement sont deux choses distinctes.
- L'en-tête de la page du bot affiche le paquet sur lequel il est réglé :
name@version, Script direct ou Aucun paquet sélectionné. Cela reste quand le script s'arrête. Après un redémarrage d'Asterobot, le paquet reste aussi, mais un script direct disparaît. - Lancer devient Arrêter pendant que le script tourne. Dans le Gestionnaire de bots, la colonne Comportement indique En cours, Arrêté ou Échec.
Un bot peut donc être réglé sur un paquet sans le lancer. Vous pouvez aussi changer le paquet d'un bot pendant que son script tourne : le script continue, et le changement s'applique à son prochain démarrage. Charger un nouveau paquet fait exception, puisqu'il arrête d'abord le script.
Choisir un paquet
| Où | Comment | Quand cela prend effet |
|---|---|---|
| Ajouter un bot | Dans Comportement / Script, sélectionnez Paquet de la bibliothèque et choisissez-le sous Paquet. | Il est enregistré avec le nouveau bot. Quand le bot se connecte tout de suite (Se connecter maintenant), Lancer le comportement directement le démarre dès que le bot est connecté. Voir Ajouter un bot. |
| L'onglet Réglages du bot | Sous Configuration du bot, choisissez-le sous Paquet, puis cliquez sur Enregistrer. | Au prochain clic sur Lancer. Un script en cours n'est pas touché. |
| Le menu à côté de Lancer | Charger un nouveau paquet, ci-dessous. | Immédiatement : le script en cours est arrêté. |
Chaque sélecteur liste tous les paquets de votre bibliothèque sous la forme name@version, et propose En télécharger un pour installer sur-le-champ un paquet du marché. Voir Installer depuis le marché.
Charger un nouveau paquet
- Sur la page du bot, ouvrez le menu à côté de Lancer et choisissez Charger un nouveau paquet. La boîte de dialogue Charger une sélection de comportement s'ouvre.
- Laissez Paquet de la bibliothèque sélectionné et choisissez le paquet sous Sélectionner un paquet installé.
- Cliquez sur Charger un nouveau paquet en bas de la boîte de dialogue.
Asteroboard arrête d'abord le script que le bot exécute, puis règle le bot sur le paquet choisi, comme si vous l'aviez choisi dans l'onglet Réglages. La description de la boîte de dialogue indique que le chargement n'affecte rien de ce qui est déjà en cours, mais il arrête bel et bien le script actuel. Rien ne démarre tant que vous ne cliquez pas sur Lancer.
Note
Charger depuis cette boîte de dialogue règle aussi la Langue du bot sur le français, quelle que soit la langue choisie avant. Si le bot utilise une autre langue, choisissez-la à nouveau dans son onglet Réglages.
Charger un paquet et le lancer, dans le même menu, ouvre la même boîte de dialogue et appuie sur Lancer pour vous une fois le paquet chargé. Si le bot n'est pas connecté à une partie, le paquet est chargé mais Impossible de démarrer le comportement s'affiche.
Dans le Gestionnaire de bots, le menu de la ligne de chaque bot propose aussi Charger un nouveau paquet, qui ouvre la même boîte de dialogue. Quand le chargement échoue, Impossible de charger la sélection s'affiche, sans raison.
Décharger le paquet
Décharger le paquet, dans le même menu, arrête le script en cours et retire le paquet du bot. L'en-tête affiche alors Aucun paquet sélectionné, et Lancer ouvre Charger une sélection de comportement au lieu de démarrer quoi que ce soit. Les réglages du paquet que vous avez enregistrés pour ce paquet restent sur le bot, prêts si vous le chargez à nouveau.
Dans le menu de ligne du Gestionnaire de bots, Décharger le paquet est grisé tant que le bot n'a rien de chargé. Si le déchargement échoue, Impossible de décharger le paquet s'affiche.
Lancer et Arrêter
Lancer démarre le paquet sur lequel le bot est réglé. Le bouton 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. » Un bot en mode Full socket y arrive après Connecter, un bot en mode MITM, pour « homme du milieu » (man-in-the-middle), dès que votre client Dofus l'a rejoint. Voir Mode Full socket et Mode MITM.
Quand le bot n'a encore rien à lancer, Lancer ouvre la boîte de dialogue Charger une sélection de comportement à la place.
Chaque démarrage lit les fichiers du paquet tels qu'ils sont dans votre bibliothèque à ce moment-là. Il n'y a pas de bouton Recharger : pour redémarrer un script, cliquez sur Arrêter, puis sur Lancer.
Arrêter met fin au script. Le bot reste connecté au jeu.
Les mêmes Lancer et Arrêter se trouvent dans le menu de la ligne de chaque bot du Gestionnaire de bots.
Quand le script ne démarre pas
| Ce que vous voyez | Ce que cela signifie |
|---|---|
| Impossible de démarrer le comportement | Le script n'a même pas pu démarrer. La notification ne donne pas de raison. Causes fréquentes : le paquet a été supprimé, il est incompatible avec votre Asterobot, l'un de ses fichiers contient une erreur, une dépendance manque, ou ses fichiers ont été modifiés après son installation depuis le marché. |
| Le comportement s'est arrêté sur une erreur, en haut de la page du bot | Le script a démarré, puis a échoué. L'alerte affiche l'erreur complète avec un bouton Copier. Voir Page du bot. |
| Impossible d'arrêter le comportement | L'arrêt a échoué. |
Tip
Quand Impossible de démarrer le comportement ne vous donne aucune piste, ouvrez l'onglet Réglages du bot et cliquez sur Réglages du paquet. Quand le paquet ne peut pas être lu, l'alerte Impossible de lire les réglages de ce paquet qui s'y affiche donne la vraie raison.
Erreurs de paquet liste les erreurs et leurs solutions.
Passer à une autre version
Quand votre bibliothèque contient plusieurs versions du paquet que lance un bot, le nom du paquet dans l'en-tête du bot devient un menu.
- Cliquez sur le nom du paquet dans l'en-tête. Le menu liste toutes ses versions installées, de la plus récente à la plus ancienne. La version actuelle est cochée, et les versions incompatibles avec votre Asterobot apparaissent en orange.
- Cliquez sur la version voulue.
Réglé sur la version suivi du numéro de version le confirme. Si un script tourne, la notification ajoute « Le comportement en cours continue jusqu'au prochain lancement ou rechargement. » : le script continue d'exécuter la version avec laquelle il a démarré jusqu'à ce que vous cliquiez sur Arrêter puis sur Lancer.
Le même menu propose Voir ce paquet, qui ouvre la page du paquet. Avec une seule version installée, le nom du paquet est un lien vers cette page au lieu d'un menu. Si le changement échoue, Impossible de changer de version s'affiche, sans raison.
Le nom dans l'en-tête passe en orange quand la version sur laquelle le bot est réglé est incompatible.
Exécuter un script direct rapide
Pour un test rapide qui ne mérite pas un paquet, un bot peut exécuter du code que vous collez. C'est surtout utile quand vous écrivez des scripts : voir Votre boîte à outils.
- Ouvrez le menu à côté de Lancer et choisissez Charger un nouveau paquet.
- Sélectionnez Script direct et collez le code dans la zone de texte.
- Cliquez sur Charger un nouveau paquet, puis sur Lancer.
Un script direct est un fichier unique qui n'est jamais enregistré. Il disparaît quand vous chargez autre chose, quand vous cliquez sur Décharger le paquet et quand Asterobot redémarre. Il n'a pas de réglages du paquet.
Charger un script direct ne change pas le paquet sur lequel le bot est réglé. Si le bot en avait déjà un, son en-tête continue d'afficher ce paquet, mais Lancer exécute le script direct jusqu'à ce que l'un des événements ci-dessus l'efface. L'en-tête n'affiche Script direct que pour un bot qui n'est réglé sur aucun paquet.
Après un redémarrage
Quand Asterobot redémarre, tous les bots reviennent déconnectés, sans aucun script en cours. Rien ne se connecte ni ne se lance tout seul. Chaque bot reste réglé sur son paquet et sa version, avec ses réglages du paquet : connectez-le et cliquez sur Lancer. Un script direct n'est pas conservé : chargez-le à nouveau.
Il en va de même quand la connexion d'un bot coupe : le script s'arrête avec elle, et il ne redémarre pas quand le bot se reconnecte. Voir Déconnecter, supprimer et redémarrer.
Pour aller plus loin
- Réglages et actions d'un paquet
- Console, pour suivre ce que fait le script