GUIDE // GODOT 4

How to import a sprite sheet into Godot 4

Copy the PNG into your project folder and Godot imports it as a texture by itself. In the Import dock, keep mipmaps on for effects seen at a distance and choose a compression mode. Then tell the node how the sheet is cut, with Hframes and Vframes on a Sprite3D or the sprite sheet tool in SpriteFrames.

  • Godot 4 Available
  • Unity Manual setup
  • Unreal Engine Manual setup
  • Roblox Studio Manual setup
  • three.js Available

A draft compile is from $0.05, and new accounts start with $5 of usage.

SMOKE_PLUMEFINAL
First frame of the smoke_plume bake
Smoke plume, 7.0 x 10.8 m, compiled with Spatial Compiler. Spec →

01 // HOW TO

Import and slice the sheet

  1. Copy the PNG into a folder inside your project, such as res://fx/smoke/. Godot writes a .import file next to it.
  2. Select the PNG in the FileSystem dock and open the Import dock.
  3. Set Compress Mode to Lossless while you judge the look. Try a compressed mode later and compare the soft edges.
  4. Turn on Mipmaps > Generate for sheets used in 3D, then click Reimport.
  5. For a Sprite3D, load the texture and set Hframes and Vframes to the grid, then pick the frame with Frame.
  6. For an AnimatedSprite3D, open its SpriteFrames, click Add Frames from Sprite Sheet and enter the same grid.
  7. For particles, use the sheet on a StandardMaterial3D with Particle Billboard and Particles Anim H Frames and V Frames.

02 // SETTINGS

Import settings that matter for effects

  • Fix Alpha Border (on by default) fills the color of transparent pixels from their neighbors, which stops dark fringes at soft edges.
  • Detect 3D can switch a texture to a compressed mode the first time a 3D material uses it. Set the mode yourself so it stays the way you chose.
  • Texture filtering lives on the material in Godot 4, under Sampling > Filter, not in the Import dock. Linear Mipmap suits soft effects.
  • Keep the sheet a power of two on each side, such as 1024 or 2048, so mipmaps and compression divide it cleanly.

03 // WITH SPATIAL COMPILER

Let your agent set the import options

When your agent wires a compile into a Godot 4 project, it sets the texture import settings for each sheet and writes the scene that uses them, so you can skip the by-hand import steps. Each sheet is 2048 x 2048 by default, 64 frames of 256 px on an 8 x 8 grid.

Put the output folder inside your project before wiring, since the scene refers to the sheets by their res:// paths.

04 // REAL OUTPUT

Sheets as they import

DUST_RINGFINAL
First frame of the dust_ring bake
Dust ring, 10.5 x 2.2 m, compiled with Spatial Compiler. Spec →

06 // FAQ

Sprite sheet import questions

All questions →

README.GODOT_IMPORT_SPRITE_SHEET
How do I import a sprite sheet into Godot?

Copy the PNG into your project folder so Godot imports it automatically, then adjust settings in the Import dock and click Reimport.

How do I slice a sprite sheet in Godot?

Leave the image intact and set Hframes and Vframes on Sprite3D or use Add Frames from Sprite Sheet in SpriteFrames.

Should I use a sprite sheet or individual images for effects in Godot?

Use a sprite sheet because particles and flipbook materials read a single grid texture and load faster than 64 separate files.

How do I use a dust sprite sheet with a transparent background in Godot?

Save the PNG with an alpha channel, keep Fix Alpha Border enabled in the Import dock and set Transparency to Alpha.

Compile your first effect

You pay per compile and see the price before it runs. New accounts start with $5 of usage.

All effects, guides and explainers →