Le marché est la catégorie Library d'asterobot.net, où les joueurs partagent des paquets. Vous le parcourez sur le site, puis vous collez le lien ou l'ID d'un fichier dans Asteroboard, et Asterobot télécharge le paquet dans votre bibliothèque, avec les paquets dont il dépend.
Asterobot télécharge les fichiers avec votre compte asterobot.net : il doit donc d'abord être connecté. Voir Se connecter avec asterobot.net.
1. Trouver un paquet sur asterobot.net
- Ouvrez https://asterobot.net/files/category/10-library/. Les formulaires de téléchargement d'Asteroboard ont aussi un lien Parcourir les paquets sur asterobot.net qui l'ouvre.
- Ouvrez la page du fichier qui vous intéresse. Lisez ce qu'il fait et qui l'a publié avant d'aller plus loin : Faire confiance à un paquet explique ce qu'un paquet peut faire avec votre bot.
- Copiez l'adresse de la page depuis votre navigateur, par exemple
https://asterobot.net/files/file/6-testscript5/. Le nombre au début de la dernière partie, ici6, est l'ID du fichier. L'adresse comme l'ID font l'affaire.
Le marché décrit le côté site web.
2. Le prévisualiser
- Dans la barre latérale, ouvrez le Gestionnaire de bibliothèque et cliquez sur Télécharger un paquet. La boîte de dialogue Télécharger un paquet depuis asterobot.net s'ouvre.
- Collez l'adresse ou l'ID dans ID ou URL du fichier. Asteroboard accepte un nombre seul, ou une adresse qui contient
/file/suivi du nombre et d'un tiret, comme celle ci-dessus. - Cliquez sur Prévisualiser.
Asteroboard demande à asterobot.net ce qu'est le fichier et l'affiche sur une fiche. Rien n'est encore téléchargé, et une prévisualisation ne compte pas comme un téléchargement pour l'auteur.
| Sur la fiche | Ce qu'elle vous apprend |
|---|---|
| Le titre | Le titre du fichier sur asterobot.net. |
| Officiel ou Communautaire | Si asterobot.net marque le fichier comme officiel. Voir Qu'est-ce qu'un paquet. |
| Auteur | La partie éditeur du nom du paquet : le nom de l'auteur en minuscules avec des tirets, ou asterobot pour un fichier officiel. |
| S'installera sous | Le nom et la version exacts qu'aura le paquet dans votre bibliothèque, par exemple @some-author:auto-harvest@1.2.0. |
Une ligne peut apparaître sous la fiche :
- « Cette version est déjà dans votre bibliothèque » : ce nom et cette version exacts sont déjà installés. Il n'y a rien à télécharger, vous pouvez fermer la boîte de dialogue.
Vous n'avez pas la permission de télécharger ce fichier.en rouge : Installer reste grisé. Les personnes autorisées à télécharger un fichier sont définies sur sa page d'asterobot.net, et votre compte n'a pas le droit de télécharger celui-ci.
Pour essayer un autre lien, cliquez sur Modifier, puis collez le nouveau.
3. Installer
Cliquez sur Installer.
Asterobot télécharge le fichier et l'installe, puis télécharge chaque paquet dont il dépend qui n'est pas encore dans votre bibliothèque. Une fois tout en place, la boîte de dialogue se ferme et Paquet installé s'affiche. Le paquet a sa propre ligne dans le Gestionnaire de bibliothèque, tout comme chaque dépendance téléchargée avec lui.
L'installation se déroule dans Asterobot. Fermer la boîte de dialogue ou Asteroboard pendant qu'elle tourne ne l'arrête pas.
Ensuite, attribuez le paquet à un bot : Lancer un paquet.
Installer depuis un sélecteur de paquet
Quand vous choisissez un paquet pour un bot, inutile de passer par le Gestionnaire de bibliothèque. Le sélecteur de paquet a un bouton En télécharger un à côté de sa liste, à trois endroits : l'onglet Comportement / Script de la boîte de dialogue Ajouter un bot, la boîte de dialogue Charger une sélection de comportement, et Configuration du bot dans l'onglet Réglages d'un bot.
- Cliquez sur En télécharger un. Un petit formulaire s'ouvre sous la liste, avec le texte « Le télécharge dans votre bibliothèque, puis le sélectionne ici. »
- Collez l'adresse ou l'ID dans ID ou URL du fichier et cliquez sur Prévisualiser. La même fiche apparaît.
- Cliquez sur Installer. Quand le paquet est déjà dans votre bibliothèque, le bouton affiche L'utiliser à la place, et sélectionne la copie installée sans rien télécharger.
Le formulaire se ferme et le paquet est sélectionné dans le sélecteur. Annuler ferme le formulaire et laisse la sélection telle qu'elle était.
Problèmes possibles
| Message | Où | Que faire |
|---|---|---|
Ce n'est pas un ID de fichier ou une URL asterobot.net valide. |
Sous le champ | Le texte n'est ni un nombre ni l'adresse d'une page de fichier. Copiez l'adresse de la page du fichier lui-même, pas celle de la catégorie. Prévisualiser reste grisé tant que ce n'est pas corrigé. |
Fichier introuvable, ou vous n'avez pas la permission de le voir. |
Sous le champ, après Prévisualiser | Le fichier n'existe pas, votre compte ne peut pas le voir, ou Asterobot n'a pas pu interroger asterobot.net, par exemple parce qu'il n'est pas connecté. Vérifiez l'adresse, puis le bouton de compte en bas de la barre latérale. |
Vous n'avez pas la permission de télécharger ce fichier. |
Sous la fiche | Votre compte n'a pas le droit de télécharger ce fichier. C'est la page du fichier sur asterobot.net qui décide qui le peut. |
| Impossible d'installer le paquet | Notification | Le téléchargement ou l'installation a échoué. La notification ne donne pas de raison. Cela arrive quand Asterobot ne trouve pas le index.js du paquet dans le fichier, quand le fichier a plus d'une pièce jointe, quand il dépasse 32 Mio, quand asterobot.net refuse le téléchargement, ou quand l'une de ses dépendances ne peut pas être installée. |
Quand c'est une dépendance qui a échoué, le paquet lui-même est peut-être déjà dans votre bibliothèque sans elle, et il ne démarrera pas. Réessayez l'installation plus tard, ou supprimez le paquet.
Erreurs de paquet traite des problèmes avec les paquets déjà installés.
Pour aller plus loin
- Lancer un paquet
- Le tutoriel Lancer un paquet du marché va du site web jusqu'à un bot en marche.