Skip to content

Latest commit

 

History

History
112 lines (60 loc) · 4.45 KB

README.md

File metadata and controls

112 lines (60 loc) · 4.45 KB
Raw

Aseprite Add-ons

This repository developed out of the Medium article, "How To Script Aseprite Tools in Lua". Short demonstrations for some the scripts here can be found in this Youtube playlist.

As of Wednesday, November 20, 2024, this repository has a Beta branch. The Beta branch corresponds with Aseprite version 1.3.11-beta1. You will need the beta version of Aseprite to use scripts in that branch. The primary difference between the two branches is how scripts in the dialogs/shape folder work. Primary development of this repository will take place in the Beta branch. The main branch will focus on bug fixes.

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.10 is the minimum supported version 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".

Most scripts dealing with color assume standard RGB is the working color profile. The window profile is set under Edit > Preferences > Color. The sprite profile is set under Sprite > Properties.

References

For more resources, see

Gallery

This repo includes

  • Export Tile Maps and Sets to Tiled.

    Export Tiles

  • Color curves. (Test image source.)

    Color Curve

  • A conic gradient.

    Conic Gradient

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

    FS Dither

  • A text insertion dialog.

    Insert Text

  • Interlaced layers. (Test image source.)

    Interlaced

  • LCh color picker.

    LCh Color Picker

  • A linear gradient.

    Linear Gradient

  • Gradient map. (Test image source.)

    Luminance remapping

  • Custom New Sprite

    New Sprite

  • Normal color picker.

    Normal Map

  • Normal from height.

    Normal From Height

  • Outline Gradient.

    Outline Gradient

  • Palette Manifest.

    Palette Manifest

  • Palette To Cel Assignment.

    Palette To Cel

  • A radial gradient.

    Radial Gradient

  • RGB channel separation.

    Separate RGB

  • Basic cel transformation.

    Cel Transformation

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