L'onglet Console est l'endroit où vous suivez un bot minute par minute. Il réunit trois sources dans un même fil, classé par heure : ce qu'Asterobot fait avec le bot, ce qu'écrit le script du bot, et le chat du jeu. Votre premier bot active le chat pour la première fois ; cette page couvre le reste.
Ce qu'affiche la console
| Source | Lignes |
|---|---|
| Asterobot | Ce qu'Asterobot fait avec le bot : connexion, changements d'état, erreurs. Par exemple Relaying a game session quand un bot MITM (« homme du milieu », man-in-the-middle) prend en charge votre partie. |
| Script | Ce que le script du bot écrit avec botDebug(), botInfo(), botWarn() et botError(). |
| Tchat | Le chat du jeu que reçoit le bot, tant que Chat en direct est activé. |
Chaque ligne commence par l'heure, dans le fuseau horaire de votre navigateur. Les lignes Asterobot et de script affichent ensuite leur niveau, DEBUG, INFO, WARN ou ERROR, puis leur texte. Les lignes de chat affichent le nom du personnage qui parle, puis ce qu'il a dit.
Un script peut aussi écrire avec asterobot:console. Ces lignes n'apparaissent pas ici : elles vont dans Serveur > Console, sans indiquer quel bot les a écrites. Voir État et console et, pour les auteurs de scripts, Journalisation et débogage.
Ce qui est conservé
Asterobot conserve les 200 dernières lignes Asterobot et de script de chaque bot. Quand vous ouvrez l'onglet, la console commence par ces lignes, puis les nouvelles arrivent au fur et à mesure. Asterobot ne les garde qu'en mémoire : elles disparaissent quand il redémarre. Asteroboard affiche jusqu'à 500 lignes par bot tant qu'il reste ouvert.
Le chat fonctionne autrement : Asterobot n'en garde rien. Asteroboard récupère les lignes de chat tant qu'il est ouvert et que Chat en direct est activé, et les perd quand vous le rechargez ou le fermez. Elles proviennent aussi de la même source que les messages du panneau Trafic de l'outil Réseau, ce qui a trois conséquences :
- Tant que Pause est activé dans Trafic, les lignes de chat n'arrivent plus dans la console non plus.
- Vider dans Trafic retire aussi les lignes de chat de la console.
- Une fois que ce panneau contient environ 2 000 messages pour le bot, les plus anciens disparaissent, et leurs lignes de chat avec eux.
Voir Trafic réseau.
Chat en direct
L'interrupteur Chat en direct, en haut à droite, active le chat du jeu pour ce bot. C'est le même réglage que le message ChatChannelMessageEvent dans les Réglages de l'outil Réseau : activer l'un active l'autre. Le choix est enregistré avec le bot : il reste tel que vous l'avez laissé après un redémarrage, et tous ceux qui ouvrent ce bot voient la même chose.
Seul le chat qui arrive pendant que l'interrupteur est activé s'affiche : les messages antérieurs n'apparaissent pas ensuite.
L'interrupteur ne change que ce qu'affiche Asteroboard. Un script reçoit le chat, que l'interrupteur soit activé ou non.
Filtrer et chercher
- Sources choisit les sources affichées : cochez ou décochez Asterobot, Script et Tchat. Quand un script écrit beaucoup, ne garder que Script le rend plus facile à suivre.
- Filtrer garde les lignes qui contiennent ce que vous tapez, sans tenir compte des majuscules et des minuscules. Pour une ligne de chat, il regarde à la fois le nom du personnage et le message. La croix dans la zone l'efface.
Tant que quelque chose est masqué, le haut de la console indique combien de lignes vous voyez sur combien, par exemple 12 sur 340. Quand rien ne correspond, la console indique « Aucune ligne ne correspond au filtre. » Une console vide indique « Aucun message pour le moment. »
Copier
Le bouton de copie, Copier ce qui est affiché, copie les lignes visibles sous forme de texte, une par ligne, par exemple 14:03:12 [info] Relaying a game session ou 14:05:40 Sender-Name: hello. Une notification confirme le nombre de lignes copiées.
Suivre les dernières lignes
Tant que vous êtes en bas, la console défile à chaque nouvelle ligne. Remontez pour lire quelque chose, et elle arrête de suivre pour que les lignes ne bougent pas sous vos yeux. Un bouton Suivre apparaît alors en bas à droite : cliquez dessus pour revenir à la dernière ligne et reprendre le suivi.
Le point à côté du nom du bot, en haut à gauche, pulse en vert tant qu'Asteroboard est connecté à Asterobot. Si la connexion tombe puis revient pendant que l'onglet est ouvert, la console recharge les lignes conservées.
Envoyer un message dans le chat
La zone en bas de la console envoie un message dans le chat du jeu.
Warning
Le message part vraiment dans le jeu, au nom de votre personnage, sur le canal général (GLOBAL), où les joueurs autour de votre personnage peuvent le lire.
- Tapez votre message dans « Dire quelque chose dans le chat du jeu... ».
- Appuyez sur Entrée, ou cliquez sur le bouton d'envoi à côté de la zone.
La zone se vide une fois le message parti. Elle ne peut utiliser que le canal général. Pour parler sur un autre canal, envoyez ChatChannelMessageRequest depuis l'outil Réseau en renseignant son champ channel : voir Envoyer des messages à la main.
Le bot doit être connecté à une partie. Si le message ne peut pas être envoyé, l'alerte Impossible d'envoyer le message apparaît au-dessus des lignes avec la raison, par exemple bot has no game connection: "my-bot".