Ambient Sprite Animator Importer

A free Godot editor plugin for importing animation ZIPs exported by Ambient Sprite Animator. Supports single-sprite and batch exports. Both the importer and the complete Ambient Sprite Animator app are free.

Features

• Import up to 100 source sprites per export ZIP.
• Create one editable SpriteFrames resource per source sprite.
• Preserve exported frame order, playback speed and looping.
• Combine split sheet pages into one animation.

The plugin imports existing Ambient animations. It does not generate artwork or import arbitrary standalone sprite-sheet PNGs.

Installation and use

1. Extract the plugin ZIP into your Godot project, keeping addons/ambient_png_loops intact.
2. Enable Ambient Sprite Animator Importer under Project > Project Settings > Plugins.
3. Choose Project > Tools > Import Ambient ZIP.
4. Select an intact schema-2 export ZIP from Ambient Sprite Animator and a destination inside your project. Review the proposed import, then choose Apply.
5. Assign a generated SpriteFrames resource to an AnimatedSprite2D node, select loop and enable Autoplay.

Place sprites in your scene yourself. Imported resources do not require the plugin at runtime.

Compatibility

Tested in Godot 4.7.2 stable on Windows. Other versions and operating systems are unverified. Supports original Ambient schema-2 ZIPs, 2–64 frames per sprite, 5–30 FPS and sheets up to 4096 pixels per side. Limits: 300 MiB compressed, 512 MiB expanded, 80 MiB per file. ZIP64, encrypted archives and repacked wrapper folders are unsupported.

Use Project > Tools > Update Ambient import to apply a revised export ZIP to a tracked import folder. Review the changes before applying. Existing SpriteFrames paths, UIDs and references are preserved; unchanged sources are skipped. Conflicting manual edits stop the update. Removed source members are retained as inactive resources. Keep AmbientImport.json with your import. Older 0.1.x imports require a one-time separate import and reassignment.

Get Ambient Sprite Animator

Download Ambient Sprite Animator for free. The complete app, including all animation types and batch export, is free. No purchase is required.

Version 0.2.0. MIT licence.