Le marché est la catégorie Library d'asterobot.net, à l'adresse https://asterobot.net/files/category/10-library/, où les membres d'asterobot.net partagent des paquets. Vous le parcourez sur le site, et Asterobot ne le parcourt jamais à votre place : une fois un paquet trouvé, vous donnez son lien à Asteroboard et Asterobot le télécharge.
Parcourir la catégorie Library
Ouvrez https://asterobot.net/files/category/10-library/ dans votre navigateur. Les formulaires de téléchargement d'Asteroboard ont aussi un lien Parcourir les paquets sur asterobot.net qui l'ouvre.
Chaque paquet est un fichier avec sa propre page, où son auteur le présente et publie ses versions. L'adresse de la page suit ce modèle :
https://asterobot.net/files/file/6-testscript5/Le nombre au début de la dernière partie, ici 6, est l'ID du fichier. Asteroboard accepte l'adresse complète ou l'ID seul.
Lisez la page d'un fichier avant de l'installer : qui l'a publié et ce que le paquet est censé faire. Un paquet s'exécute avec la session de jeu de votre bot, et Faire confiance à un paquet explique ce que cela permet.
Officiel et Communautaire
Asterobot classe les fichiers du marché en deux catégories, et montre la différence par un badge dans le Gestionnaire de bibliothèque :
| Officiel | Communautaire | |
|---|---|---|
| Quels fichiers | Les fichiers que l'équipe Asterobot marque comme officiels sur asterobot.net | Tous les autres fichiers, publiés par un membre d'asterobot.net |
| Nom dans votre bibliothèque | @asterobot: suivi du titre du fichier, par exemple @asterobot:auto-harvest |
@, le nom de l'auteur, : et le titre du fichier, par exemple @some-author:auto-harvest |
Asterobot lit la marque officielle sur le fichier lui-même, quelle que soit la catégorie où se trouve le fichier. Le nom de l'auteur et le titre s'écrivent tous deux en minuscules, avec des tirets.
Un paquet garde le nom qu'il a reçu lors de votre première installation, même si l'auteur renomme le fichier ensuite. Qu'est-ce qu'un paquet explique les badges de votre bibliothèque, et les auteurs trouveront les règles de nommage dans Comment votre paquet est nommé.
Le badge Officiel vous dit qui a publié un paquet. Ce n'est pas une garantie sur ce que fait le code, et aucun des deux badges ne dispense de lire la page du fichier.
Du site à votre bibliothèque
Asterobot doit être connecté à asterobot.net, puisqu'il télécharge les fichiers avec ce compte. Ensuite :
- Copiez l'adresse de la page du fichier, ou notez son ID.
- Dans Asteroboard, ouvrez le Gestionnaire de bibliothèque et cliquez sur Télécharger un paquet, ou cliquez sur En télécharger un partout où vous choisissez un paquet pour un bot.
- Collez l'adresse ou l'ID dans ID ou URL du fichier, puis cliquez sur Prévisualiser. Asteroboard affiche sous quel nom le fichier s'installera. Une prévisualisation ne compte pas comme un téléchargement sur asterobot.net.
- Cliquez sur Installer. Asterobot télécharge le paquet et chaque paquet dont il dépend qui n'est pas encore dans votre bibliothèque.
Installer depuis le marché détaille chaque étape, la fiche de prévisualisation et chaque erreur.
Vous pouvez aussi télécharger vous-même le fichier d'un paquet depuis sa page et l'ajouter avec Importer un .zip. Un paquet ajouté ainsi n'a aucun lien avec son fichier du marché : pas de mises à jour, pas de ligne Source, et aucune vérification que ses fichiers restent tels qu'ils ont été téléchargés. Installez via Télécharger un paquet chaque fois que c'est possible. Voir Gérer votre bibliothèque.
Qui peut voir et télécharger un fichier
asterobot.net décide qui peut voir un fichier et qui peut le télécharger. Asterobot fait la demande avec le compte avec lequel il est connecté, celui de sa page Compte, qui n'est pas forcément le compte que votre navigateur utilise sur le site. Deux messages découlent de ces règles :
| Message | Quand | Ce que cela signifie |
|---|---|---|
Fichier introuvable, ou vous n'avez pas la permission de le voir. |
Sous ID ou URL du fichier, après Prévisualiser | Le fichier n'existe pas, le compte utilisé par Asterobot ne peut pas le voir, ou Asterobot n'a pas pu interroger asterobot.net, par exemple parce qu'il n'est pas connecté. |
Vous n'avez pas la permission de télécharger ce fichier. |
Sous la fiche de prévisualisation | Le compte peut voir le fichier mais n'a pas le droit de le télécharger. Installer reste grisé. |
Pour le premier, vérifiez l'adresse, puis le bouton de compte en bas de la barre latérale d'Asteroboard : il doit afficher votre nom. Pour le second, il n'y a rien à corriger dans Asterobot : les règles du fichier sur asterobot.net ne permettent pas à votre compte de le télécharger.
Mises à jour
Un auteur publie les nouvelles versions d'un paquet sur la même page de fichier. Rien ne change dans votre bibliothèque quand cela se produit : Asterobot ne cherche pas de nouvelles versions de lui-même.
Pour les obtenir, cliquez sur Vérifier les mises à jour dans le Gestionnaire de bibliothèque. Asterobot compare chaque paquet installé depuis le marché à la version de sa page de fichier, et installe une nouvelle version à côté de celle que vous avez quand vous le demandez, pour que vos bots continuent de lancer l'ancienne jusqu'à ce que vous les passiez sur la nouvelle. Mettre à jour les paquets détaille la marche à suivre.
Publier votre propre paquet
Tout membre d'asterobot.net peut publier un paquet dans la catégorie Library. Le côté auteur, de la préparation du paquet à la publication de nouvelles versions, se trouve dans la documentation développeur : commencez par Avant de publier, puis Publier sur asterobot.net.