The backpack is a feature of the Scratch 3.0 project editor that allows users to move scripts, costumes, and sounds between different projects. One can drag and drop costumes, sprites, sounds, and scripts from other projects into it and then drag and drop them easily into their project. This can be used to create multiple copies of a script or add a script to a different project.
For example, one can drag their platformer engine into their backpack to use in another platformer game they make, without the need to recreate the whole script. The backpack is collapsible, so, if the user is not using it, it does not waste space.
The backpack is only available for the online editor. If one is programming in the Offline Editor, they must first export the material in the project to use in another project or online.
One can only access their own backpack, and therefore one must be logged in to access a user's backpack. If a user attempts to access somebody else's backpack, they will see a 403 Error.
When Scratch 3.0 was released, the Scratch backpack server changed to https://backpack.scratch.mit.edu.[1] Users are able to request information from this like the Scratch API. For example, when the Scratch backpack is down, this is visible through the server.
Adding Media
To add media to the backpack, open the backpack by clicking on the "Backpack" tag at the bottom of the screen. Then drag a sprite, sound, costume, or script fragment into it. There is seemingly no limit as to how much media the backpack can contain,[citation needed] however too much data can cause the backpack to display "Error loading backpack", and the media won't be added to the backpack. Media can also be clicked and dragged around throughout the backpack for organization. To remove media from the backpack, right-click on or tap and hold the desired item and select "delete".
One can also set the contents of a user's backpack through a POST
request to
https://scratch.mit.edu/internalapi/backpack/USERNAME-HERE/set
The X-CSRFToken
must be passed with the CSRF token (which can be found in the scratchcsrftoken
cookie); and should pass a JSON payload as the body of the request, containing the desired backpack. The user must be authenticated (i.e. logged in).
Adding Scripts Through the Forums
This article or section documents something not included in the current version of Scratch (3.0). It is only useful from a historical perspective. |
Note: | This feature only worked if all the blocks are valid. It would not work if there are any undefined blocks. |
To add scripts to the backpack from the Scratch Discussion Forums, one could[when?] click the "Add to Backpack" button next to a script.[2] It asked what the script should be named, and once the user clicked "Okay", it was be added to the backpack. This feature was later removed because it allowed invalid blocks to be added to the backpack.[3]
Using Media
To remove media from the backpack, in the same or another project, one can open the backpack by clicking on the tab, the same way as before. Then, one can click and drag the media out of the backpack and into the project editor. Specific types of media must be dragged into specific areas of the project editor. For example, one cannot drag an image into the sound editor, as it will simply disappear and cause no function. When dragging media from the backpack, the object is not removed from the backpack but duplicated.
If an item icon has a question mark on it, it means that the item has failed to be fully put in the backpack. It does nothing when dragged to the project.
One can also receive the contents of a user's backpack by sending a GET
request to
https://scratch.mit.edu/internalapi/backpack/USERNAME-HERE/get
Exporting
Some media can be exported from the backpack. One can export a costume or backdrop by right-clicking on its icon and selecting "Save to Local File".
Information
- The backpack shows an icon or image of the media in it, along with some information about it.
- For a sprite, it has the thumbnail of the sprite as it was dragged into the backpack, along with the name of the sprite.
- For a costume, it has a thumbnail of the costume, along with the name.
- For a sound, it has a sound icon, along with the sound's name.
- For a script, it has a thumbnail of the script, and the text "Script".
Glitches
There has been a glitch which the Scratch Editor ignores some sounds when dragged out of the backpack.[4] The only workarounds are exporting sounds and then importing the sound in or making a random sprite with the sound, dropping it into the backpack, and duplicating it into a new project.