
Release Atlas PNG and JSON as One Versioned Pair
When an atlas looks correct after a hard refresh but wrong for returning users, inspect the PNG and metadata as a pair. A new JSON rectangle can point into an old cached image, or old metadata can cro

When an atlas looks correct after a hard refresh but wrong for returning users, inspect the PNG and metadata as a pair. A new JSON rectangle can point into an old cached image, or old metadata can cro
An animation can contain all the right images and still feel wrong because its importer replaced unequal frame holds with one frame rate. Preserve the ordered frame-duration pairs, their units and the

A dark sprite outline and a line sampled from a neighboring atlas cell need different fixes. First draw the sprite as a standalone image using the same alpha interpretation, filter and scale as the at

To diagnose pixel-art jitter, freeze one source frame and change only the camera, then restore a fixed camera and change only the animation. That split tells you whether the defect follows scene sampl

If a character's planted foot jumps when an animation changes frames, compare that foot in the original canvas coordinates before moving the game object. Independent trimming changes a frame's stored

Store an equipment socket in a declared character coordinate space and mirror it exactly once. Texture flipping, transform mirroring and atlas trimming affect different parts of that calculation. A we

When a sprite hitches on first appearance, trace its path from request to first visible draw. A completed download or resolved asset promise does not, by itself, identify the remaining work. Compare c

Budget sprite memory from texture dimensions, pixel formats and simultaneously live resources. The PNG download size is a separate network cost. A highly compressed image can still require a large dec

Approve a sprite animation against its ordered frame IDs and intended hold durations, then compare the target runtime with that record. Use a GIF as a convenient visual preview. Its appearance alone c
