behreajj / AsepriteAddons

Lua scripts for Aseprite add-ons.

Aseprite Add-ons

This repository developed out of the Medium article, "How To Script Aseprite Tools in Lua".

Installation

To install, click on the green Code button above. Select Download ZIP from the pop-up menu. Unzip the file after it has finished downloading. In Aseprite, go to File > Scripts > Open Scripts Folder. Copy commands, dialogs and support folders from the unzipped download into the folder that Aseprite has opened. Return to Aseprite, go to File > Scripts > Rescan Scripts Folder.

There is a known issue when Aseprite's script folder is on a file path that includes characters such as 'é' (e acute) or 'ö' (o umlaut).

Usage

Aseprite version 1.3 is the minimum version needed to run these scripts.

To use, go to File > Scripts and choose from entries in the dialogs or commands folder.

Scripts can be assigned shortcuts in Edit > Keyboard Shortcuts. Dialog buttons can be called by holding down the Alt key and pressing the underlined letter of the button's label. For example, Alt+C will close dialogs, per the 'C' in "CANCEL".

In dialogs that use custom sliders -- such as the LCH picker, color adjustment and normal picker -- holding down Ctrl and clicking will return the slider to a default value, holding down Shift and moving the mouse will increment the slider value.

References

For more resources, see

• Aseprite Type Definition
• Aseprite CPP source that receives Lua inputs
• Aseprite Scripting API
• Lua Documentation
• Aseprite General Documentation
  • Run Aseprite in Debug Mode
  • Aseprite Command Line Interface
• Aseprite Forum

Gallery

This repo includes

• Export Tile Maps and Sets to Tiled.

  

• Color curves. (Test image source.)

  

• A conic gradient.

  

• A Floyd-Steinberg filter (Test model source.)

  

• A text insertion dialog.

  

• Interlaced layers. (Test image source.)

  

• LCh color picker.

  

• A linear gradient.

  

• Luminance (grayscale) remapping. (Test image source.)

  

• Custom New Sprite

  

• Normal color picker.

  

• Normal from height.

  

• Outline Gradient.

  

• Palette Manifest.

  

• Palette To Cel Assignment.

  

• A radial gradient.

  

• RGB channel separation.

  

• Basic cel transformation.

  

Appearances may vary as features are added to or removed from underlying scripts.