Share your package

Your package only exists in your own library until you share it. You can send someone a .zip file, or publish the package on the marketplace so anyone with Asterobot can install it.

Export a .zip

1. Open Library Manager.
2. Open the menu at the end of your package's row, or right-click the row.
3. Choose Export.

Your browser downloads a file named after the package and its version, such as my-first-script-1.0.0.zip. The same menu is also on the package's own page.

The archive holds the package's files as they are in your library: index.js, your other modules, and asterobot.json if the package has one. The settings people chose for your package on their bots aren't part of it.

Import it on another Asterobot

Whoever receives the file installs it from their own Library Manager:

1. Click Import a .zip.
2. Drop the file on Drop a .zip here, or click to choose one, or click that area to pick the file.
3. Type a Name. Version fills in by itself when the file name ends with a version, as in -1.0.0.zip.
4. Click Import.

A Package imported toast confirms it. The name and version come from the dialog, not from the archive. If a package with the same name and version is already installed, the dialog warns This replaces the installed my-first-script 1.0.0. and Import replaces it. Archives can't be bigger than 32 MiB.

Manage your library covers importing from the player's side, and Zip files and the command line describes the archive in detail.

Give each change a new version

A package is identified by its name and its version together. Your library can hold my-first-script 1.0.0 and 1.0.1 side by side, and each bot plays one exact version.

So when you change a package you've already shared, give the change a new version instead of reusing the old number. Two different packages under the same name and version can't be told apart, and importing one replaces the other.

To start a new version from the current one:

1. In Library Manager, open your package's menu and choose Copy to a new version.
2. The Copy this package dialog suggests the same name, with the last number of the version raised by one: 1.0.0 becomes 1.0.1. Change it if you want another number.
3. Click Copy.

The editor opens on the new version. Dependencies, permissions and the compatible version are copied along with the code. Your bots keep playing the version they were on until you Run the new one on them. Names and versions explains how to number versions.

Publish on asterobot.net

The marketplace is the Library category of asterobot.net, and any asterobot.net member can publish a package there by uploading the .zip you exported. Before you publish has a checklist, and Publish on asterobot.net walks you through it. When you publish a new version later, follow Publish an update.