Alarmes

Décidez de la suite quand un membre de l'équipe, un message privé, le nom du personnage, un événement du module de chat ou n'importe quel message du jeu atteint l'un de vos bots : les événements que suivent les alarmes, les règles par défaut, écrire les vôtres sur la page Alarmes avec des conditions sur l'événement, chaque réaction, les notifications dans Asteroboard ou sur n'importe quel service web par une simple requête HTTP, et les dernières alarmes.

Une alarme suit ce qui arrive à vos bots : un membre de l'équipe qui parle à l'un d'eux, l'avertit, le rend muet ou se tient sur sa carte, un joueur qui lui écrit en privé, le nom de son personnage dit dans un canal, les événements du module de chat, et tout message que le jeu lui envoie et que vous choisissez d'intercepter. Ses règles disent la suite : une notification dans Asteroboard ou sur n'importe quel service web, le chat en pause, une phrase dite, un paquet lancé, le script arrêté, un message du jeu envoyé, le bot déconnecté. Les règles sont une seule liste pour tout Asterobot, et chaque règle peut surveiller tous les bots ou certains.

Les alarmes marchent que le module de chat soit allumé ou éteint : elles lisent le même chat que la Console.

Ce que suivent les alarmes

Un membre de l'équipe est reconnu comme le fait le client du jeu : une ligne que le serveur marque comme celle d'un administrateur ou dite dans le canal de l'équipe, une fenêtre d'avertissement, un mutisme, et sur la carte, un personnage dont le rôle de compte n'est pas celui d'un joueur.

Chaque événement dit quelque chose : qui et quoi, dans des champs. Les conditions d'une règle et les textes de ses réactions les lisent.

Les règles par défaut

Tant que vous ne les changez pas, deux règles s'appliquent :

La page Alarmes les montre avec Les règles par défaut : enregistrées au premier changement : la première fois que vous enregistrez, elles sont écrites dans un fichier qui est alors le vôtre.

La page Alarmes

Ouvrez Alarmes dans le menu d'Asteroboard. La page montre le formulaire des règles à gauche et leur JSON à droite, tous deux en direct, comme dans l'éditeur de profils de chat. Sauvegarder envoie les règles à Asterobot, qui les vérifie et nomme le champ en cause de ce qu'il refuse ; Annuler les changements remet les règles telles qu'enregistrées. Quitter la page avec des changements non enregistrés demande d'abord.

Ajouter une règle en ajoute une à la fin. Les règles s'appliquent dans l'ordre ; les flèches en montent ou en descendent une.

Quand plusieurs règles prennent le même événement, chacune se déclenche, côte à côte, et une réaction que deux règles demandent pour le même événement, avec les mêmes réglages, n'est faite qu'une fois. Une règle qui répète une réaction, un message, une attente et le même message, la fait à chaque fois. Attendre ne retient que la suite de sa propre règle. Une règle que vous désactivez ou supprimez pendant son Attendre ne fait plus rien ensuite, et la console du bot le dit.

Condition

Ajouter un champ ajoute une condition sur un des champs de l'événement. Toutes doivent être vraies pour que la règle se déclenche ; pour un « ou », écrivez deux règles.

Un champ que l'événement n'a pas rend la condition fausse. Par exemple, une règle qui prend Modération avec reason vaut mute ne se déclenche que sur un mutisme.

Messages du jeu

Une règle peut prendre n'importe quel message que le jeu envoie au bot : tapez game: et le nom du message dans Événements, comme game:CharacterLevelUpEvent. Chaque fois que le jeu envoie ce message au bot, la règle le prend, avec les champs du message.

• Noms : le nom d'un message et ceux de ses champs sont les noms lisibles de la référence du protocole de Dofus, avec des tirets bas : new_level. L'outil Réseau du bot montre les messages que le jeu envoie vraiment, avec de vraies valeurs. Un nom que le protocole n'a pas est refusé à l'enregistrement.
• Champs : un champ imbriqué s'écrit avec des points, l'élément d'une liste avec son indice : author.name, parameters.0. json est le message entier, en JSON.
• Coût : un message qu'aucune règle ne nomme ne coûte rien. Seuls les messages que vos règles nomment sont lus en champs.
• Sens : seulement ce que le jeu envoie au bot. Les requêtes du bot lui-même ne sont pas suivies.

Par exemple, pour être prévenu quand un personnage atteint le niveau 200 : Événements game:CharacterLevelUpEvent, Condition new_level est au-dessus de 199, Réactions Notifier.

Certains champs ont encore de courts noms brouillés, comme galg : Asterobot ne sait pas encore ce qu'ils contiennent, et leurs noms peuvent changer avec une mise à jour du jeu, alors ne bâtissez pas de règle dessus.

Les réactions

Une ligne à dire ou à écrire en privé est un modèle de message, et lit les variables de l'alarme en plus de celles du personnage : chaque champ de l'événement, {sender}, {text}, {who}, {channel}, {minutes}..., et {bot}, {character}, {rule}, {event}. Celles du personnage passent d'abord : dans une ligne, {name}, {server} et {time} sont le nom, le serveur et l'heure du personnage. Par exemple {Désolé|Salut} {sender}, je suis occupé pour l'instant. La ligne d'une alarme passe par le garde comme toute autre, mais une pause ne la retient pas.

Une ligne de console et les textes d'un message du jeu ne lisent que les variables de l'alarme : chaque champ de l'événement, et {bot}, {character}, {server}, {rule}, {event}, et {time}, la date et l'heure de l'événement, comme 2026-10-28T14:05:09+01:00. Une variable que l'événement n'a pas y est vide, et les accolades qui ne nomment aucune variable restent telles quelles.

Une réaction qui ne peut pas être faite écrit pourquoi dans la console du bot, Alarm Staff: play failed: no package "@me:hide" is installed, apparaît dans les Dernières alarmes, et la règle continue.

Notifications

Une réaction Notifier avec la destination Asteroboard affiche une notification dans chaque Asteroboard ouvert, quelle que soit la page : « Nom-du-bot : un membre de l'équipe », « Nom-du-bot : message privé de Nom-du-joueur », « Nom-du-bot : Nom-du-joueur cite le nom du personnage », « Nom-du-bot : trop de spam, le chat attend 5 minutes », et pour celui d'un déclencheur, d'un script ou d'un message du jeu, le nom de l'événement, avec ce qui a été dit. Celle d'un membre de l'équipe reste jusqu'à ce que vous la fermiez. Ouvrir mène à la page du bot.

Destinations

En plus d'Asteroboard, une réaction Notifier peut joindre n'importe quel service web : une application de discussion, un service de notifications sur votre téléphone, un serveur à vous. Chaque destination est une simple requête HTTP que vous écrivez. Ajouter une destination, sous les règles de la page Alarmes, en ajoute une.

L'URL, les valeurs des en-têtes et le corps lisent les variables de l'alarme, comme une ligne de console : {bot}, {character}, {server}, {rule}, {event}, {time}, et chaque champ de l'événement, {sender}, {text}, {who}... Chaque valeur est échappée selon l'endroit où elle tombe, pour qu'un guillemet dans un message privé ne casse jamais votre requête :

• Dans l'URL : encodée pour l'URL. Vendeur A devient Vendeur%20A.
• Dans un corps JSON : échappée pour le JSON, à écrire entre guillemets : "text": "{text}". {json}, un message du jeu en JSON, va tel quel : "message": {json}, et en null pour un événement qui n'est pas un message du jeu.
• Dans un corps de formulaire, avec l'en-tête Content-Type: application/x-www-form-urlencoded : encodée pour l'URL.
• Dans un en-tête : sur une seule ligne.

Le corps part avec votre en-tête Content-Type quand vous en donnez un. Sans lui, un corps qui est un objet ou un tableau JSON, ses variables mises à part, part en application/json, et tout le reste en text/plain.

Tester

Tester envoie la destination une fois, telle qu'elle est sur la page, enregistrée ou non, avec un événement d'exemple : le bot Asterobot, l'événement test, le texte « This is a test from Asterobot ». Il montre ce que le service a répondu : Le service l'a acceptée avec son statut, ou Le service ne l'a pas acceptée avec la raison, comme the service answered 401 Unauthorized et le début de sa réponse, ou no answer within 10 s.

L'envoi

Les requêtes de chaque destination partent une par une, dans l'ordre, et un service a 10 secondes pour répondre. Quand il ne répond pas, dit qu'il reçoit trop de requêtes (429) ou a un problème de son côté (5xx), la requête repart après 2, 10 et 30 secondes. Toute autre réponse est définitive, puisque c'est la requête elle-même qui ne va pas. Une requête qui échoue pour de bon écrit pourquoi dans la console du bot : Alarm Staff: My phone didn't take the request: the service answered 401 Unauthorized.

Au plus 100 requêtes attendent pour une même destination. Au-delà, Notifier échoue pour cette destination, et le dit dans les Dernières alarmes. Une requête qui attend encore son tour après 10 minutes, pendant que le service est en panne, est abandonnée sans partir, pour que les alarmes que vous recevez à son retour soient récentes ; la console du bot le dit.

Une URL ou un jeton reste dans alarms.json, sur votre ordinateur. Asterobot ne les écrit jamais dans une ligne de console.

Exemples

Chaque service documente la requête qu'il accepte : son URL, et les noms qu'il donne aux champs de son corps. La plupart prennent l'une de ces trois formes.

Un webhook JSON, l'URL que l'application vous a donnée, son corps un objet JSON :

Un service de notifications qui prend le message en texte brut, son titre dans un en-tête :

Un service qui prend tout dans son URL, et un jeton dans un en-tête :

Dernières alarmes

Sous les règles et les destinations, Dernières alarmes liste les 100 dernières alarmes déclenchées, les plus récentes en premier, jusqu'au redémarrage d'Asterobot : quand, l'événement et son bot, son personnage et son serveur, ses champs, la règle, et chaque réaction, Fait ou avec la raison pour laquelle elle n'a pas pu l'être, au survol. Une règle avec Attendre apparaît une fois toutes ses réactions faites. Une réaction Notifier est Fait dès que ses requêtes sont parties : celle qui échoue ensuite écrit pourquoi dans la console du bot.

Le fichier des alarmes

Les règles sont le fichier alarms.json du dossier des données d'Asterobot (Fichiers et dossiers). Ce que vous enregistrez sur la page Alarmes s'applique tout de suite ; un changement que vous faites à la main dans le fichier s'applique au prochain démarrage d'Asterobot.

{
  "version": 1,
  "destinations": [
    {
      "name": "Mon téléphone",
      "method": "POST",
      "url": "https://push.example.com/mon-sujet",
      "headers": { "Title": "{bot} : {event}" },
      "body": "{who}{sender} {text}"
    }
  ],
  "rules": [
    { "name": "Staff", "events": ["staff"], "do": [ { "pauseChat": 1800 }, { "notify": [] } ] },
    { "name": "Messages", "events": ["whisper", "mention"], "do": [ { "notify": ["Asteroboard"] } ] },
    {
      "name": "Mutisme",
      "events": ["staff"],
      "match": { "reason": "mute" },
      "do": [ { "stopScript": {} }, { "wait": 60 }, { "disconnect": { "reconnectAfter": 3600 } } ]
    },
    {
      "name": "Niveau 200",
      "events": ["game:CharacterLevelUpEvent"],
      "match": { "new_level": { "above": 199 } },
      "do": [ { "notify": ["Asteroboard"] }, { "log": "{character} a atteint le niveau {new_level}" } ]
    },
    {
      "name": "Répondre aux MP",
      "events": ["whisper"],
      "bots": ["Farmer-1", "Farmer-2"],
      "every": 600,
      "do": [ { "whisper": { "text": "{Désolé|Salut} {sender}, je suis occupé pour l'instant" } } ]
    }
  ]
}

Un fichier inutilisable, comme un fichier modifié à la main avec une erreur, affiche Le fichier est inutilisable : les règles par défaut s'appliquent avec le champ en cause, et les règles par défaut s'appliquent jusqu'à ce que vous le corrigiez.

Read this page in English