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 and updating 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.

---

NEW IN VERSION 1.1.0

Workflow Update: reusable import presets, custom FPS and loop rules, search and filtering, bulk editing and safer rescanning.

Version 1.1.0 focuses on making repeated animation imports faster while protecting the adjustments already made during the current workflow.

• Save, load, update and delete reusable import presets.
• Create ordered keyword rules for automatic FPS and loop suggestions.
• Search animations by generated name or source folder.
• Show all, included or excluded scan results.
• Include, exclude or invert every animation currently shown.
• Apply FPS and loop changes to included animations currently shown.
• Preserve manual inclusion, name, FPS and loop edits when rescanning the same source animation folder.
• Detect outdated scan results when import settings change.
• Restore workflow settings and custom rules between editor sessions.
• Detect empty or duplicate included animation names before generation.

---

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. Load an import preset or configure the scan manually.
4. Scan the folder and its subfolders.
5. Search, filter and review the detected animations.
6. Edit names, FPS, loop settings and included animations individually or in bulk.
7. Choose a generation mode.
8. 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

---

Reusable Import Presets

Save recurring import settings and reuse them with other characters or sprite packs that follow the same conventions.

Presets can store:

• Recursive scanning.
• Excluded folder names.
• Animation naming mode.
• Default FPS.
• Generation mode.
• External .tres saving preference.
• Custom animation rules.

The selected AnimatedSprite2D, sprite root folder and output path are intentionally not stored because they are usually specific to each character or project.

Presets are stored as local editor data and are not added to the Godot project.

---

Custom FPS and Loop Rules

Create ordered keyword rules to adapt automatic FPS and loop suggestions to the naming conventions used by your assets.

The first matching custom rule has priority. When no custom rule matches, Sprite Animation Builder uses its built-in suggestions.

Each rule can define:

• A keyword searched inside the generated animation name.
• An FPS value, with 0 keeping the automatic FPS suggestion.
• Auto, Loop or No loop behavior.

attack   16 FPS   No loop
idle      6 FPS   Loop
spell    12 FPS   No loop

---

Search, Filters and Bulk Editing

Search scan results by animation name or source folder, then display all, included or excluded animations.

Selection actions apply to every animation currently shown after search and filtering:

• Include shown.
• Exclude shown.
• Invert shown.

FPS and loop bulk actions apply only to animations that are both included and currently shown.

This makes it possible to search for a group such as attack, apply one FPS value, disable looping and continue reviewing the rest of the character.

---

Safer Rescanning

Manual changes to inclusion, animation names, FPS and loop settings are preserved when the same source animation folder is found during a new scan.

When a scan-related setting changes, the current results are marked as outdated and generation is disabled until the folder is scanned again.

This prevents animations from being generated with results that no longer match the selected import settings.

---

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.
• Search and filter scan results.
• Apply inclusion, FPS and loop changes in bulk.
• Automatically suggest FPS and loop behavior from animation names.
• Create custom ordered FPS and loop rules.
• Save reusable import presets.
• Preserve manual edits when rescanning the same source folders.
• 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.
• Detect empty and duplicate included animation names before generation.
• Detect outdated scan results when import settings change.
• 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.
• Teams or solo developers reusing the same import conventions.
• 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.1.0.zip.
2. Copy the included addons folder into the root of your Godot project.
3. Confirm that res://addons/sprite_animation_builder/plugin.cfg exists.
4. Open Project > Project Settings > Plugins.
5. Enable Sprite Animation Builder.
6. Select an AnimatedSprite2D and open the Sprite Animation Builder dock.

---

Updating from Version 1.0.0

Before updating, making a backup of your project is recommended.

1. Close the Godot editor.
2. Replace addons/sprite_animation_builder/ with the folder included in version 1.1.0.
3. Reopen the project.
4. Confirm that the plugin remains enabled in Project > Project Settings > Plugins.
5. Run a new scan before generating animations.

Version 1.1.0 keeps the existing generation workflow and does not require a project data migration.

Presets and workflow settings are stored locally by the editor and are not included in the project files.

---

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.1.0.
• Generated animation names depend on the organization and naming of your folders.
• Presets are local editor data and are not automatically shared between computers.
• Rescan preservation matches animations by their source folder. A moved animation folder is treated as a new source.

---

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.

---

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.1.0 – Workflow Update

• Reusable import presets.
• Ordered custom FPS and loop rules.
• Animation and source-folder search.
• Included and excluded result filters.
• Bulk inclusion, FPS and loop editing.
• Manual edit preservation during rescans.
• Outdated-scan protection.
• Persistent workflow settings.
• Immediate name validation.
• Recursive folder scanning.
• Natural frame sorting.
• 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.
• The active preset or custom rules when relevant.
• The search and filter state when a bulk action is involved.
• A screenshot of the plugin dock or dialog 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.