01 · Scope
Keep visual cleanup outside the engine, keep runtime behavior inside
Prepare the asset contract
Use predictable filenames, canvas dimensions, transparent padding, alignment, and a manifest that describes the intended filtering and pivot semantics.
Validate the runtime contract
Godot controls import options, SpriteFrames ordering, animation speed, looping, scene composition, and how the asset is positioned during gameplay.
02 · Workflow
A practical Godot 4 import sequence
- Split the source locallyDetect the subjects, repair crop bounds, and keep small accessories, shadows, or effects that belong to each frame.
- Choose consistent output settingsUse fixed canvases for animation sequences and a shared bottom-center alignment for grounded characters. Use crisp pixel-art output for low-resolution sprites.
- Export Godot 4 metadataChoose the Godot 4 engine target and download the delivery ZIP. Keep the manifest next to the PNG files so import decisions remain reviewable.
- Build and preview SpriteFramesIn Godot, create or open a SpriteFrames resource, add the individual files in sequence, set animation speed and looping, then review the animation at intended camera scale.
03 · Decision guide
Asset decisions that affect Godot results
| Decision | Safe starting point | Verify in Godot |
|---|---|---|
| Animation frame canvas | Same width and height | No positional jitter between frames |
| Character alignment | Bottom center | Feet or ground contact remain stable |
| Pixel filtering | Nearest for pixel art | Project and texture filtering agree |
| Frame naming | Zero-padded sequence | SpriteFrames order is deterministic |
04 · Quality gate
Before you commit the Godot resource
- All expected files appear in the FileSystem dock.
- The SpriteFrames order matches the contact sheet.
- Loop and FPS values match the intended motion.
- Transparent padding does not clip effects.
- Pixel filtering stays consistent at runtime scale.
- Renaming assets does not leave broken resource paths.
05 · Questions
What to confirm before you ship
- Can Godot animate one sprite sheet directly?
- Yes. Godot supports sprite sheets as well as collections of individual images. Individual files are convenient for irregular extractions, independent replacement, and explicit review.
- Does the manifest create a Godot scene automatically?
- No. It documents export filenames and intended import semantics. Scene and SpriteFrames creation remain deliberate project actions.
- Why use fixed canvases for animation?
- A shared canvas and alignment reduce visual jumping when silhouettes differ between frames. The actual result should still be tested in the target scene.
06 · Sources
Scope and references
Primary references: Godot 4 2D sprite animation documentation. Product behavior described on this page refers to SpriteSplitter version 0.3.0.