Référence des réglages

Asterobot compte 19 réglages, regroupés ici par thème. Vous les modifiez dans Serveur > Config (La page Config) ou dans config.toml. Les réglages qui demandent un redémarrage ne prennent effet qu'au prochain démarrage d'Asterobot.

Tous les réglages en un coup d'œil

Sur la page Config, chaque groupe est une carte qui porte le nom de la première partie de ses clés, et les cartes suivent l'ordre alphabétique plutôt que l'ordre de cette page.

Connexion à Asteroboard

Ces réglages décident où et comment Asteroboard joint Asterobot. Les valeurs par défaut n'acceptent que les connexions venant de l'ordinateur sur lequel tourne Asterobot. Pour joindre Asterobot depuis un autre appareil, suivez Asteroboard sur un autre appareil plutôt que de les modifier un par un, et lisez d'abord Sécurité.

server.listenAddress

Texte. Par défaut : 127.0.0.1:8080. Redémarrage nécessaire.

L'adresse et le port sur lesquels Asterobot attend Asteroboard, au format address:port. Avec 127.0.0.1, seul l'ordinateur sur lequel tourne Asterobot peut se connecter. 0.0.0.0:8080 accepte les connexions sur toutes les interfaces réseau de l'ordinateur.

Modifiez-le quand un autre programme utilise déjà le port 8080, ou quand Asteroboard tourne sur un autre appareil. Gardez en tête que :

• Si Asterobot ne peut pas utiliser l'adresse, par exemple parce que le port est déjà pris, il s'arrête juste après son démarrage avec An error occurred during the server's initialization process.
• Au démarrage, Asterobot ouvre votre navigateur sur 127.0.0.1 avec ce port. Cela ne fonctionne que si la valeur est une adresse IP suivie d'un port. Avec un nom comme localhost:8080, le terminal affiche Failed to open frontend et Asterobot continue de tourner : ouvrez Asteroboard vous-même.
• Asteroboard continue d'utiliser son ancienne URL du serveur après le redémarrage. Ouvrez la nouvelle adresse d'Asterobot dans votre navigateur, ou modifiez URL du serveur dans Préférences.
• Le port apparaît aussi dans la ligne qu'Asterobot écrit dans votre dossier Dofus pour le mode MITM, pour « homme du milieu » (man-in-the-middle) : voir Mode MITM.

server.basicAuth

Identifiants et mots de passe. Vide par défaut. Redémarrage nécessaire. Masqué.

Les identifiants et mots de passe à saisir pour accéder à Asterobot. Vide signifie aucun mot de passe, ce qui ne pose pas de problème tant que seul votre propre ordinateur peut se connecter.

Il s'édite en JSON sur la page Config, avec un identifiant par entrée :

{"alice": "a long password", "bob": "another long password"}

Les mots de passe sont stockés en clair dans config.toml. Dès qu'un identifiant est défini, Serveur > État affiche Protégé par mot de passe (État et console).

server.tls

Activé ou désactivé. Désactivé par défaut. Redémarrage nécessaire.

Sert Asterobot en HTTPS au lieu de HTTP. La première fois qu'Asterobot démarre avec ce réglage activé, il crée son propre certificat, tls/cert.pem, et sa clé privée, tls/key.pem, dans son dossier de données (Fichiers et dossiers). Le certificat est valable trois ans, uniquement pour les noms localhost, 127.0.0.1 et ::1, et signé par Asterobot lui-même : les navigateurs affichent donc un avertissement jusqu'à ce que vous l'acceptiez.

La description sur la page Config parle du répertoire de cache, mais les deux fichiers se trouvent dans le dossier de données. Pour obtenir un nouveau certificat, supprimez-les et redémarrez Asterobot.

Avec ce réglage activé, l'URL du serveur d'Asteroboard doit commencer par https://, et le navigateur qu'Asterobot ouvre au démarrage utilise https://127.0.0.1 avec le port de server.listenAddress.

server.skipOpenFrontend

Activé ou désactivé. Désactivé par défaut. Sans redémarrage.

Asterobot ouvre votre navigateur sur Asteroboard à chaque démarrage. Activez ce réglage pour l'en empêcher, par exemple sur un ordinateur sans écran, ou quand Asteroboard est déjà ouvert. Il est lu à chaque démarrage d'Asterobot.

Journal

Les deux niveaux de journalisation sont indépendants : l'un pour le terminal dans lequel tourne Asterobot, l'autre pour Serveur > Console. Tous deux prennent l'une de quatre valeurs, et chaque niveau affiche ses propres lignes et celles de tous les niveaux au-dessus :

État et console détaille ces deux endroits.

logger.cliLevel

Niveau de journalisation. Par défaut : INFO. Sans redémarrage.

La quantité de lignes qu'affiche le terminal depuis lequel Asterobot a été lancé. Passez-le à DEBUG quand quelqu'un qui vous aide demande un journal détaillé, puis remettez-le à INFO : les lignes de débogage sont nombreuses.

logger.webLevel

Niveau de journalisation. Par défaut : INFO. Sans redémarrage.

La quantité de lignes qui arrivent dans Serveur > Console. Les lignes sous ce niveau ne sont jamais envoyées à Asteroboard. La liste Niveau serveur de l'onglet Console modifie ce même réglage.

Connexion à asterobot.net

website.token

Texte. Vide par défaut. Sans redémarrage. Masqué.

Le jeton de connexion d'Asterobot sur asterobot.net. Asterobot l'enregistre quand vous confirmez un code de connexion, et le vide quand vous vous déconnectez. Vous n'avez aucune raison d'y taper quoi que ce soit.

Quiconque obtient cette valeur peut utiliser votre accès à asterobot.net : ne la partagez jamais (Obtenir de l'aide). La rétablir déconnecte Asterobot.

website.showQRCode

Activé ou désactivé. Désactivé par défaut. Sans redémarrage.

Affiche le lien de connexion sous forme de QR code dans le terminal, pour que vous puissiez confirmer le code depuis un téléphone. Pratique quand Asterobot tourne sur une machine sans navigateur. Le réglage s'applique à partir du prochain code demandé par Asterobot. Voir Se connecter avec asterobot.net.

website.signedOut

Activé ou désactivé. Désactivé par défaut. Sans redémarrage.

S'active quand vous vous déconnectez, et se désactive quand vous vous connectez. Tant qu'il est activé, Asterobot ne lance jamais de connexion de lui-même, pas même après un redémarrage. Laissez le bouton du compte s'en charger : le désactiver à la main permet seulement à Asterobot de lancer de lui-même une nouvelle connexion la prochaine fois qu'il a besoin de votre compte. Voir Votre compte.

Mode MITM

Ces réglages ne concernent que les bots en mode MITM, abréviation de man-in-the-middle (« homme du milieu »), où un bot relaie le Dofus auquel vous jouez. Un bot qui se connecte seul ne les utilise jamais. Mode MITM explique ce mode, et MITM sur plusieurs machines les installations où Dofus tourne sur un autre ordinateur.

botmanager.mitmSignInPort

Nombre. Par défaut : 5555. Redémarrage nécessaire.

Le port sur lequel votre Dofus se connecte une fois que ses fichiers pointent vers Asterobot. Ne le modifiez que si un autre programme utilise déjà ce port sur cet ordinateur. Il doit être différent de botmanager.mitmSessionPort.

botmanager.mitmSessionPort

Nombre. Par défaut : 5556. Redémarrage nécessaire.

Le port sur lequel votre Dofus ouvre sa session de jeu, après la connexion. Un seul port sert à tous les bots relayés : Asterobot distingue les sessions d'après ce qu'elles envoient. Ne le modifiez que si un autre programme utilise déjà ce port.

botmanager.mitmBindHost

Texte. Par défaut : 127.0.0.1. Redémarrage nécessaire.

L'interface réseau sur laquelle écoutent les deux ports. 127.0.0.1 n'accepte que les connexions venant de cet ordinateur, ce qui convient quand vous jouez dessus. Pour relayer un Dofus qui tourne sur un autre ordinateur, indiquez l'adresse de cet ordinateur sur votre réseau, ou 0.0.0.0 pour toutes les interfaces. Tout ce qui se trouve sur ce réseau peut alors joindre les deux ports.

botmanager.mitmAdvertiseHost

Texte. Vide par défaut. Redémarrage nécessaire.

L'adresse à laquelle votre Dofus reçoit l'instruction de se connecter. Vide, c'est botmanager.mitmBindHost qui sert, ou 127.0.0.1 quand celui-ci vaut 0.0.0.0. Renseignez-le quand Asterobot écoute sur 0.0.0.0, ou se trouve derrière un NAT, avec l'adresse que l'ordinateur de Dofus peut réellement joindre.

botmanager.mitmGamePath

Texte. Valeur par défaut selon le système. Sans redémarrage.

Le dossier du Dofus auquel vous jouez, celui qu'a installé l'Ankama Launcher. Asterobot lit le numéro de version dans son fichier Dofus_Data/StreamingAssets/version et en modifie une ligne pendant qu'un bot attend votre jeu. Il ne lit rien d'autre dans ce dossier.

La valeur par défaut n'est remplie que si ce dossier existe au démarrage d'Asterobot. Indiquez le dossier vous-même sur macOS, ou quand votre Dofus est installé ailleurs. Une nouvelle valeur s'applique dès qu'aucun bot n'attend votre jeu.

Connexion automatique aux comptes Ankama

Ces réglages affinent la façon dont Asterobot connecte les comptes Ankama au moyen d'un navigateur. Aucun n'est nécessaire au fonctionnement de la connexion automatique : c'est l'enregistrement du mot de passe d'un compte qui l'active. Connexion automatique explique tout le processus.

zaapmanager.browserHeadless

Activé ou désactivé. Activé par défaut. Sans redémarrage.

Lance le navigateur de connexion sans fenêtre. Désactivez-le, sur un ordinateur avec un écran devant lequel vous êtes, pour suivre la connexion et répondre à une vérification affichée par Ankama. Réactivez-le ensuite. Le réglage s'applique à partir de la prochaine connexion.

zaapmanager.browserPath

Texte. Vide par défaut. Sans redémarrage.

Le chemin complet du navigateur utilisé pour se connecter à Ankama. Vide, Asterobot cherche Google Chrome, Chromium ou Microsoft Edge à leurs emplacements habituels. Renseignez-le pour un navigateur installé à un endroit inhabituel, ou pour un autre navigateur basé sur Chromium comme Brave, Vivaldi ou Opera. Quand il est renseigné, Asterobot utilise ce navigateur et aucun autre.

zaapmanager.browserUserAgent

Texte. Vide par défaut. Sans redémarrage.

La façon dont le navigateur de connexion s'identifie auprès des pages qu'il ouvre. Vide, il se présente comme Chrome sous Windows 11, avec le numéro de version majeure du navigateur réellement installé. Ce que vous saisissez remplace cette identité. Laissez-le vide, sauf si vous avez une raison précise de le changer.

Listes de téléchargement du jeu

Quand Asterobot télécharge des versions de jeu, il garde dans son dossier de cache des copies de deux sortes de listes venant des serveurs de téléchargement d'Ankama : la liste des versions de jeu disponibles et, pour chaque version, la liste des fichiers qui la composent. Ces deux réglages limitent le nombre de copies conservées. Vous aurez rarement besoin de les modifier.

cytrus.keepMostRecentIndexes

Nombre. Par défaut : 5. Sans redémarrage.

Le nombre de copies de la liste des versions de jeu disponibles qu'Asterobot conserve. Les copies plus anciennes sont supprimées. 0 conserve toutes les copies. La commande gamemanager registry liste les versions trouvées dans les copies conservées (Ligne de commande).

cytrus.keepMostRecentGamesManifests

Nombre. Par défaut : 5. Sans redémarrage.

Le nombre de listes de fichiers qu'Asterobot conserve pour chaque jeu. Les plus anciennes sont supprimées. 0 les conserve toutes.

Pour aller plus loin

• La page Config
• Ligne de commande