Ase importer plugin allows you to import and automatically generate your animations (textures, sprites and flipbooks) from an Aseprite save file (.aseprite).
How it works?
Just drag and drop an .aseprite file in the content browser. The plugin will generate texture atlases for all the frames in the aseprite file automatically for you. After that, for each tag found in the aseprite file, the plugin will create a PaperFlipbook animation with all the PaperSprites for each frame in that aseprite tag automatically.
If you have an aseprite file without tags inside it will treat ALL the frames in the aseprite file as a single animation. (It will only create a single PaperFlibook with all the PaperSprites (frames) of the aseprite file.
Documentation (FAQ):
How to import an aseprite file?
Just drag and drop the .aseprite file to the content browser.
How animations (flipbooks) will be created?
The importer has two modes of operation, with tags/without tags:
- Without aseprite tags:
It will create only one flipbook animation that will contain all the PaperSprites (frames) of the entire aseprite file.
- With aseprite tags:
It will create a flipbook animation for each tag found in the aseprite file.
Can I set the animation (flipbook) speed (fps) from aseprite?
“Yes”. Currently Unreal Engine doesn’t support per frame duration animations in PaperFlipbooks like aseprite. In order to set the flipbook fps, the importer will look at the FIRST frame duration of each aseprite tag.
Can I reimport the assets from the same aseprite file without losing my flipbook references in the editor?
“Yes”. Just drag and drop again the new aseprite file. If you are using the same tags, the importer will not create new assets. It will just modify the existing ones with the new data from the aseprite file.
Technical Details
DOCUMENTATION: https://docs.google.com/document/d/14ekUcQ-NTG0z9OHPoe2Ur9hoWwOUS67h-JihiG4otqc/edit?usp=sharing
Features:
- Generates texture atlases with all the frames of all the animations in the aseprite file. (if the atlas is greater than 2048×2048 will create another texture atlas).
- Generates PaperSprite assets of all the frames in the aseprite file.
- Generates a PaperFlipbook animation for each tag found in the aseprite file.
- Generates a PaperFlipbook animation for ALL the frames in the aseprite file if no tag is found.
- Supports aseprite version 1.2 and 1.3
- Suports “reimporting”. if you drag and drop the same aseprite file multiple times, instead of generating new assets, will look up existing ones and update them. This prevents losing references if you just only changed the texture.
- Supports setting the FPS of the animation tag (Flipbook). Unreal flipbooks doesn’t support per frame times like aseprite. So the importer will look at the FIRST frame duration from aseprite to set the fps speed of the unreal flipbook.
Supported:
- Only the “normal” blend mode for layers is supported.
- Maximum aseprite layers per file: 64
- Maximum aseprite tags per file: 256
Not Supported:
- Aseprite sRGB and ICC profiles.
- Aseprite Grayscale, Indexed modes. (unreal doesn’t support this)
- Aseprite Slices.
Code Modules:
- APAseEditorModule (Editor)
You can contact us at any time and request that the asset you want be added to the site from the Request Asset section.
