Sprite Animation Builder

Turn organized sprite folders into ready-to-use AnimatedSprite2D animations directly inside Godot.

Sprite Animation Builder is a Godot 4.7 editor plugin designed to remove the repetitive work involved in creating SpriteFrames animations manually.

Select an AnimatedSprite2D, choose the folder containing your sprite sequences, review the detected animations and generate a complete SpriteFrames resource in just a few clicks.

---

Godot Pixel Animation Starter Bundle

Get Sprite Animation Builder together with Pixel Prototype Player Sprites by Dead Revolver.

The sprite pack provides a large collection of organized character animations, while Sprite Animation Builder turns its folders into ready-to-use AnimatedSprite2D animations directly inside Godot.

Both products normally cost $19.98 together.

The complete bundle is currently available for:

$9.99 — 50% Off

View the Godot Pixel Animation Starter Bundle

---

Stop Creating Every Animation by Hand

Importing a character with dozens of animation folders can require creating every animation, adding every texture, checking the frame order, configuring the FPS and setting the loop behavior manually.

Sprite Animation Builder automates this workflow while keeping the generated result fully editable inside Godot.

---

How It Works

1. Select an AnimatedSprite2D in your scene.
2. Choose the root folder containing your sprite animations.
3. Scan the folder and its subfolders.
4. Review the detected names, frame counts, FPS and loop settings.
5. Choose a generation mode.
6. Generate the animations and optionally save the SpriteFrames resource as an external .tres file.

Each folder containing supported image files becomes an animation.

Sprites/
├── Idle/
│   ├── Idle01.png
│   ├── Idle02.png
│   └── Idle03.png
├── Walk/
│   ├── Walk01.png
│   ├── Walk02.png
│   └── Walk03.png
└── Combat/
    └── SwordSlash/
        ├── SwordSlash01.png
        └── SwordSlash02.png

---

Core Features

• Generate SpriteFrames animations from organized image folders.
• Scan nested folders recursively.
• Create one animation for each folder containing supported images.
• Natural numeric sorting so Frame2 is placed before Frame10.
• Preview every detected animation before generation.
• Rename detected animations individually.
• Change FPS and loop settings for each animation.
• Enable or disable individual animations before generation.
• Automatically suggest FPS and loop behavior from animation names.
• Exclude folders such as FX, Weapons, Icons or Portraits.
• Generate names from the final folder or the complete relative path.
• Automatically convert generated names to snake_case.
• Save the generated SpriteFrames as an external .tres resource.
• Restore the previous SpriteFrames assignment with Godot's Undo system.

---

Three Generation Modes

Replace All

Create a fresh SpriteFrames resource containing only the animations included in the latest scan.

Merge New Only

Keep the existing animations and add only animations whose names do not already exist.

Update Detected

Replace the animations included in the latest scan while leaving unrelated existing animations untouched.

---

Supported Image Formats

• PNG
• JPG and JPEG
• WEBP
• SVG

Images must already be imported as textures by Godot.

---

Designed For

• Pixel-art characters with large animation libraries.
• 2D characters using AnimatedSprite2D.
• Purchased sprite packs organized as image sequences.
• Player, enemy and NPC animation folders.
• Developers who frequently add or update animation frames.
• Prototypes and game jams where setup time matters.

---

Installation

1. Download and extract Sprite_Animation_Builder_1.0.0.zip.
2. Copy the following folder into your Godot project:

addons/sprite_animation_builder/

1. Open Project > Project Settings > Plugins.
2. Enable Sprite Animation Builder.
3. Select an AnimatedSprite2D and open the Sprite Animation Builder dock.

---

Package Contents

• Complete Sprite Animation Builder editor plugin.
• Installation and usage documentation.
• Changelog.
• Credits.
• Commercial-use license.

Third-party showcase sprite assets are not included.

---

Requirements

• Godot Engine 4.7.x.
• An AnimatedSprite2D node.
• Animation frames stored as individual image files.
• One animation sequence per folder is recommended.

---

Important Limitations

• The plugin creates SpriteFrames animations but does not create gameplay state logic.
• It does not automatically generate an AnimationTree or character controller.
• Spritesheets containing multiple frames inside a single image are not supported in version 1.0.0.
• Animated GIF import is not currently supported.
• Generated animation names depend on the organization and naming of your folders.

---

Showcase Asset & Credits

The character animations shown in the screenshots, GIFs and demonstration videos are from Pixel Prototype Player Sprites by Dead Revolver .

Used with permission from the asset creator.

Pixel Prototype Player Sprites is not included with Sprite Animation Builder. The asset pack is available separately from its official itch.io page or as part of the Godot Pixel Animation Starter Bundle .

---

License Summary

You may use Sprite Animation Builder in personal and commercial Godot projects.

You may modify the plugin for use inside your own projects.

You may publish and sell games or applications created with the plugin.

You may not resell, redistribute, share, sublicense or publish the plugin source files as a standalone product, competing plugin, public template or downloadable repository.

See LICENSE.txt inside the package for the complete terms.

---

Current Version

Sprite Animation Builder 1.0.0

• Godot 4.7 compatibility.
• Recursive folder scanning.
• Natural frame sorting.
• Editable animation preview.
• Automatic FPS and loop suggestions.
• Replace, merge and update modes.
• External SpriteFrames resource saving.
• Editor Undo support.

---

Support and Feedback

When reporting an issue, please include:

• Your exact Godot version.
• The complete error message.
• The folder structure used during the scan.
• The selected generation mode.
• A screenshot of the plugin dock when relevant.

Feedback and feature suggestions are welcome in the comments.

---

Sprite Animation Builder is developed by Asago.

Thank you for supporting independent Godot tools.