Une version de jeu téléchargée est un dossier de fichiers du jeu que les bots, les scripts et la page du jeu ne savent pas lire tels quels. L'extraction les transforme en données de jeu : les tables et les textes du jeu sous une forme qu'Asterobot peut rechercher et interroger, plus les images qu'affiche la page du jeu. Une version doit être extraite avant que vous puissiez ajouter un bot qui l'utilise.
Si Extraire les données après le téléchargement était coché quand vous avez téléchargé la version, l'extraction a déjà commencé ou est terminée. Sinon, lancez-la vous-même, comme le montre Extraire une version.
Ce que construit l'extraction
L'extraction ne lit que des fichiers déjà téléchargés : elle ne télécharge rien. Elle enchaîne ces étapes dans l'ordre, et le compteur de progression repart de zéro à chaque étape, plusieurs fois pendant les données de jeu :
- Les images : les illustrations des serveurs affichées quand vous choisissez un serveur, les icônes des objets et les icônes dessinées sur la carte du monde.
- Les visuels de la carte du monde : 1 216 images qui couvrent les 40 cartes du monde à chaque niveau de zoom.
- Les données de jeu : les tables propres au jeu (objets, monstres, sorts, cartes, quêtes et le reste), les tables qu'Asterobot en dérive, comme l'index de chaque nom dans chaque langue, le graphe de déplacement du monde, et les textes de chaque langue dont le fichier de textes a été téléchargé.
- La musique, uniquement quand les banques audio de la version ont été téléchargées depuis l'onglet Musique. Si la musique ne peut pas être extraite, l'extraction réussit quand même.
Le résultat est stocké à part des fichiers du jeu, dans le dossier de cache d'Asterobot (Fichiers et dossiers). Données de jeu montre comment le parcourir, et les scripts le lisent avec asterobot:gamedata.
Extraire une version
- Ouvrez le Gestionnaire de jeux.
- Ouvrez le menu au bout de la ligne de la version, ou faites un clic droit sur la ligne.
- Cliquez sur Extraire les données.
La colonne Extraction passe à Extraction en cours, avec une barre de progression et un compteur. L'extraction s'exécute dans Asterobot : vous pouvez fermer Asteroboard pendant ce temps.
Extraire les données n'est disponible qu'une fois le Statut de la version à Installé, et pas pendant que cette version est déjà en cours d'extraction. Vous trouverez le même bouton sur la page du jeu de la version, dans la carte Données extraites de l'onglet Informations. Dans la fenêtre Ajouter un bot, vous pouvez aussi cliquer sur le badge Non extrait ou Échec de l'extraction de la version choisie.
Chaque version s'extrait indépendamment des autres. L'extraction n'attend pas dans la file des téléchargements : elle tourne pendant qu'une autre version se télécharge, et deux versions peuvent s'extraire en même temps.
La colonne Extraction
| Statut | Signification |
|---|---|
| Non extrait | Aucune extraction complète de cette version n'est sur le disque. |
| Extraction en cours | Une extraction tourne. Le compteur suit l'étape actuelle. |
| Extrait | Chaque étape a laissé son résultat sur le disque : les images, les visuels de la carte du monde et les données de jeu. |
| Échec de l'extraction | La dernière extraction s'est arrêtée sur une erreur. |
Asteroboard n'affiche pas pourquoi une extraction a échoué. La raison se trouve dans le journal d'Asterobot, sur une ligne qui commence par Failed to extract game data, que vous pouvez lire dans le terminal d'Asterobot ou dans Serveur > Console (État et console). Échec de l'extraction reste affiché jusqu'à ce que vous relanciez l'extraction ou redémarriez Asterobot. Après un redémarrage, Asterobot regarde ce qui se trouve sur le disque et affiche Extrait ou Non extrait.
La cause habituelle est un fichier manquant. Une version téléchargée avec un Filtre de fichiers (regex) plus restrictif que celui par défaut n'a pas tout ce que lit l'extraction. Ouvrez la page du jeu de la version : si sa carte Fichiers requis indique Manquants, cliquez sur Télécharger les fichiers requis, attendez la fin du téléchargement, puis relancez l'extraction.
Prêt pour un bot
La colonne Prêt indique Prêt pour un bot quand une version réunit les deux moitiés dont un bot a besoin, et Pas prêt sinon :
- les fichiers dont un bot a besoin sont téléchargés : les textes du jeu, les tables de données, les données des cartes et le graphe de déplacement du monde ;
- les données de jeu sont extraites, ainsi que les illustrations des serveurs.
Aucune des deux moitiés n'implique l'autre. Une version fraîchement téléchargée affiche Pas prêt tant qu'elle n'est pas extraite, et une version dont vous avez désinstallé les fichiers garde ses données de jeu extraites mais affiche Pas prêt elle aussi. Les visuels de la carte du monde et les icônes des objets ne font pas partie de la vérification : seule la page du jeu s'en sert.
Ajouter un bot n'accepte qu'une version marquée Prêt pour un bot. Un bot qui se connecte tout seul refuse aussi de le faire tant que sa version n'est pas prête : Asteroboard affiche alors La version du jeu du bot n'est pas encore prête, avec « Ses fichiers de jeu ou ses données extraites ne sont pas complètement prêts ».
Le badge se met à jour quand un téléchargement ou une extraction de la version se termine. Pour vérifier tout de suite, cliquez sur Vérifier si prêt pour un bot dans le menu de la version ou sur sa page du jeu. Asterobot examine le disque et Asteroboard répond Prêt pour un bot, Pas prêt pour un bot, ou Impossible de vérifier l'état quand Asterobot n'a pas pu être interrogé.
Extraire à nouveau
Une fois qu'une version affiche Extrait, l'entrée du menu devient Réextraire les données. Elle relance toute l'extraction depuis le début et écrase ce qui existait. Utilisez-la quand les données de jeu semblent incomplètes, ou après avoir téléchargé des fichiers supplémentaires pour la version.
Les scripts qui tournent déjà sur cette version prennent en compte les nouvelles données de jeu à leur prochaine recherche, comme l'explique Vue d'ensemble des données de jeu.
Supprimer les données extraites
Supprimer les données extraites, dans le menu de la version ou dans la carte Données extraites de sa page du jeu, efface les données de jeu de la version, ses images extraites et sa musique extraite. Les fichiers du jeu téléchargés restent. La version passe à Non extrait et Pas prêt : un bot qui se connecte tout seul ne peut donc plus s'en servir pour se connecter tant que vous ne l'avez pas extraite à nouveau.
L'action n'est pas disponible pendant l'extraction de la version, ni quand rien n'est extrait. Si une extraction démarre avant que votre clic n'atteigne Asterobot, Asteroboard affiche Impossible de supprimer les données extraites.
Supprimer efface aussi les données de jeu extraites, en même temps que les fichiers et la ligne de la version : voir Gérer les versions de jeu.
Si l'extraction ne démarre pas
Impossible de démarrer l'extraction signifie que la demande n'a pas atteint Asterobot. Vérifiez qu'Asteroboard est connecté : l'entrée Préférences de la barre latérale n'a pas de point rouge. Puis réessayez.