The marketplace is the Library category of asterobot.net, and any asterobot.net member can publish a package there. Publishing means submitting a file on the website with your exported .zip attached.
You need an asterobot.net account, as Create an asterobot.net account explains, and the .zip of your package, exported once you've gone through Before you publish.
What Asterobot reads from your file
When someone pastes the link of your file in Asteroboard, Asterobot reads a few things from the file on asterobot.net:
| On asterobot.net | What Asterobot does with it |
|---|---|
| The file's title | Turns it into the second part of the package's name, in lowercase with hyphens: Chat Tools gives chat-tools. |
| Your asterobot.net name, as the file's author | Turns it into the first part of the name, the publisher: @alice:chat-tools. |
| The official mark, set by the Asterobot team | Replaces the publisher with asterobot, and shows Official instead of Community. |
| The file's version | Uses it as the package's version. |
| The file's attachment | Installs it as the package. The file must have exactly one attachment: your .zip. |
| Who can download the file | Decides who can install the package. |
Asterobot doesn't read the description, the screenshots or anything else on the file's page, and doesn't check which category the file is in. Those are for the people who look for packages, and they look in the Library category. How your package is named goes into the naming rules.
Submit the file
- Sign in on asterobot.net and open the Library category: https://asterobot.net/files/category/10-library/.
- Start submitting a new file in that category.
- Attach your exported
.zip, and nothing else. - Give the file its title. Choose it with care: it becomes part of the package's name, and a title changed later gives new users a different name.
- Set the file's version to your package's version, written the same way, such as
1.0.0. A file without a version can't be installed. - Write the description: what the package does, whether it works on Full socket bots, MITM bots or both, its settings and actions, the packages it depends on and the permissions it declares.
- Submit the file.
Anything else you fill in on the website is for the people reading your file's page: it doesn't change how Asterobot installs the package.
Check that it installs
Install your package on your own Asterobot, the way anyone would:
- Copy the address of your file's page.
- In Library Manager, click Download package, paste the address in File ID or URL, then click Preview.
- Check the card: your title, the Community badge, your name after Author, and after Will install as, the name and version you expect, such as
@alice:chat-tools@1.0.0. - Click Install. Package installed appears, and the package has its own row in Library Manager.
- Start it on a bot. Remove it from your library afterwards if you don't need it.
If Preview says File not found, or you don't have permission to view it., check that your file is visible on asterobot.net, that your Asterobot is signed in, and that the title and your asterobot.net name each contain at least one letter from a to z or a digit.
When the installation itself fails, Asteroboard only says Couldn't install the package. The causes on your side:
| Cause | Fix |
|---|---|
| The file has more than one attachment, or none | Keep your .zip as the file's only attachment |
Asterobot doesn't find index.js in the archive |
Export the package again from Library Manager and attach that archive. See Zip files and the command line. |
| The archive is larger than 32 MiB | Leave out what the package doesn't need |
The file has no version, or its version contains / or \ |
Set a version such as 1.0.0 |
The archive's asterobot.json isn't valid JSON, or a dependency's version isn't valid |
Fix the manifest, export again and upload the new archive as a new version |
| A dependency has no URL, its URL points to a file whose author doesn't match the dependency's name, or the version it locks isn't available | See Dependencies |
When a dependency is what failed, your package itself may already be installed, without that dependency. Remove it before trying again.
Share the link
The address of your file's page, such as https://asterobot.net/files/file/12-chat-tools/, is all people need. They paste it in Download package, or in Download one wherever they choose a package for a bot, as Install from the marketplace shows. The number at the start of the last part of the address, 12 here, is the file's ID, which works on its own too. Asterobot only reads that number, so an address that still has an old title in it keeps working after you rename the file.
Other authors use the same address as the URL of a dependency on your package.
Who can install it
Asterobot downloads the file with the asterobot.net account it's signed in with. When that account isn't allowed to download your file, the preview says You don't have permission to download this file. and Install stays disabled. Who can download a file is decided on asterobot.net, not in Asterobot. The marketplace describes the website's side.
Next, when you change your package, Publish an update.
Aucun avis à afficher.