sparklecatta-lang/xsxb-frame-tuner

XSXB Frame Tuner is a local workbench for adjusting frame by frame animations for Godot game characters and for Codex pets. It ships with a matching Codex or Agent skill, so an AI agent handles importing, syncing, and checking the art files, while a person uses a web page to look at individual frames, drag the character around, and adjust hit boxes and hurt boxes by hand. Finished Godot animations get saved back into the game project, and custom Codex pets get saved back into their pet sprite sheets. The repo also includes a fully separate tool called Frame Tuner Lite. Lite is not tied to any specific game. Instead, it takes a folder of PNG image sequences, or a sprite sheet with a matching JSON file, and turns them into a consistent set of transparent, layered frame sequences and a new sprite sheet. The full version supports several features: keeping separate projects isolated from each other, collecting both built in and custom Codex pets, importing new pets from WebP images, batch importing several animation sets from one message, previewing frames with play and pause controls, adjusting scale, offset, and rotation at the character, animation group, and single frame level, editing collision boxes directly on the canvas, attaching sound effects or extra images to specific frames, and an attack trail mode that draws a continuous motion path across frames using adjustable sticks, colors, and textures. It also syncs the tuned data back into the matching Godot project folder. Both the full Tuner and Frame Tuner Lite run as local web apps started from included Windows batch files, and Lite has its own command line import tools for PNG sequences and sprite sheets. The project stores no character art, audio, or private Godot project data in the repository itself. Setup only requires Node.js, and the maintainers describe running included check and test scripts, plus a validation script for confirming a Godot project is wired up correctly. The tool also checks for and can apply updates from the official GitHub repository. It is released under the MIT license.