Fichiers et dossiers

Asterobot ne garde rien à côté du programme lui-même. Il range tout dans des dossiers standard de votre profil utilisateur : un pour ses réglages, un pour ses données et un pour son cache. Savoir à quoi sert chacun vous indique quoi copier pour sauvegarder votre Asterobot ou le déplacer vers un autre ordinateur.

Où se trouvent les dossiers

Asterobot les crée à son premier démarrage. Ce sont toujours trois dossiers distincts : Asterobot refuse de démarrer si l'un d'eux se trouve dans un autre.

• Sous Windows, %LocalAppData% correspond en général à C:\Users\<your name>\AppData\Local. Taper le chemin, signes % compris, dans la barre d'adresse de l'Explorateur de fichiers ouvre le dossier.
• Sous macOS et Linux, ~ désigne votre dossier personnel.
• Sous Linux, les variables XDG_CONFIG_HOME, XDG_DATA_HOME et XDG_CACHE_HOME remplacent ~/.config, ~/.local/share et ~/.cache quand elles contiennent un chemin absolu.
• Sur tous les systèmes, les options --config-dir, --appdata-dir et --cache-dir, ou leurs variables d'environnement, choisissent d'autres dossiers. Ligne de commande les explique.

Le dossier des réglages

Il contient un seul fichier, config.toml, avec les réglages que vous avez modifiés dans Serveur > Config. Les réglages restés à leur valeur par défaut n'y sont pas écrits, c'est pourquoi le fichier est vide après un premier lancement. La page Config explique comment Asterobot le lit et l'écrit, y compris quand vous le modifiez à la main.

config.toml contient deux secrets une fois qu'ils sont définis : website.token, le jeton de connexion d'Asterobot sur asterobot.net, et les identifiants et mots de passe de server.basicAuth, en clair.

Le dossier des données

C'est ce dossier qui fait de votre Asterobot le vôtre. Le perdre, c'est devoir ajouter de nouveau vos bots, vos comptes et vos paquets.

Le dossier de cache

Le dernier dossier contient les chunks à partir desquels les versions de jeu sont reconstruites, dans son sous-dossier chunk (Comment les chunks sont stockés), ainsi que les listes de versions et de fichiers publiées par les serveurs de téléchargement d'Ankama, avec quelques autres fichiers qu'ils fournissent.

Tout ce qui se trouve dans le cache peut être téléchargé ou reconstruit de nouveau. Le perdre coûte du temps, pas des réglages : vous téléchargez et extrayez de nouveau vos versions de jeu. C'est aussi de loin le plus gros dossier, puisqu'il contient les versions de jeu (Pourquoi Asterobot télécharge Dofus).

Aucun fichier de journal

Asterobot n'écrit aucun fichier de journal. Son journal s'affiche dans le terminal où il tourne, et dans Serveur > Console tant qu'un Asteroboard est ouvert. Une fois la fenêtre du terminal fermée, ses lignes sont perdues : copiez d'abord ce dont vous avez besoin. État et console couvre ces deux endroits.

Permissions

Sous Linux et macOS, Asterobot réserve à votre propre compte utilisateur les fichiers qui contiennent des secrets :

Sous Windows, ces restrictions n'ont aucun effet. Dans tous les cas, quiconque peut ouvrir des fichiers en tant que votre utilisateur, ou obtient une copie de ces fichiers, peut lire les mots de passe et utiliser les jetons qu'ils contiennent. Obtenir de l'aide liste ce qu'il ne faut jamais partager.

Modifier les fichiers à la main

• config.toml : Asterobot le surveille et applique vos modifications dès que vous enregistrez. Voir La page Config.
• bots.toml et accounts.toml : Asterobot ne les lit qu'au démarrage, et les réécrit à chaque changement. Une modification faite pendant qu'il tourne est écrasée. Arrêtez Asterobot avant de les modifier, et gardez une copie de l'original.
• Dossiers des versions de jeu : après en avoir ajouté ou supprimé un à la main, cliquez sur Rescanner dans le Gestionnaire de jeux (Gérer les versions de jeu).
• Dossiers des paquets : ne modifiez pas les fichiers d'un paquet installé depuis le marché. Asterobot les vérifie à chaque chargement du paquet et les refuse s'ils ont changé (Faire confiance à un paquet).

Sauvegarder votre Asterobot

1. Arrêtez Asterobot, pour qu'il n'écrive aucun fichier pendant la copie (Premier lancement).
2. Copiez le dossier des réglages et le dossier des données en lieu sûr. Le dossier de cache est facultatif : tout ce qu'il contient peut être téléchargé de nouveau, mais cela prend du temps.
3. Relancez Asterobot.

Pour restaurer une sauvegarde, arrêtez Asterobot, remettez les dossiers en place, puis démarrez-le.

Passer sur un autre ordinateur

1. Téléchargez et décompressez Asterobot sur le nouvel ordinateur (Télécharger Asterobot).
2. Arrêtez Asterobot sur l'ancien ordinateur.
3. Copiez le dossier des réglages et le dossier des données aux emplacements indiqués en haut de cette page pour le système du nouvel ordinateur. Copiez aussi le dossier de cache si vous ne voulez pas télécharger de nouveau vos versions de jeu.
4. Démarrez Asterobot sur le nouvel ordinateur.

Les fichiers et dossiers qu'ils contiennent gardent les mêmes noms sur tous les systèmes : seuls leurs emplacements changent.

Vérifiez ensuite quelques points :

• Asterobot est toujours connecté à asterobot.net, puisque la connexion voyage dans config.toml.
• Vos bots reviennent déconnectés, comme après tout redémarrage. Un bot dont la version de jeu n'est pas dans le cache est ignoré jusqu'à ce que vous téléchargiez et extrayiez cette version (Déconnecter, supprimer et redémarrer).
• Les réglages qui désignent un dossier de l'ancien ordinateur y pointent toujours si vous les aviez modifiés : botmanager.mitmGamePath et zaapmanager.browserPath. Les réglages que vous n'avez jamais modifiés prennent les valeurs par défaut du nouvel ordinateur.
• Asteroboard retient son URL du serveur navigateur par navigateur. Sur un nouvel ordinateur ou un nouveau navigateur, ouvrez une fois l'adresse du nouvel Asterobot pour vous y connecter (Préférences).

Ce que supprime chaque réinitialisation

Réinitialiser et repartir de zéro vous aide à choisir la bonne réinitialisation quand quelque chose ne fonctionne plus.

Pour aller plus loin

• Ligne de commande
• Mettre à jour Asterobot