About unity-aseprite-importer

A Unity package written in C for importing Aseprite .ase and .aseprite files directly into Unity, built on Unity's experimental AssetImporter API. The importer fully reads the compressed binary Aseprite format in C and generates static sprite sheets, sprites, tilemaps, and animations. It creates non-dynamic animation files along with an animation controller. Editable metadata such as custom physics shapes can be refined using Unity's Sprite Editor. The tilemap generation uses extended padding to prevent line tearing between tiles, and new row-col tilemap naming rules are supported. Installable via OpenUPM using the package name io.tinu.asepriteimporter, through the OpenUPM CLI, or by adding the git repository URL through Unity's Package Manager. Ideal for Unity developers using Aseprite for 2D pixel art who want a streamlined workflow that avoids exporting spritesheets externally.

m

Published by

martinhodler

Visit View Profile

README.md

View on GitHub

Aseprite-Importer for Unity

AsepriteImporter Thumbnail

This package helps you importing .ase files from aseprite. The reader is fully written in C# which reads the compressed binary file and creates spritesheets, sprites and animations out of it.

Features

Creates a sprite sheet file (not dynamic)
Editable meta data like custom physics shapes with the 'Sprite Editor'
Generates tilemap with extended-padding (solves lines tearing issue between tiles)
Makes animation files (not dynamic)
Creates an animation controller
New tilemap name rule support (row-col)

Demo GIF of AsepriteImporter

Install

OpenUPM

Unity Package

OpenUPM lets you install packages more easily by providing a downloadable unity package which will setup the package automatically. You can find the download on the following link:

https://openupm.com/packages/io.tinu.asepriteimporter/

CLI

Prerequisites

See: https://openupm.com/docs/getting-started.html#installing-openupm-cli

OpenUPM CLI Install

# Go to your Unity project directory
cd YOUR_UNITY_PROJECT_DIR

# Install package: io.tinu.asepriteimporter
openupm add io.tinu.asepriteimporter

Unity

In Unity open the Package Manager (Window > Package Manager).
In the Package Manager click on the Plus-Icon in the top-left and select Add package from git URL...
Enter the URL of this Repository (https://github.com/martinhodler/unity-aseprite-importer.git) and press Enter

License

See LICENSE file.

Note: As of Unity doesn't include any editor scripts in the game, you don't have to license your game under GPL.

unity-aseprite-importer