L'onglet Données de jeu d'une page du jeu permet de parcourir tout ce qu'Asterobot a extrait d'une version de jeu : objets, monstres, sorts, cartes, quêtes, textes et bien plus. Vous n'avez pas besoin de SQL pour cela, et c'est l'endroit le plus simple pour trouver un nom de table ou de colonne avant de l'utiliser dans un script ou dans l'onglet SQL.
L'ouvrir
Ouvrez la page du jeu de la version depuis Gestionnaire de jeux, puis son onglet Données de jeu. Il comporte lui-même trois onglets : Recherche, Tables et SQL.
Au-dessus, des badges résument les données de jeu : le nombre de tables qui reflètent les fichiers du jeu (table(s)), le nombre de tables qu'Asterobot en a dérivées (dérivée(s)), le nombre total de lignes, et les codes des langues pour lesquelles elles contiennent des textes, par exemple de · en · es · fr · pt.
Quand la version n'a pas de données de jeu extraites, l'onglet affiche Aucune donnée extraite pour cette version et « Extrayez les données de cette version du jeu pour les parcourir ici. » Voir Extraire les données de jeu.
L'onglet ouvert, la table et l'enregistrement que vous ouvrez figurent tous dans l'adresse de la page : vous pouvez les mettre en favori ou les rouvrir depuis l'historique de votre navigateur.
Tables brutes et tables dérivées
La plupart des tables reflètent les données du jeu lui-même, une table par type d'enregistrement. D'autres sont dérivées par Asterobot pour répondre à des questions auxquelles les fichiers du jeu ne répondent pas directement, comme tous les noms dans toutes les langues, ou quelles cartes contiennent quels éléments interactifs. Le nom d'une table dérivée contient deux tirets bas, comme maps__interactive_elements, et chacune de ses lignes pointe vers sa ligne parente avec _parent_id. La table _names relie chaque nom à son enregistrement, dans chaque langue extraite.
Recherche
La recherche trouve des enregistrements d'après leur nom, ce que les fichiers du jeu ne savent pas faire : ils associent un nombre à un texte, et rien ne permet d'aller dans l'autre sens.
- Dans l'onglet Recherche, tapez dans Requête, par exemple
Bouftou Royal. - Choisissez le Mode de recherche : Par nom, par défaut, ou Dans les textes du jeu.
- Avec Par nom, vous pouvez restreindre la recherche avec Table, ou la laisser sur Toutes les tables.
Les résultats apparaissent pendant la saisie, jusqu'à 100.
| Mode | Ce qu'il cherche | Résultats |
|---|---|---|
| Par nom | Les noms des enregistrements, dans les tables qui ont des noms. Chaque mot correspond au début d'un mot, et les meilleurs résultats viennent en premier. | La table, le nom et le numéro de l'enregistrement après #. Cliquez sur un résultat pour ouvrir l'enregistrement. |
| Dans les textes du jeu | Tous les textes que le jeu peut afficher, pas seulement les noms. | Le numéro du texte après #, et le texte. Ces résultats n'ouvrent rien. |
La liste Table ne propose que les tables dont les enregistrements ont des noms.
Les noms et les textes sont cherchés dans la Langue choisie dans l'en-tête de la page du jeu. Quand les données de jeu n'ont aucun texte dans cette langue, un avertissement sous le champ indique la langue utilisée à la place. Aucun résultat signifie qu'il n'y a eu aucune correspondance, et La recherche a échoué qu'Asterobot n'a pas pu lancer la recherche.
Tables
L'onglet Tables liste toutes les tables à gauche, avec leur nombre de lignes. Les tables dérivées sont grisées.
- Filtrer les tables... garde les tables dont le nom contient ce que vous tapez.
- Afficher les dérivées, activé par défaut, masque les tables dérivées quand vous le désactivez.
Cliquez sur une table pour la parcourir. Tant que vous ne l'avez pas fait, la partie droite indique « Choisissez une table pour la parcourir. »
Parcourir une table
Au-dessus des lignes, vous voyez le nom de la table, un badge Dérivée sur les tables dérivées, et une ligne commençant par « Dérivée de » qui nomme la partie des données de jeu d'où vient la table, suivie du type d'enregistrement quand la table en a un. Le nombre de lignes est à droite.
Les lignes s'affichent par 25 par page, avec des boutons de page sous la table quand il y en a plus. Chaque colonne affiche son nom et son type, par exemple INTEGER pour les nombres entiers. Quand les enregistrements de la table ont des noms, une première colonne Nom affiche le nom de chaque ligne dans la langue de la page. Les valeurs longues sont coupées : pointez une cellule pour la lire en entier.
Filtrer les lignes
Sous le nom de chaque colonne, un champ colonne = valeur ne garde que les lignes où cette colonne contient exactement la valeur saisie. Les filtres sur plusieurs colonnes se cumulent, et la table revient à sa première page. La valeur est lue selon la façon dont la colonne la stocke : des lettres dans une colonne de nombres entiers donnent une erreur telle que column "level" is an integer, but "abc" is not.
Sur les tables dont les enregistrements ont des noms, Rechercher par nom... liste les lignes dont le nom correspond à ce que vous tapez, jusqu'à 25, les meilleures en premier. Le compteur indique alors « lignes correspondantes » et les boutons de page disparaissent. Videz le champ pour revoir toute la table.
Quand aucune ligne ne correspond, la table indique « Cette table est vide. » Quand les lignes ne peuvent pas être chargées, une alerte rouge affiche la raison, ou Impossible de charger les lignes.
Ouvrir un enregistrement
Cliquez sur une ligne pour ouvrir son enregistrement. Les lignes de certaines tables dérivées ne peuvent pas être ouvertes, car elles n'ont pas d'_id propre.
La vue d'un enregistrement
Un enregistrement affiche chaque colonne qui contient une valeur, une par ligne, avec le type de la colonne. Les colonnes sans valeur sont omises. La ligne du haut contient un bouton au nom de la table, qui vous ramène aux lignes, le numéro de l'enregistrement après #, et son nom quand il en a un.
- Liens. Quand une colonne pointe vers des enregistrements d'une autre table, et qu'Asterobot a vérifié lors de l'extraction que c'est bien le cas, ses valeurs sont des boutons qui affichent le nom de l'enregistrement visé. Pointer l'un d'eux affiche « Ouvrir » suivi de la table et du numéro de l'enregistrement, et un clic ouvre cet enregistrement. Une valeur qui ne mène à aucun enregistrement existant reste un simple nombre, tout comme les valeurs d'une très longue liste au-delà des 500 premières.
- Les valeurs imbriquées, comme une liste d'effets ou les cellules d'une carte, se déplient un niveau à la fois.
- absent du catalogue signale un champ que la description de la table ne liste pas. Cela ne devrait pas arriver, et c'est affiché plutôt que masqué.
Quand un enregistrement ne peut pas être affiché, la vue indique « n'est pas un identifiant d'enregistrement valide. » après une adresse qui n'est pas un nombre, la raison donnée par Asterobot, par exemple datacenter: no such record, ou Impossible de charger l'enregistrement.
Autres points d'entrée
- Dans l'onglet Cartes, chaque résultat de recherche de la carte du monde et chaque monstre ou objet du panneau de la région renvoie vers son enregistrement. Voir Carte du monde.
- Dans l'onglet Textes, Trouver ce qui l'utilise ouvre cet onglet. Voir Textes du jeu.
Pour les auteurs de scripts
Les noms de tables et de colonnes affichés ici sont ceux qu'utilisent les scripts avec record(), table(), find() et query(). Recherches et Requêtes SQL expliquent comment faire. L'éditeur de paquet propose aussi ce navigateur à côté de votre code, sous Données dans son panneau Jeu (L'éditeur).