Aseprite Anim Setter

Table of Contents

1. Introduction
2. Tutorial

Introduction

This tool originated from the repetive work of updating loads of Animations
in Godot when I changed the Spritesheets with Aseprite. It started as a scipt,
and turned into a "full fledged" addon.

Tutorial

1. Export from Aseprite

Export as a Spritesheet (File -> Export Spritesheet or just Ctrl+E), check JSON Data
and Frame Tags under meta are ticked. It's easier when both files have the same name
and are in the same folder.

2. Setup in Godot

When You select a Sprite or a Sprite2D, a Dock will be added to the bottom right,
entitled "AnimSetter". It makes sense to first apply the texture, then go to the
AnimSetter Dock. If the Json-file is in the same folder and has the same name as
the texture the Json-file will automatically be selected for you. If not, you can
also manually selected it. You also have to apply the framesize, as this is needed
to set up the region, hframes and vframes parameters of the texture. With the a
click on the "Update"-button, an AnimationPlayer Node will be created for you and all
Animations are automatically set up. With the "Delete Animations"-button, all
Animations will be deleted. The duration of a frame corresponds to the duration set
in the frame properties in Aseprite. Also a default-offset of (0|0) will be set at
the beginning of each frame. You can change this by changing the defaultOffset
variable in the "ImportJsonAnim.gd"-Script. A better solution will be added later.
There is also the import mode. This should be set to Hash or Array, depending on
the Setting during the export in Aseprite. By default is this Hash, like the default
in Aseprite.