Export your work

There are three ways to get work out of the editor: quick PNGs from the file browser, the Export As dialog for one texture or map, and Export Project for your game. None of them changes the project.

Quick PNGs from the file browser

Select one or more items in the file browser, right-click and choose Export as PNG. Name the folder to save into: you get one PNG per item, named after it.

A map becomes a folder of its own, with _composite.png holding everything, plus one PNG per layer, numbered in draw order. All of them are the same size, so they line up when you stack them.

Export a texture

Open the texture and choose File ▸ Export ▸ Export As, or right-click it in the file browser and choose Export As. Pick a Format, then click Export and choose where to save.

Image: the first frame as a PNG.
Sprite sheet: the frames of the animations you tick, in one PNG.
- Layout: One row per animation, or Grid with a number of Columns.
- Scale: 1x, 2x, 4x or 8x, with sharp pixels.
- Spacing: 0 to 8 px between frames.
- Background: Transparent or Solid colour.
It saves only the picture. If your game needs to know where each frame is, use Export Project instead.
GIF: one Animation as an animated GIF, with Scale, Background and Loop.
Aseprite: an .aseprite file with your layers, groups, palette and frame timings, and each animation as a tag. Event and tween tracks and reference images are left out, and the editor tells you what it dropped.

Export a map

Open the map and choose File ▸ Export ▸ Export As.

Output: Composite and layers saves a folder with _composite.png and one PNG per layer. Composite saves one PNG.
Layers: untick any layer to leave it out. Only tile and entity layers with something on them are listed. Collision layers, points and colliders are never drawn.
Scale: 1x, 2x, 4x or 8x.

On a tileset or an entity, Export As saves one PNG straight away: the tileset’s whole image, or the entity’s sprites.

Export the project for your game

File ▸ Export ▸ Export Project saves every map, tileset, entity, texture and animation as one ZIP archive, named after the first map. Your game loads the files inside it; Project export format describes each one.

While you work on a game, you don’t have to export after every change: Live Sync serves the same files to the running game and tells it when they change.

Project Settings ▸ Export ▸ Pack sprite sheets is on by default. It trims animation frames to their pixels and packs them tightly. Turn it off if your game expects one grid cell per frame.