Les bots et la page du jeu travaillent à partir de versions de jeu qu'Asterobot a téléchargées depuis les serveurs de téléchargement d'Ankama. Votre premier bot en télécharge une avec les valeurs par défaut.
Ouvrir la fenêtre de téléchargement
- Dans la barre latérale, ouvrez le Gestionnaire de jeux.
- Cliquez sur Télécharger un jeu.
La fenêtre Télécharger une version de jeu s'ouvre, déjà remplie pour le Dofus qu'utilisent les bots. La même fenêtre s'ouvre depuis Ajouter un jeu, sur l'onglet Jeu de la fenêtre Ajouter un bot.
Les champs
| Champ | Par défaut | Rôle |
|---|---|---|
| Jeu | dofus |
Le jeu à télécharger. |
| Plateforme | windows |
La plateforme dont il faut télécharger les fichiers. |
| Environnement | dofus3 |
L'environnement du jeu. |
| Version | latest |
Un numéro de version, comme 3.6.6.6, ou latest pour la version la plus récente publiée par Ankama. |
| Filtre de fichiers (regex) | Les fichiers dont un bot a besoin | Une expression régulière comparée aux chemins des fichiers du jeu. Seuls les fichiers qui correspondent sont téléchargés. Vide, il télécharge tous les fichiers. |
| Filtre de fragments (regex) | Vide | Une expression régulière comparée aux noms des parties en lesquelles Ankama découpe un jeu. Vide, il télécharge toutes les parties. |
| Extraire les données après le téléchargement | Coché | Lance l'extraction des données de jeu de la version dès la fin du téléchargement. |
Télécharger reste grisé tant que Jeu, Plateforme, Environnement et Version ne sont pas tous remplis. Annuler ferme la fenêtre sans rien télécharger.
Jeu, Plateforme et Environnement
Ces trois champs acceptent n'importe quel texte et proposent des valeurs pendant la saisie. Les suggestions viennent de la liste des jeux et des versions publiée par Ankama, qui comprend d'autres jeux Ankama en plus de Dofus. Chaque champ ne propose que ce qui va avec les champs situés au-dessus : les plateformes du jeu choisi, puis les environnements de ce jeu sur cette plateforme.
Une seule combinaison fonctionne avec les bots : dofus, windows et dofus3. Une version de Dofus pour Windows dans un autre environnement a quand même une page du jeu. Les versions d'autres jeux ou d'autres plateformes se téléchargent et apparaissent dans le tableau comme les autres, mais aucun bot ne peut les utiliser, elles n'ont pas de page du jeu et leur extraction échoue.
Vérifier les mises à jour, en haut de la fenêtre, récupère à nouveau la liste d'Ankama, pour que les suggestions incluent ce qui a été publié depuis. Quand Ankama est injoignable, les suggestions viennent des listes qu'Asterobot a enregistrées auparavant. Quand Asteroboard ne peut pas joindre Asterobot, il affiche Impossible de vérifier les mises à jour, et vous pouvez toujours saisir les valeurs vous-même.
Version
Les suggestions comprennent toutes les versions trouvées dans les listes enregistrées par Asterobot, pas seulement la plus récente. Le réglage cytrus.keepMostRecentIndexes fixe le nombre de ces listes qu'Asterobot conserve, et cytrus.keepMostRecentGamesManifests le nombre de listes de fichiers qu'il conserve pour chaque jeu (Référence des réglages).
latest est résolu au moment où vous cliquez sur Télécharger : Asterobot demande à Ankama sa liste actuelle et prend la version la plus récente pour le jeu, la plateforme et l'environnement choisis. Si Ankama est injoignable, Asterobot utilise la dernière liste qu'il a enregistrée. Le tableau affiche toujours le vrai numéro de version, jamais latest.
Filtre de fichiers (regex)
Le champ contient au départ le motif qu'Asterobot utilise pour les fichiers dont un bot a besoin : les textes du jeu, les tables de données, les données des cartes, le graphe de déplacement du monde, le fichier de version et quelques séries d'images. Gardez-le, sauf si vous savez qu'il vous en faut davantage. Un champ vide télécharge le jeu complet. Pour ajouter des fichiers à une version plus tard, utilisez Télécharger plus de fichiers dans son menu plutôt que de la télécharger à nouveau (Gérer les versions de jeu).
Filtre de fragments (regex)
Ankama découpe chaque version de jeu en parties nommées. Ce filtre ne garde que les fichiers des parties dont le nom correspond, en plus du filtre de fichiers. Le champ propose win64 en exemple. Laissez-le vide, sauf si vous avez une raison de restreindre le téléchargement.
Un filtre qui n'est pas une expression régulière valide fait échouer le téléchargement, avec une raison qui mentionne invalid file filter ou invalid fragment filter.
Extraire les données après le téléchargement
Quand la case est cochée, Asteroboard lance l'extraction dès la fin du téléchargement, exactement comme si vous cliquiez vous-même sur Extraire les données (Extraire les données de jeu). La case est cochée à la première ouverture de la fenêtre. Une fois un téléchargement lancé, Asteroboard la laisse décochée à la prochaine ouverture de la fenêtre, jusqu'à ce que vous quittiez la page : cochez-la de nouveau quand vous en avez besoin.
Important
C'est Asteroboard qui lance cette extraction : gardez-le ouvert jusqu'à la fin du téléchargement. Si vous le fermez ou le rechargez avant, le téléchargement continue, mais la version reste marquée Non extrait. Ouvrez alors son menu et cliquez sur Extraire les données.
Télécharger une version que vous avez déjà
Télécharger un jeu ne télécharge rien pour une version déjà présente dans le tableau avec le statut En attente, Téléchargement, Vérification ou Installé : les filtres sont ignorés et la version reste telle quelle. Avec Extraire les données après le téléchargement coché, une version installée est extraite à nouveau. Pour lui ajouter des fichiers, utilisez Télécharger plus de fichiers. Une version dont le statut est Échec est téléchargée à nouveau, avec les filtres que vous indiquez.
Un seul téléchargement à la fois
Les téléchargements et les vérifications de fichiers attendent dans une file unique, et un seul d'entre eux s'exécute à la fois, quels que soient le jeu ou la version. Les autres affichent En attente jusqu'à leur tour. Les extractions et la vérification des chunks ne passent pas par cette file.
Suivre le téléchargement
La version apparaît dans le tableau du Gestionnaire de jeux dès que vous cliquez sur Télécharger.
| Statut | Signification |
|---|---|
| En attente | Le téléchargement attend son tour. |
| Téléchargement | Les fichiers se téléchargent. Une barre de progression et un compteur indiquent l'avancée. |
| Vérification | Les fichiers de la version sont en cours de vérification après Vérifier les fichiers. |
| Installé | Le téléchargement est terminé. |
| Échec | Le téléchargement s'est arrêté. Survolez l'icône d'information à côté du statut pour lire la raison. |
Le compteur compte des chunks et des fichiers reconstruits, pas des octets : il donne une idée de l'avancement plutôt qu'une taille. Une fois le téléchargement terminé, la colonne Jeu affiche l'icône et le nom du jeu. Avec Extraire les données après le téléchargement coché, la colonne Extraction passe ensuite à Extraction en cours puis à Extrait, et la colonne Prêt passe à Prêt pour un bot.
Fermer Asteroboard n'arrête pas un téléchargement, puisqu'il s'exécute dans Asterobot. Arrêter Asterobot, si. Au redémarrage d'Asterobot, une version interrompue de cette façon affiche Installé bien que des fichiers manquent, et sa colonne Prêt indique Pas prêt. Ouvrez son menu, cliquez sur Télécharger plus de fichiers et gardez le filtre par défaut : les fichiers terminés sont conservés et seul le reste est téléchargé.
Asterobot ne vérifie pas l'espace libre sur votre disque avant de télécharger. Si le disque se remplit, le téléchargement s'arrête avec Échec.
Quand un téléchargement échoue
| Ce que vous voyez | Que faire |
|---|---|
| Impossible de mettre en file d'attente le téléchargement quand vous cliquez sur Télécharger | Asterobot a refusé la demande ou était injoignable. La cause habituelle est un latest impossible à résoudre, parce que le jeu, la plateforme ou l'environnement ne figure pas dans la liste d'Ankama. Choisissez-les parmi les suggestions, cliquez sur Vérifier les mises à jour et vérifiez qu'Asterobot a accès à internet. |
| Échec, avec une raison liée au réseau ou aux serveurs d'Ankama | Ouvrez le menu de la version et cliquez sur Réessayer. Le téléchargement reprend là où il s'est arrêté. |
Échec, avec invalid file filter ou invalid fragment filter dans la raison |
Cliquez sur Réessayer et corrigez le filtre dans la fenêtre. |
Échec, avec download queue is full or the server is shutting down |
Asterobot était en train de s'arrêter, ou trop de téléchargements attendaient. Cliquez sur Réessayer une fois qu'Asterobot fonctionne normalement. |
Problèmes de téléchargement du jeu couvre d'autres cas.
Télécharger les fichiers requis pour un bot
Sur l'onglet Jeu de la fenêtre Ajouter un bot, et sur l'onglet Réglages d'un bot, Asteroboard vérifie la version choisie sous Version du jeu et affiche des badges à côté :
- Compatible ou Version différente (Pourquoi Asterobot télécharge Dofus) ;
- « Vérification des fichiers requis... », puis Prêt quand les fichiers dont un bot a besoin sont sur le disque, ou Fichiers requis manquants avec un bouton Télécharger les fichiers requis ;
- l'état de l'extraction, par exemple Non extrait, sur lequel vous pouvez cliquer pour extraire la version.
Télécharger les fichiers requis ne télécharge que les fichiers manquants de cette version, dans la même file que les autres téléchargements. Une fois le téléchargement terminé, le badge passe à Prêt. Ce bouton n'extrait pas la version : cliquez sur le badge d'extraction une fois le téléchargement fini. Si le téléchargement échoue, Asteroboard affiche Impossible de télécharger les fichiers requis.
Tant qu'il manque à la version ses fichiers ou ses données de jeu, l'onglet indique « Cette version a besoin à la fois de ses fichiers de jeu et de ses données extraites avant qu'un bot puisse s'y connecter ». La même vérification figure sur l'onglet Informations de la page du jeu de la version, dans la carte Fichiers requis (Page du jeu). Ajouter un bot décrit le reste de la fenêtre.
En ligne de commande
La commande gamemanager download d'Asterobot télécharge une version sans passer par Asteroboard. Ligne de commande liste ses options.