LogicAtlas CLI is a lightweight, automated Sprite Packer designed to streamline build pipelines by generating texture atlases and JSON data files with embedded logic. This tool simplifies sprite management for developers, enabling efficient packing and integration into game engines or rendering systems.
Key Features:
Shelf Packing Algorithm: Efficiently organizes sprites by height to minimize wasted space.
JSON Data Export: Generates metadata including coordinates, dimensions, and pivot points for precise sprite placement.
Pipeline Integration: Built for CI/CD workflows, batch scripts, and automation.
Zero Dependencies: Runs as a single .exe file, compatible with any Windows machine.
Audience & Benefit:
Ideal for game developers, UI designers, and technical artists working on 2D projects. LogicAtlas CLI streamlines sprite management by automating texture atlas generation and metadata export, reducing manual effort and errors in build pipelines. It can be installed via winget for easy integration into development environments.
This tool enhances efficiency in game development workflows, ensuring sprites are packed optimally and ready for use in engines like Godot or custom rendering systems.
README
LogicAtlas (Core CLI)
A lightweight, automated Sprite Packer for build pipelines.
Generates texture atlases and JSON data files with embedded logic.
āØ Want visuals? Drag-and-drop? Visual Pivot Editing?
š Get LogicAtlas PRO on Itch.io (The Pro version includes a GUI, visual anchor editing, and individual sprite settings)
š Features
Shelf Packing Algorithm: Efficiently packs sprites by height.
JSON Data Export: Includes coordinates, dimensions, and pivot logic.
Pipeline Ready: Designed for CI/CD, batch scripts, and automation.
Zero Dependencies: Single .exe, runs on any Windows machine.
š» Usage
LogicAtlas-CLI.exe [Flags]
Flags
-o Output filename (default: atlas)
--padding Pixel padding between sprites (default: 2)
--pivot Global pivot setting (Default: C)
Pivot Modes:
C : Center (0.5, 0.5)
TL: Top-Left (0.0, 0.0)
BC: Bottom-Center (0.5, 1.0) - Great for characters
Example
To pack a folder of RPG characters with Bottom-Center pivots (for feet alignment):
code Bash
LogicAtlas-CLI.exe "./Sprites/Characters" -o Chars --pivot BC
š¦ Integration (Godot Example)
The tool outputs a standard JSON. Parse it to set up your sprites automatically.
code Gdscript
Godot 4.x
var data = JSON.parse_string(json_text)
$Sprite2D.region_rect = Rect2(data.x, data.y, data.w, data.h)
$Sprite2D.offset = Vector2(data.w * data.pivot_x, data.h * data.pivot_y)