Un bot seul se connecte à Dofus, et rien de plus. Ce qu'il fait une fois en jeu vient d'un paquet : vous installez des paquets dans votre bibliothèque, puis vous en attribuez un à chaque bot.
Ce que contient un paquet
Un paquet est un petit ensemble de fichiers JavaScript, son script, qu'Asterobot exécute pour un bot. Vous n'avez pas besoin de lire ni d'écrire ce code pour utiliser un paquet.
En plus du script, un paquet peut déclarer des réglages du paquet, c'est-à-dire les options que vous remplissez dans l'onglet Réglages du bot (quelle ressource récolter, combien de temps attendre), et des actions, des boutons du même onglet qui lancent une partie du script quand vous cliquez dessus. Réglages et actions d'un paquet montre comment utiliser les deux.
Un paquet peut aussi dépendre d'autres paquets et utiliser leur code. Ces dépendances sont des paquets comme les autres : elles ont leur propre ligne dans votre bibliothèque et s'exécutent avec le paquet qui en a besoin.
Votre bibliothèque
La bibliothèque est l'ensemble des paquets installés dans votre Asterobot, sur l'ordinateur où tourne Asterobot. Le Gestionnaire de bibliothèque l'affiche, avec une ligne par version de paquet. Rien n'en est stocké dans votre navigateur : tous les Asteroboard connectés au même Asterobot voient la même bibliothèque.
Installer un paquet ne le met pas en marche. Il s'exécute quand un bot le lance, et chaque bot qui le lance en exécute sa propre copie. Faire confiance à un paquet explique ce que ce script a le droit de faire avec votre bot.
Plusieurs versions côte à côte
Chaque version d'un paquet s'installe séparément. my-harvester 1.0.0 et my-harvester 1.1.0 forment deux lignes dans le Gestionnaire de bibliothèque, et les deux restent jusqu'à ce que vous en supprimiez une.
C'est voulu. Un bot est réglé sur une version précise, donc l'arrivée d'une nouvelle version dans votre bibliothèque ne change jamais ce que lancent vos bots. Quand vous mettez à jour un paquet depuis le marché, la nouvelle version s'installe à côté de l'ancienne, et vous passez chaque bot dessus quand vous êtes prêt. Mettre à jour les paquets détaille la marche à suivre.
D'où viennent les paquets
| Source | Comment il arrive dans votre bibliothèque | Badge |
|---|---|---|
| Le marché, la catégorie Library d'asterobot.net | Télécharger un paquet dans le Gestionnaire de bibliothèque, ou En télécharger un partout où vous choisissez un paquet pour un bot. Voir Installer depuis le marché. | Communautaire ou Officiel |
| Un paquet que vous écrivez | Nouveau paquet dans le Gestionnaire de bibliothèque, puis l'éditeur. Voir Créer un paquet. | Local |
| Une copie de l'un de vos paquets locaux | Copier vers une nouvelle version dans le menu du paquet. Voir Gérer votre bibliothèque. | Local |
Un fichier .zip |
Importer un .zip dans le Gestionnaire de bibliothèque. Voir Gérer votre bibliothèque. | Dépend du nom que vous lui donnez |
| La ligne de commande | La commande library install. Voir Ligne de commande. |
Dépend du nom que vous lui donnez |
Local, Communautaire et Officiel
La colonne Provenance du Gestionnaire de bibliothèque affiche l'un de ces trois badges. Asterobot le choisit d'après le nom du paquet.
| Badge | Le nom ressemble à | Ce que cela signifie |
|---|---|---|
| Local | my-harvester |
Un paquet à vous, créé, copié ou importé sous un nom simple. Seuls les paquets locaux se modifient dans Asteroboard. |
| Communautaire | @some-author:auto-harvest |
Installé depuis un fichier du marché publié par un membre d'asterobot.net. Après le @ vient le nom de l'auteur, après le : le titre du fichier, tous deux en minuscules avec des tirets. |
| Officiel | @asterobot:auto-harvest |
Installé depuis un fichier du marché qu'asterobot.net marque comme officiel. |
Un paquet du marché garde le nom qu'il a reçu lors de votre première installation. Si son auteur renomme ensuite le fichier sur asterobot.net, votre paquet garde son nom, et les mises à jour le retrouvent quand même.
Note
Un paquet importé depuis un fichier .zip reçoit le nom que vous saisissez, qui peut commencer par @. Il affiche alors Communautaire ou Officiel sans venir du marché. Faire confiance à un paquet explique comment vérifier d'où vient réellement un paquet.
Les auteurs de scripts trouveront les règles de nommage dans Noms et versions et Comment votre paquet est nommé.
Compatible et Incompatible
Un paquet peut indiquer avec quelles versions d'Asterobot il fonctionne. Dans ce cas, la colonne Compatibilité affiche Compatible ou Incompatible, selon l'Asterobot que vous utilisez. S'il n'indique rien, la colonne reste vide et aucune version n'est vérifiée.
Un paquet incompatible reste dans votre bibliothèque, et les sélecteurs de paquet le proposent toujours, avec (incompatible) après son nom. Il ne démarre pas pour autant : Lancer échoue avec Impossible de démarrer le comportement, sans dire pourquoi. Sur un bot réglé sur ce paquet, l'onglet Réglages, sous Réglages du paquet, donne la raison, qui se termine par package "<name>" requires asterobot <versions>, running <your version>. Mettez à jour le paquet, ou Asterobot, jusqu'à ce que les deux correspondent. Les auteurs peuvent lire Compatibilité.
Dépendances
La colonne Dépendances indique de combien de paquets un paquet dépend. Survolez le nombre pour voir leurs noms.
Quand vous installez un paquet depuis le marché, Asterobot télécharge aussi les paquets dont il dépend. Quand une dépendance déclare ses propres réglages, ils ont leur propre section dans l'onglet Réglages du bot.
Vous pouvez supprimer un paquet dont un autre dépend. Asteroboard vous prévient d'abord, et le paquet qui en avait besoin ne démarre plus ensuite.