ENFP-Dev-Studio - Aseprite Importer

Distribution Product Discussion
1
How to use


! Important ! - This plugin does not include the Aseprite software. Aseprite must be installed separately in order to use this plugin

The Aseprite Importer is a tool designed to streamline the process of importing .aseprite files, crafted in the Pixelart software Aseprite, directly into Unreal Engine for use with Paper2D. For the essential operation of this plugin, it's imperative to have the Paper2D Plugin enabled and to have Aseprite installed on your system.

  • Reason for Aseprite installation:

  • Aseprite is crucial for the conversion of .aseprite files.

  • Rationale behind activating Paper2D:

  • To ensure the seamless import and utilization of the converted aseprite files within Unreal Engine, the activation of Paper2D is imperative. Note: Paper2D comes bundled with Unreal Engine, eliminating the need for a separate installation.

Note: The purpose of this plugin is to allow you to import .aseprite files directly into Unreal Engine without any additional conversion. Therefore, if you've already exported your assets to a spritesheet format that Unreal Engine can recognize, there's no need to use this plugin.

2026.06.13 Release Notes (v1.10)

  • Import Option Improvements Added project settings for customizing flipbook naming separators when using Split Layers.

  • Experimental PaperZD Support Added an experimental option to generate basic PaperZD-compatible animation assets from imported flipbooks. (PaperZD plugin is required.)

2025.12.05 Release Notes (v1.9)

Re-import Improvements

  • Fixed an issue where Frame Run in flipbook animations was being reset to 1 during re-import.

  • Improved re-import behavior so user-modified import settings are no longer overwritten.
    (Re-import now focuses solely on applying texture updates and animation changes made in Aseprite.)

Import Option Improvements

  • Removed the Aseprite-based FPS calculation option, as its usefulness did not justify the complexity for users.

Bug Fixes

  • Fixed a bug related to setting the path for the Aseprite.exe file.

2025.10.29 Release Notes ( ver1.8 )

  • Added material selection option in the import dialog

  • Re-import Improvements

    • Fixed an issue where Pixels Per Unit (PPU) and Pivot Type were not correctly applied during re-import

    • Improved reflection of Aseprite animation changes during re-import

    • Fixed an issue where the default material was being reapplied on every re-import

  • Improved Animation Speed setting in Import Dialog

    • Now allows choosing between fixed FPS or importing from Aseprite

2025.01.12 Release Notes ( ver1.7 )

  • Added options to specify Pixels Per Unit (PPU) and pivot type in the import dialog

2024.09.19 Release Notes ( ver1.5 )

  • Enhanced "Split Layers" to auto-create flipbooks in Layer Group subfolders.

  • Made the AsepriteImporter class public for general accessibility.

2024.06.72 Release Notes ( ver1.4 )

  • Added Type Action for creating Flipbook Materials

  • This feature allows for the quick and easy creation of animated materials from multiple flipbooks imported from Aseprite into Unreal Engine 5 (UE5). It simplifies the workflow by automatically handling complex tasks such as SubUV settings, ensuring efficient management of multiple animation sequences.

  • Added Type Action for generating Flipbook Emitters

  • Similarly, this function facilitates the rapid creation of Emitters for UE5's Niagara system, using multiple flipbooks imported from Aseprite. It automates intricate settings like SubUV configurations, enabling seamless and efficient implementation of particle effects based on multiple animations.

2024.05.20 Release Notes ( ver1.3 )

  • Added an option to enable skipping empty tag frames when creating flipbooks.

  • Improved Flipbook Animation naming

2024.03.09 Release Notes ( ver1.2 )

  • New Features

  • Added Split Layers functionality: Ability to create Frames and Flipbooks separately for each layer, similar to the Split Layers option in Aseprite App's Export Sprite Sheet feature.

  • Bug Fixes and Usability Improvements

  • Improved naming of Flipbooks using Aseprite Animation Tags.

  • Fixed an issue where a Flipbook was created incorrectly when there was only one frame in a Tag.

  • Added Import Dialog

  • An option dialog is now available during import to set options.

2023.09.29 Release Note

  • Removed the plugin button and integrated the features into Unreal Engine's Import

  • Added an option to create a Flipbook upon Import (enabled by default)

  • Added an option to adjust the frame run count based on the Frame Duration from Aseprite, so it aligns with the FPS (15) set in Aseprite Importer Settings. This effectively synchronizes the duration each frame is displayed (enabled by default).

  • If you want to match the Frame Duration exactly with Aseprite, detailed instructions can be found at the here

  • Enhanced to reflect changes in Aseprite files through Reimport