Beaucoup de paquets vous permettent d'ajuster ce qu'ils font sans toucher à leur code : quelle ressource récolter, combien de temps attendre, une liste de noms auxquels répondre. Ces options sont les réglages du paquet, et les boutons qu'un paquet ajoute sont ses actions. Les deux se trouvent dans l'onglet Réglages du bot, et les deux viennent du paquet sur lequel le bot est réglé.
Les ouvrir
- Sur la page du bot, cliquez sur Réglages.
- Cliquez sur Réglages du paquet, à côté de Configuration du bot.
La section commence par le paquet auquel appartiennent les réglages, sous la forme name@version, et un bouton Actualiser qui les relit, par exemple après avoir changé le paquet du bot depuis un autre onglet.
Viennent ensuite les fiches, une pour chaque paquet du script du bot qui déclare au moins un réglage ou une action : le paquet sur lequel le bot est réglé, et les paquets qu'il utilise. Le titre d'une fiche affiche le nom du paquet, sa version et un décompte comme « 3 réglage(s) · 1 action(s) ». La première fiche est ouverte et les autres sont fermées ; cliquez sur un titre pour ouvrir ou fermer une fiche. Les fiches ne suivent aucun ordre fixe, donc le paquet du bot n'est pas toujours le premier : vérifiez les noms.
Ce sont les réglages du paquet sur lequel le bot est réglé, qu'un script tourne ou non. Vous pouvez les modifier pendant que le bot est arrêté : le script les utilisera à son prochain démarrage.
La section peut aussi afficher l'un de ces contenus à la place :
| Ce que vous voyez | Pourquoi |
|---|---|
| Aucun paquet sélectionné, avec « Les réglages viennent du paquet que le bot exécute. Chargez-en un depuis les actions rapides du bot, puis revenez ici. » | Le bot n'est réglé sur aucun paquet. Un script direct n'a pas de réglages non plus. Voir Lancer un paquet. |
| « Ce comportement ne déclare ni réglage ni action. » | Ni le paquet ni aucun des paquets qu'il utilise n'a quoi que ce soit à régler. |
| Impossible de lire les réglages de ce paquet, suivi d'une raison | Asterobot n'a pas pu lire le paquet : il a été supprimé, il est incompatible avec votre Asterobot, l'un de ses fichiers contient une erreur, ou ses fichiers ont changé après son installation depuis le marché. Le texte sous le titre est l'erreur exacte. Voir Erreurs de paquet. |
Les champs
Le libellé, la description et la valeur par défaut de chaque champ viennent du paquet. Le type de champ dépend du type du réglage :
| Réglage | Champ |
|---|---|
| Activé ou désactivé | Un interrupteur. |
| Une valeur parmi une liste fixe | Une liste déroulante avec les choix que propose le paquet. |
| Texte | Une zone de texte, parfois avec un exemple en gris. |
| Nombre entier | Une zone numérique dont les flèches avancent de 1. Le paquet peut fixer un minimum, un maximum et une unité affichée dans la zone, comme seconds. |
| Nombre décimal | Une zone numérique, avec les mêmes minimum, maximum et unité facultatifs. |
| Liste | Une ligne par élément, numérotée à partir de 0, chacune avec un bouton pour la supprimer, et Ajouter sous les lignes. Une liste vide affiche « Liste vide. » Tous les éléments ont le même type : activé ou désactivé, texte, nombres entiers ou nombres décimaux. |
| Dictionnaire | Une ligne par entrée, avec une zone Clé, la valeur et un bouton pour la supprimer, et Ajouter une entrée sous les lignes. Un dictionnaire vide affiche « Aucune entrée. » Une ligne dont la clé est vide est ignorée. |
Quelques détails vous éviteront des surprises. Vider une zone numérique n'enregistre pas de valeur vide : le champ garde le dernier nombre saisi. Le minimum et le maximum ne font que guider les flèches, et Asterobot les vérifie quand vous appliquez. Un nouvel élément de liste commence désactivé, vide ou à 0, selon son type.
Appliquer vos modifications
Ce que vous modifiez reste dans la page jusqu'à ce que vous l'appliquiez, donc un script en cours ne voit jamais une valeur que vous êtes encore en train de saisir.
- Modifiez un ou plusieurs champs dans la fiche d'un paquet. Non appliqué apparaît sur le titre de la fiche.
- Cliquez sur Appliquer, sous les champs.
Asterobot vérifie chaque valeur par rapport à ce que déclare le paquet, enregistre la fiche pour ce bot et transmet les nouvelles valeurs au script en cours s'il y en a un, sans le redémarrer. Une notification le confirme avec le nom du paquet, par exemple Réglages de my-harvester appliqués. Que le script tienne compte d'un changement tout de suite dépend de la façon dont son auteur l'a écrit.
Réinitialiser remet la fiche à ses valeurs enregistrées. Appliquer et Réinitialiser restent grisés tant que rien n'a changé. Chaque fiche s'applique séparément, et rien de tout cela ne passe par Enregistrer dans Configuration du bot.
Quand une valeur est refusée, Impossible d'appliquer les réglages s'affiche avec la raison, et rien de la fiche n'est enregistré :
| Raison, par exemple | Ce qui ne va pas |
|---|---|
delay: 5 is below the minimum 10 |
Le nombre est inférieur au minimum fixé par le paquet. |
delay: 900 is above the maximum 600 |
Le nombre dépasse le maximum. |
count: want a whole number, got 2.5 |
Un nombre décimal dans un réglage de nombre entier. |
package "my-harvester" declares no parameter "delay" |
Le paquet a changé pendant que la page était ouverte. Cliquez sur Actualiser et réessayez. |
Où les réglages sont conservés
Les réglages du paquet sont enregistrés par bot, sous le nom du paquet. Un autre bot qui lance le même paquet a ses propres valeurs. Un bot garde ses valeurs quand son script s'arrête, quand Asterobot redémarre et quand vous le passez sur une autre version du même paquet. Quand une version plus récente supprime un réglage ou change son type, la valeur enregistrée ne s'applique plus et le réglage affiche à nouveau la valeur par défaut du paquet.
La fiche d'une dépendance contient les réglages propres à cette dépendance. Sur un même bot, tous les paquets qui utilisent la même dépendance partagent ces valeurs.
Réglages dans la boîte de dialogue Ajouter un bot
Quand vous choisissez un paquet de la bibliothèque dans l'onglet Comportement / Script de la boîte de dialogue Ajouter un bot, ses réglages apparaissent juste sous le sélecteur, sous Réglages, pour que le bot démarre avec vos valeurs. Il n'y a ni Appliquer ni actions à cet endroit, puisque le bot n'existe pas encore : Asterobot enregistre les valeurs juste après avoir ajouté le bot, avant de le connecter. Si cela échoue, Impossible d'appliquer les réglages s'affiche avec le nom du paquet. Le bot est ajouté malgré tout, avec les valeurs par défaut du paquet, et vous pouvez saisir à nouveau vos valeurs dans son onglet Réglages.
Actions
Les actions d'un paquet sont des boutons sous Actions dans sa fiche, chacun marqué d'un éclair. Survolez-en un pour lire ce qu'il fait.
Une action s'exécute dans le script du bot, donc elle ne fonctionne que pendant que le bot en lance un. Sinon, les boutons sont grisés, et en survoler un affiche « Le bot doit exécuter un comportement pour qu'une action puisse être lancée. »
- Cliquez sur l'action. Si elle a besoin de valeurs de votre part, une boîte de dialogue s'ouvre avec le nom de l'action pour titre et un champ par valeur, rempli avec les valeurs par défaut du paquet à chaque ouverture. Remplissez les champs et cliquez sur Exécuter, ou sur Annuler.
- Action lancée s'affiche : l'action a été transmise au script.
- Quand le script a terminé, une notification affiche le nom de l'action suivi de terminée, ou de a échoué avec l'erreur. Ce nom est celui que le paquet utilise dans son code, qui peut différer du libellé du bouton. Un avis d'échec reste à l'écran jusqu'à ce que vous le fermiez.
Une action qui échoue n'arrête pas le script : le bot continue de jouer.
Quand une action ne peut pas du tout être transmise au script, Impossible de lancer l'action s'affiche avec la raison :
| Raison | Ce qui s'est passé |
|---|---|
no behavior is running on this bot |
Le script s'est arrêté avant votre clic. |
the running behavior declares no action "<action>" on package "<package>" |
Le script qui tourne n'est pas celui que décrit cette page : un script direct, ou une version qui tournait avant que vous changiez de version. Cliquez sur Arrêter, puis sur Lancer. |
| Le nom de la valeur suivi d'une raison | Une valeur de la boîte de dialogue a été refusée, pour les mêmes raisons que les réglages. |
Si vous écrivez des paquets, Déclarer des réglages, Lire les réglages et Déclarer des actions expliquent l'autre côté.
Pour aller plus loin
- Mettre à jour les paquets
- Réglages du bot, pour la section Configuration du bot du même onglet