Aseprite

An Aseprite importer for Unity3D. View On GitHub 🎨📤

Project logo; A pink package on a grey background, next to the text "Aseprite" in purple

GitHub package.json version openupm CI Discord

Aseprite is an animated sprite editor and pixel art tool. This package supports taking Aseprite files (.ase, .aseprite) and importing them into Unity. Most importantly, it preserves layers - importing them individually rather than as a single combined frame. This allows for further customization inside the engine. The importer will also import animations (including frame timings) as both individual animations, and "combined" animations designed to be applied to a top-level Game Object that mirrors the structure of Aseprite layers. If desired, such a Game Object can also be generated during import.

Installing

This package supports openupm - you can install it using the following command:

openupm add com.faster-games.aseprite

Or by adding directly to your manifest.json:

Note: You may also use specific versions by appending #{version} where version is a Release tag - e.g. #v1.2.0.

dependencies: {
	...
	"com.faster-games.aseprite": "git+https://github.com/faster-games/aseprite.git"
}

Or by using Package Manager to "Add a package from Git URL", using the following url:

https://github.com/faster-games/aseprite.git

Documentation

Manual 📖 | Scripting API 🔎

The importer will automatically detect and import aseprite files, so all configuration is optional. To modify configuration, select the Aseprite file in the Project window.

Quickstart

  • Drag a .ase or .aseprite file into the Project window under Assets
  • Select it in the Project window
  • Note that the importer used is AsepriteImporter - that's us!
  • Any processing errors will be shown in the Console

Supporting the project

If this project saved you some time, and you'd like to see it continue to be invested in, consider buying me a coffee. ☕ I do this full-time, and every little bit helps! 💙

  • Improve this Doc
In This Article
Back to top Copyright FasterGames ©