GBC Limitation Tools

Aseprite Lua scripts that help manage Game Boy Color hardware limitations (palettes, tile patterns, sprite layering, etc.).

Made specifically for creating assets for GBC games in GB Studio, but useful for any GBC development workflow.

AI disclosure: Claude was used to help clean up and document the code.

Tools

GBC Tile Tool - For backgrounds, tilesets, and standard GBC assets

• Counts and merges compatible palettes
• Counts unique tile patterns (color-agnostic)
• Analyzes image layers and tilemaps
• Warns when tiles exceed 4 colors with exact coordinates
• Exports palettes in GPL format

GBC Actor Tool - For GB Studio actors with 4+ colors

• Analyzes 8x8 tiles and counts colors per tile
• Optimizes palette usage across all tiles
• Exports layered sprites separated by palette
• Warns when exceeding 8 palettes (GB Studio limit)
• Safety limit at 32 palettes 

Future Plans

Only if requested or needed:

• Attribute map generator for GBDK
• Individual palette export
• Duplicate tile pattern detection
• GBC 15-bit color validation
• Advanced sprite layer analysis