How to import Aseprite animations to Godot with Aseprite Wizard?

Install the plugin in Godot, then use the inspector dock to select your Aseprite file and choose a target node like AnimationPlayer or AnimatedSprite. It automatically imports animations with timing and tags preserved from Aseprite.

Does Aseprite Wizard support Godot 3?

Yes, but there's a separate branch for Godot 3 with potential feature differences. Check the godot_3 branch and linked issue for specifics, as the plugin is primarily maintained for Godot 4.

Can I use Aseprite Wizard for tilesets in Godot?

Yes, it includes an Aseprite Tileset Texture importer that converts tilemap layers into AtlasTextures, which can be directly added to Godot's tileset creator for efficient level design.

Aseprite Wizard vs manual import in Godot, which is better?

Aseprite Wizard automates the process with timing and structure intact, saving hours of manual setup. Manual import is better for simple, static sprites or if you need fine-grained control over each frame.

How does Aseprite Wizard handle loopable animations?

It uses Aseprite tags with repeat properties to define loopable or non-loopable animations in Godot, ensuring seamless integration of Aseprite's animation workflow into your game.

What happens if I remove the Aseprite Wizard plugin after importing?

Imported animations remain functional because the plugin creates standard Godot resources like SpriteFrames and animation tracks. This non-destructive approach means you can safely uninstall it without breaking your project.

Is Aseprite Wizard free and open source?

Yes, the plugin is open-source on GitHub, but remember that Aseprite itself is a paid tool, so you need a valid Aseprite license to create the source files it imports.

Open-Awesome

Aseprite Wizard

MITGDScriptv9.8.0-4

A Godot Editor plugin to import Aseprite animations into AnimationPlayers, AnimatedSprites, and SpriteFrames.

Visit Website GitHub

1.4k stars61 forks0 contributors

What is Aseprite Wizard?

Aseprite Wizard is a Godot Editor plugin that facilitates the import of Aseprite animations into Godot, supporting nodes like AnimationPlayers, AnimatedSprites, and SpriteFrames. It solves the problem of manually converting Aseprite animations to Godot's format by automating the process while preserving animation timing and structure. This ensures a smooth workflow for integrating pixel art animations into Godot projects.

Target Audience

Game developers and pixel artists using Godot 4 and Aseprite for creating 2D or 3D games, particularly those who need efficient, accurate import of animations with minimal manual intervention.

Value Proposition

Developers choose Aseprite Wizard for its deep integration with both Aseprite and Godot, offering automated import with timing preservation, flexible node support, and a non-destructive workflow that doesn't lock projects into the plugin.

Overview

Godot Editor plugin to help import Aseprite animations to AnimationPlayers, AnimatedSprites and SpriteFrames.

Use Cases

Best For

Importing Aseprite animations into Godot AnimationPlayers for complex animation sequences
Creating SpriteFrames resources from Aseprite files for use with AnimatedSprite2D or AnimatedSprite3D
Converting Aseprite tileset layers into AtlasTextures for Godot's tileset creator
Preserving Aseprite animation timing (frame durations) when importing to Godot
Filtering specific layers from Aseprite files using regex during import
Managing loopable and non-loopable animations via Aseprite tags in Godot

Not Ideal For

Projects using animation software other than Aseprite, such as Photoshop or Krita
Developers who need real-time, code-driven animation updates without file re-imports
Teams that prefer building custom import scripts for full control over asset pipelines
Projects targeting Godot 3.x without plans to upgrade, due to separate branch maintenance

Pros & Cons

Pros

Timing Preservation

Converts Aseprite frame durations from milliseconds to Godot's FPS, ensuring animations retain exact timing without manual adjustment.

Flexible Node Support

Integrates with AnimationPlayer, AnimatedSprite2D/3D, and SpriteFrames, allowing diverse use cases from 2D sprites to 3D textures.

Non-Destructive Workflow

Once imported, animations function independently of the plugin, so projects aren't locked in and can be shared or distributed without it.

Aseprite Feature Integration

Supports Aseprite-specific features like tags for animation separation, layer filtering with regex, and slices for region-based imports.

Cons

Aseprite Dependency

Requires Aseprite to be installed and licensed, adding cost and setup complexity for teams not already invested in the tool.

Version Fragmentation

Separate branches for Godot 3 and 4, as noted in the README, can lead to confusion and require careful version management for compatibility.

External Documentation

Key documentation is hosted on an external website, which may be inaccessible offline or if the site experiences downtime.

Frequently Asked Questions

Related Projects

Pixelorama

Unleash your creativity with Pixelorama, a powerful and accessible open-source pixel art multitool. Whether you want to create sprites, tiles, animations, or just express yourself in the language of pixel art, this software will realize your pixel-perfect dreams with a vast toolbox of features. Available on Windows, Linux, macOS and the Web!

Stars10,604

Forks566

Last commit2 days ago

Godot Demo Projects

Demonstration and Template Projects

Stars9,678

Forks2,264

Last commit15 days ago

Lorien

Infinite canvas drawing/whiteboarding app for Windows, Linux and macOS. Made with Godot.

Stars6,860

Forks314

Last commit1 year ago

Dialogic

💬 Create Dialogs, Visual Novels, RPGs, and manage Characters with Godot to create your Game!

Stars6,080

Forks361

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub