SHEET FORMAT // PACKING

How to pack sprite sheet channels for your engine

Channel packing puts several grayscale maps into the red, green, blue and alpha of one texture, so your engine loads fewer files. You can ask your agent to repack the sheets into the layout your shader or engine already reads, such as one RGBA flipbook for an engine that takes only one texture.

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

FIREFINAL
First frame of the fire bake
Fire, 4.1 x 7.0 m, compiled with Spatial Compiler. Spec →

01 // HOW IT WORKS

Why effects pack channels

Most effect data is grayscale: opacity, light from one side, flame brightness, depth. Each one fits in a single channel, so four maps can share one RGBA texture and one texture read. Every shader expects its own order, so a sheet packed for one engine usually needs repacking for another.

02 // SPATIAL COMPILER

Channel settings you can ask for

  • export.channels picks what data the compile writes: any of six_way, emissive, motion, depth and temperature. The default is the first four.
  • export.pack maps each output file's channels to a source, so it can put any channel of any file into the layout an existing reader expects.
  • The smoke plume and smoke column compiles leave out emissive and write three sheets. Leave it out of a compile that has flame and the report warns FLAME_NOT_EXPORTED.
  • Temperature goes in the alpha of main_aux.png when you add temperature.

03 // COMMON REPACKS

Ask for the layout you need

  • One RGBA flipbook for Roblox Studio or a plain three.js SpriteMaterial: light from above in RGB and opacity in alpha, at 128 px tiles for Roblox.
  • A flame-only texture for an additive layer: flame color in RGB and flame brightness in alpha.
  • Your own six-way layout: the six directions in the order your shader reads them.

Describe the layout in plain words, and your agent writes the export.pack table and compiles again.

05 // FAQ

Channel packing questions

All questions →

README.SHEETS_CHANNEL_PACKING
How many particle effects should be packed into one texture atlas?

One effect per flipbook is simplest, since its grid fills the whole texture. Spatial Compiler writes one effect per sheet set and packs channels.

How do I assign a flipbook texture to a Roblox ParticleEmitter?

Upload one RGBA image of at most 1024 by 1024 px, set its asset id as Texture and set FlipbookLayout to Grid8x8.

Can I get one flipbook texture for Unity instead of four sheets?

Yes. Ask your agent to pack light from above and opacity into one RGBA sheet, then use Texture Sheet Animation set to Tiles 8 by 8.

Can particle systems use multiple effects from one atlas?

Yes, by giving each effect a range of cells, though each effect gets fewer frames. These sheets give every effect its own full grid.

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 →