Skip to content
This repository was archived by the owner on Apr 24, 2026. It is now read-only.

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 16 Feb 00:22
· 38 commits to main since this release

Added

  • import command: convert images (any format Pillow can read: PNG, BMP, GIF, TIFF, WebP, JPEG, PSD, and more) into grid.txt + palette.txt format. Three modes: single image, single tile from tilesheet, and whole tilesheet split into individual sprites. Supports atlas index.json for named sprite extraction with metadata.
  • tag command: interactive tileset tagger for labeling tiles in existing spritesheet PNGs (gridfab tag <tileset.png>). Keyboard-driven workflow with AI-assisted name/description generation via Claude Code CLI.
  • gridfab-tagger standalone entry point (same as gridfab tag, available as independent binary in release builds)
  • Tagger tile_type field: auto-fills from active tags (single tag = tag name, multiple = "multi")
  • Tagger empty tile persistence: user-marked and auto-detected empty tiles saved as merged rectangles across sessions
  • Tagger duplicate name detection with status bar notification
  • atlas command: pack multiple sprites into a spritesheet with multi-tile support, stable ordering via index.json, glob-based sprite discovery, and configurable tile size/columns
  • atlas --atlas-name and --index-name flags for custom output filenames
  • Atlas index semantic fields: description, tags, and tile_type per sprite for LLM/game engine discoverability
  • GUI palette editing: add colors via color picker, edit by double-clicking, remove via right-click menu, copy hex to clipboard
  • GUI multi-column swatch grid with contrast-aware text labels
  • GUI "Open" button to browse and open existing sprite folders
  • GUI "Import" button to import images into new sprite folders
  • GUI enhanced "New" button with choice between resize and new sprite
  • GUI action buttons in 2-column grid layout

Changed

  • Reworked tagger default tags to broader categories (prop, equipment, terrain, hazard, path, etc.)
  • Tagger AI feedback mode: @: prefix triggers fresh AI-generated results

Fixed

  • GUI Refresh button now rebuilds palette sidebar, so external palette changes appear after refresh

Full Changelog: v0.2.0...v0.3.0