Skip to content

Search

Documentation

sprite_sheet asset type

An image cut into frames, for sprite.sheet. texture names the image; frames each hold a rect and duration; [tags.<name>] and [slices.<name>] add runs and…

Files live in sheets/. Used by particles2d · sheet, sprite · sheet.

An image cut into frames, for sprite.sheet. texture names the image; frames each hold a rect and duration; [tags.<name>] and [slices.<name>] add runs and regions.

type = "sprite_sheet"            # balaur import file.aseprite writes one beside the atlas it packs
texture = "art/walk.png"
frames = [                       # rect is [x, y, w, h] texture pixels; sprite.frame indexes this list
  { rect = [0, 0, 32, 32], duration = 0.1 },
  { rect = [32, 0, 32, 32], duration = 0.1 },
]

[tags.walk]                      # a run of frames
from = 0
to = 1
direction = "forward"            # forward, reverse, pingpong or pingpong_reverse
repeat = 0                       # zero for ever

[slices.hitbox]                  # a rect on a frame, in the frame's own pixels
rect = [8, 4, 16, 28]
# center = [4, 4, 8, 20] and pivot = [8, 14] make it a nine-patch with a pivot;
# keys = [...] when the slice moves between frames