SHEET FORMAT // GRID

How frames are arranged in a sprite sheet

The frames of your sprite sheet sit in a grid of equal cells, read left to right and top to bottom, so an 8 x 8 grid holds 64 frames. Your engine needs the column and row counts to cut the sheet into frames. If those counts are wrong, the effect plays scrambled or shows half frames.

  • 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.

IMPACTFINAL
First frame of the impact bake
Impact, 3.5 x 2.8 m, compiled with Spatial Compiler. Spec →

01 // HOW IT WORKS

How a shader finds each frame

A flipbook shader finds frame n by its column (n modulo the column count) and its row (n divided by the column count, rounded down). It needs only the grid size and the frame count, and it scales the texture coordinates so one cell fills the quad.

Square grids such as 4 x 4 and 8 x 8 are the safe choice, since some engines offer them as presets. Roblox Studio's FlipbookLayout has Grid2x2, Grid4x4 and Grid8x8 presets, and its Custom layout takes other whole-number grids through FlipbookSizeX and FlipbookSizeY.

02 // SPATIAL COMPILER

The grid in Spatial Compiler's sheets

Sheets are 8 x 8 by default, 64 frames, set by export.grid as columns and rows. layout.json records the grid, the frame count, the frame order and the time of each frame, so a reader never has to guess.

One-shots such as the impact and the fireball give their fast early phase more frames, so their frames are not evenly spaced in time. The Godot 4 scene reads the times from layout.json. For an engine that plays at one fixed rate, ask your agent to set export.pacing to even.

03 // SEAMS

Keep neighbors out of each cell

Lines at the edge of a flipbook frame usually come from the next cell bleeding in through mipmaps or texture filtering. Each tile keeps an empty border, 4% of the tile by default (views.margin), and the compile report warns TILE_CLIPPING when the effect touches the edge.

05 // FAQ

Grid and frame questions

All questions →

README.SHEETS_GRID_AND_FRAMES
How should frames be arranged in a VFX sprite sheet?

Arrange frames in equal grid cells read left to right and top to bottom. A square 8 by 8 grid works in most engines.

How do I set the row and column count for a flipbook?

Enter 8 and 8 in your engine settings, such as Unity Tiles, Niagara Sub Image Size, Godot Anim Frames or Roblox Grid8x8.

How does a shader know how many frames are in a sprite sheet?

You pass the column and row counts, which Spatial Compiler writes into layout.json alongside each frame time.

How do I prevent seams between cells in a sprite sheet?

Leave an empty border around the effect and clamp the texture. These sheets keep 4% of each tile empty.

Is a sprite sheet better than separate images in Godot?

Yes. One sheet means one texture to load and one material to draw and Godot particle flipbook settings read grids directly.

What is the flipbook format?

A flipbook is one image holding all animation frames in equal grid cells, written as 8 bit PNG, 16 bit PNG or EXR.

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 →