pkgaspi / asepritescripts

My collection of Aseprite Scripts. Useful to make repetitive export patterns quicker.

Gaspi's Aseprite Scripts

Welcome to my collection of Aseprite Scripts. They all aim to save you time doing specific and repetitive tasks. If you find yourself in this situation, you can ask me for a commission! Contact below.

Please, take a look at the repo wiki to learn more about the scripts.

Disclaimer

These scripts were last tested on Aseprite version v1.2.14. It happened before that an Aseprite update broke the functionality of these scripts. Please, backup your work before use. If a script doesn't work, please open an issue.

Installation

1. Download or clone this repository.
2. In Aseprite, go to File -> Scripts -> Open Scripts Folder.
3. Copy the content of this repository's script folder into the opened script folder.
4. In Aseprite, go to File -> Scripts -> Re-scan Scripts Folder.

Scripts

Here is a list with all the current scripts and how to use them:

• Export Layers
• Export Slices
• Export Combinations

Even if some options may look complicated, they are all set in a default value so that they work straight away. If you're looking for more advanced and specific ways of export, take a look at them.

Note.- Some of the scripts may mark the sprite as unsaved after executing. NO changes are made to the sprite if it's not indicated by the script description. However, some of the trickery involved causes the sprite to appear as modified.

About me

Hey, I'm a Computer Science graduate fascinated by the videogame industry. Here are some of my links:

• Web: gaspi.games
• Twitter: @_Gaspi
• Aseprite Community: Gaspi

asepritescripts's Issues

When exporting slices, the background color changes

This is how I have the image, numbers separated by slices

After Exporting it looks like this:

First Slice worked fine, all the rest have the background color changed:

Add option to export as sprite sheet

When exporting as .png, it can be useful to export multiple frames as a sprite sheet instead of as many images.

Export Layers - Resize / Shrink Canvas to Best Fit Exported Layer Sprite

I'm looking to use the export layers script if I can resize / shrink the canvas around each exported layer sprite to "best fit" the resultant sprite. I've played around with the script and somehow was successful in one attempt to do this, but haven't been able to recreate this result again.

For a concrete example of what I'm looking for, currently exported layer sprites use the default canvas size of the Aseprite project you're exporting from, i.e. here I'm using the Export Layers script on a 128x128px canvas and get the following output:

What I'm looking for is something akin to the following:

Notice the sizes of these png's fit the resultant layer sprites.

I thought I was able to achieve this by manipulating the script using this additional line:

app.command.CanvasSize{ ui=false, bounds=app.activeSprite.bounds } -- <---
sprite:saveCopyAs(filename)

However, I may have been leveraging an additional feature of the script unknowingly.

Sprite Sheet

I want to export a sprite sheet instead of one frame with the combination script. Any ideas?

Layers with equal names

Hi,

first of all, thank you for the scripts!

There is one issue that I want to raise attention to. As far as I understand, when exporting layers and two layers have the same name, only one is exported or the second one overwrites the first one. It would not be a big issue, but people might not realize it when exporting and then something is missing. So maybe if the file exists already it could add filename (2) and so on or something similar.

bad argument error in Unsaved projects

When trying to use some of the options

export_combinations
export_layers
export_slices

in projects that have not been saved for the first time throws the following error:

Of course it is not something that prevents the script from working, you can save the project and that's it, I just wanted to raise awareness of the issue.

exporting layers with trimmed cells

it would be very useful, to be able to trim the cells when exporting each layer separately

Change folder structure to allow easy cloning and pulling

The current folder structure of the repository means one cannot simply clone it in Aseprite\scripts and pull future updates easily. The root of the repository should be the scripts/gaspi folder.

Frame number filename export option

With the default option, the frame number is appended to the end of a file, e.g. Layer1.png Layer2.png

For my project I need to be able to customise the position of this frame number so {framenumber} option when specifying Export layers -> filename.

Any chance this could be added or point us in the direction to add the functionality? Looking at export_layers.lua and struggling to see where frame number is being appended. Happy to throw some contribution your way for the help ☕ 🍺

Groups are not set to visible during export layers

If a group is not visible during export_layers, the associated exported layers will be empty files.