Un paquet peut échouer à plusieurs moments : pendant son installation, quand un bot le démarre ou pendant qu'il tourne. Si vous écrivez des paquets, Messages d'erreur, dans la documentation développeur, liste chaque texte avec sa cause.
Trouver d'abord la raison
Plusieurs messages liés aux paquets arrivent sans leur raison, qui se trouve toujours ailleurs :
| Où | Ce que vous y trouvez |
|---|---|
| Le comportement s'est arrêté sur une erreur, sous l'en-tête du bot | L'erreur complète d'un script qui a démarré, puis échoué. Copier la place dans votre presse-papiers. |
| L'onglet Réglages du bot, sous Réglages du paquet | Impossible de lire les réglages de ce paquet, avec la raison, quand le paquet du bot ne peut pas être chargé du tout. |
| L'éditeur d'un paquet local | Le badge d'erreurs dans sa barre du haut, par exemple « 3 erreur(s) », qui compte les problèmes dans tous les fichiers du paquet. |
| L'onglet Console du bot | Ce que le script écrit lui-même, avertissements compris. |
Impossible de démarrer le comportement
Vous avez cliqué sur Lancer, et le script n'a même pas pu démarrer. La notification ne donne aucune raison, et la page du bot n'affiche aucune alerte.
- Vérifiez que le bot est Connecté au serveur de jeu. Charger un paquet et le lancer sur un bot qui n'est pas connecté charge le paquet, puis affiche ce message.
- Ouvrez l'onglet Réglages du bot et cliquez sur Réglages du paquet. Quand le paquet ne peut pas être chargé, Impossible de lire les réglages de ce paquet affiche la raison.
- Retrouvez cette raison dans Pourquoi un paquet ne se charge pas.
Trois autres messages fonctionnent de la même façon, sans raison : Impossible de charger la sélection après le chargement d'un paquet, Impossible de changer de version après le choix d'une autre version dans l'en-tête du bot, et Impossible de lancer le paquet après Lancer dans l'éditeur. Pour chacun, regardez sous Réglages du paquet.
Pourquoi un paquet ne se charge pas
requires asterobot
Le texte ressemble à package "<name>" requires asterobot <range>, running <version>. Le paquet indique avec quelles versions d'Asterobot il fonctionne, et la vôtre n'en fait pas partie. Le Gestionnaire de bibliothèque le marque Incompatible, et son nom passe en orange dans l'en-tête du bot.
- Si la plage demande un Asterobot plus récent, mettez-le à jour : voir Mettre à jour Asterobot.
- Si une autre version installée du paquet est compatible, passez le bot dessus : voir Changer de version.
- Pour un paquet du marché, cliquez sur Vérifier les mises à jour dans le Gestionnaire de bibliothèque : une version plus récente prend peut-être en charge votre Asterobot.
- Sinon, contactez l'auteur.
has an invalid compatibleVersion constraint signifie que l'auteur a mal écrit cette plage. Seul l'auteur peut la corriger.
package source integrity mismatch
Les fichiers d'un paquet installé depuis le marché ne correspondent plus à ceux qu'Asterobot a téléchargés, par exemple parce qu'ils ont été modifiés à la main. Asterobot refuse de le charger.
- Dans le Gestionnaire de bibliothèque, ouvrez le menu du paquet, cliquez sur Supprimer, puis sur Oui, supprimer.
- Réinstallez-le depuis le marché, avec le même lien de fichier. Voir Installer depuis le marché.
- Remettez le bot sur cette version si elle a changé.
Faire confiance à un paquet explique cette vérification.
read package ou is not installed
Le paquet, ou l'un des paquets dont il dépend, n'est pas dans votre bibliothèque à la version dont le bot a besoin. Le texte nomme celui qui manque, comme dans read package <name>@<version> sources:. Cela arrive après la suppression d'un paquet ou d'une dépendance, ou quand l'installation d'une dépendance a échoué.
- Pour un paquet du marché, réinstallez-le depuis le marché : Asterobot télécharge en même temps les dépendances qui lui manquent.
- Si vous avez supprimé cette version exprès, passez le bot sur une version installée.
parse module ou resolve
Un texte qui contient parse module ou resolve signifie que le code du paquet comporte une erreur : une faute de syntaxe, ou un import qui ne pointe vers rien.
- Pour un paquet du marché, vérifiez s'il existe une mise à jour, et prévenez son auteur en lui donnant le texte complet.
- Pour un paquet local, ouvrez-le avec Modifier le code : le badge d'erreurs vous mène au problème. Messages d'erreur explique chaque texte.
Le comportement s'est arrêté sur une erreur
Le script a démarré, puis a échoué. L'alerte affiche son erreur complète, et la colonne Comportement du Gestionnaire de bots indique Échec. Le bot reste connecté, et une partie relayée continue. Voici les textes que les joueurs rencontrent le plus souvent :
| Le texte contient | Ce que ça signifie | Que faire |
|---|---|---|
Game session closed |
La connexion de jeu s'est fermée pendant que le script tournait : vous avez quitté Dofus, le bot a été déconnecté, ou la connexion a été coupée. | Reconnectez le bot, puis cliquez sur Lancer. |
IdentificationRequest.token: unknown protobuf field |
Le script a été écrit à partir d'un ancien exemple qui envoie les mauvais champs pour entrer en jeu. | Mettez à jour le paquet, ou demandez à son auteur de le faire. Auteurs : voir Identifier et lancer. |
JavaScript execution deadline exceeded |
Le script a travaillé plus de 250 ms sans faire de pause. | Prévenez l'auteur. |
behavior event-loop queue overflow |
Le script n'arrive pas à suivre le rythme des messages qu'il reçoit. | Prévenez l'auteur. |
unhandled Promise rejection: |
Une erreur dans le script que rien n'a interceptée. | Prévenez l'auteur, en lui donnant le texte complet. |
behavior requested Game disconnect |
Le script a déconnecté le bot volontairement. | Rien, si le paquet est censé le faire. |
the game engine is not available: |
Asterobot n'a pas pu lire les messages du jeu. | Voir Quand Dofus se met à jour. |
Pour relancer le script, cliquez sur Lancer. Si la même erreur revient, le paquet doit être corrigé.
Installer depuis le marché
| Message | Que faire |
|---|---|
Ce n'est pas un ID de fichier ou une URL asterobot.net valide. |
Copiez l'adresse de la page du fichier lui-même sur asterobot.net, ou son numéro, et non l'adresse de la catégorie. |
Fichier introuvable, ou vous n'avez pas la permission de le voir. |
Vérifiez l'adresse. Regardez ensuite le bouton du compte en bas de la barre latérale : Asterobot doit être connecté à asterobot.net pour se renseigner sur un fichier. |
Vous n'avez pas la permission de télécharger ce fichier. |
Votre compte asterobot.net n'est pas autorisé à télécharger ce fichier, et rien dans Asterobot n'y changera quoi que ce soit. |
| Impossible d'installer le paquet | Le téléchargement ou l'installation a échoué, sans raison. Le fichier n'est peut-être pas un paquet, ou bien il a plus d'une pièce jointe, pèse plus de 32 Mio ou a une dépendance qui ne peut pas être installée. |
Quand une dépendance a échoué, le paquet lui-même est peut-être déjà dans votre bibliothèque sans elle, et il ne démarrera pas. Installer depuis le marché donne les détails.
Mettre à jour
- Impossible de vérifier les mises à jour : la vérification n'a pas abouti. Vérifiez qu'Asteroboard est connecté et qu'Asterobot est connecté à asterobot.net, puis réessayez.
- Impossible d'installer la mise à jour : les mêmes causes que pour une première installation, et pas de raison non plus.
- Pas de bouton Mettre à jour vers, alors que l'auteur a publié une nouvelle version : rien n'est vérifié automatiquement, alors cliquez sur Vérifier les mises à jour. Une version inférieure à la vôtre n'est pas proposée, et un fichier qui n'est plus lisible sur asterobot.net est ignoré sans message.
Voir Mettre à jour les paquets.
Importer et supprimer
- Impossible d'importer le paquet, sans raison : le fichier n'est peut-être pas un
.zip, ou bien il n'a pas d'index.js, pèse plus de 32 Mio ou contient unasterobot.jsoninvalide. Les messages de la fenêtre d'import sur le nom sont dans Gérer votre bibliothèque. - Impossible de supprimer le script : rien n'a été supprimé. Réessayez.
- Après la suppression d'une version, un bot réglé sur celle-ci continue d'exécuter son script jusqu'à ce que le script s'arrête, puis obtient Impossible de démarrer le comportement au prochain clic sur Lancer. Passez le bot sur une autre version.
Réglages et actions du paquet
Ces messages apparaissent dans l'onglet Réglages du bot, sous Réglages du paquet :
| Message | Ce que ça signifie | Que faire |
|---|---|---|
| Impossible d'appliquer les réglages, avec une raison | Une valeur ne correspond pas à ce qu'attend le paquet. Rien du formulaire n'a été enregistré. | Corrigez la valeur nommée dans la raison, puis cliquez de nouveau sur Appliquer. |
Impossible de lancer l'action, avec no behavior is running on this bot |
Les actions ne s'exécutent que pendant que le paquet tourne. | Cliquez sur Lancer, puis sur l'action. |
| Impossible de lancer l'action, avec une autre raison | Un argument ne convient pas, ou le script en cours n'a pas cette action. | Corrigez la valeur, ou cliquez sur Arrêter puis sur Lancer pour que le script en cours corresponde au paquet. |
Le nom de l'action suivi de a échoué |
Le code de l'action elle-même a échoué. Le script continue de tourner. | Prévenez l'auteur. |
Les boutons d'action restent grisés avec « Le bot doit exécuter un comportement pour qu'une action puisse être lancée. » tant qu'aucun script ne tourne. Voir Réglages et actions d'un paquet.
Contacter l'auteur
Seul son auteur peut corriger le code d'un paquet du marché.
- Dans le Gestionnaire de bibliothèque, cliquez sur le nom du paquet.
- Dans ses détails, cliquez sur Voir sur asterobot.net, dans la ligne Source. Cela ouvre le fichier d'où vient le paquet.
- Contactez l'auteur depuis cette page, ou demandez sur le forum à https://asterobot.net/forums/. Joignez le texte complet de l'erreur copié avec Copier, la version du paquet, votre version d'Asterobot indiquée sur Serveur > État, et la version de jeu du bot.
N'y joignez jamais votre config.toml, un jeton ou un mot de passe. Obtenir de l'aide liste ce qui doit rester privé.
Pour aller plus loin
- Lancer un paquet
- Gérer votre bibliothèque
- Messages d'erreur, pour les auteurs de scripts