Advanced Spritesheet Export

Current version: 0.1.1.

Do you make spritesheets with Aseprite?

Are you annoyed when you have to toggle visibility on all your layers every time you want to export a spritesheet?

Are you tired of having to flatten layer groups down if you want them to be exported as a single sprite in the sheet?

Then Advanced Spritesheet Export is for you! This extension allows you to customize exactly how your Aseprite layers get exported into a spritesheet, without having to make temporary modifications to your layers before every export. Just configure the Advanced Export settings for layers and groups once, and get a perfect export every time.

Features

• Export layers regardless of visibility. (layers and groups can instead be explicitly ignored)
• Selectively export layer groups as single sprites without modifying or flattening the groups.
• Configure layer settings via Layer menu, right click menu, or keyboard shortcut.
• Modify settings for multiple selected layers at once.

Usage

• All layers are exported by default. To ignore the active layer or group, select Layer -> Advanced Export -> Toggle Ignore.
• To export a layer group as a single sprite, select Layer -> Advanced Export -> Toggle Merge Group.
• Invoke the tool via File -> Export -> Export Sprite Sheet (Advanced).

Keyboard Shortcuts

All of the Aseprite commands are available as keyboard shortcuts as well:

Command	Shortcut (Windows/Linux)	Shortcut (MacOS)
Toggle Ignore Layer(s)	Ctrl+Alt+I	Cmd+Ctrl+I
Toggle Merge Group(s)	Ctrl+Alt+M	Cmd+Ctrl+M
Export Spritesheet (Advanced)	Ctrl+Alt+E	Cmd+Ctrl+E

Additional Notes

• Ignored layers always take precedence over merging; if a sublayer in a group is ignored, it will not be merged into the final sprite.
• Toggling the advanced export settings on a layer will modify the layer colors. The extension will attempt to detect and preserve user-colored layers. If you happen to use one of the exact colors we have chosen, this will fail. We have chosen odd alpha values to reduce the likelihood of a false negative, but if you are using layer colors extensively, this extension may not work well for you.
• To force a layer's color to be controlled by the extension, simply reset the layer's color to all 0 values. (red, green, blue, and alpha should all be 0) You may need to toggle the export settings of a parent layer or create a new layer before the changes take effect.

Contributing

The Advanced Spritesheet Exporter is open source. Pull requests and bug reports are welcome at https://git.annabunches.net/annabunches/advanced-spritesheet-export.