Pixel Tools

A set of CLI tools for building pixel art asset pipelines for games, with first-class support for the Phaser game engine. Full source code is available on GitHub under MIT license.

Overview

• Atlaspack — Packs multiple PNG images into a single optimized texture atlas with support for nineslice and spritesheets
• Fontpack — Creates packed texture atlases and BMFont descriptor files from pixel art font sheets
• Tilepack — Repacks and optimizes Tiled map files (TMX) and their tilesets, outputting Phaser-compatible JSON tilemaps
• Recolor — Converts image colors using a color lookup table (LUT) built from example image pairs

All tools are written in Go and distributed as standalone binaries. They are also available as an npm package with an included Vite plugin for automatic asset processing during development and production builds.

Installation

Manually from release archive

1. Download the latest release archive for your platform (Windows, Linux, or macOS) from itch.io or the GitHub releases page.
2. Extract the archive to a folder of your choice.
3. Add the folder containing the binaries to your system's PATH to use them from any directory.

Using npm

npm install --save-dev pixel-tools 

For an example of integration into build pipeline with Vite, including configuring dev environment with hot reload, see the phaser-example folder in the repository.

Terms of use

Code

All tools are free to download, use, modify, and redistribute for any purpose, including commercial projects. Full source code is available on GitHub under the MIT license.

Example art assets

Example assets included in this repository were created by Gabriel Lima aka tiopalada, with small modifications by me. Big thanks to him for creating beautiful pixel art and putting it into the public domain. His work is licensed partially under CC0 1.0 Universal, and partially under CC BY 4.0, for details please see LICENSE files in corresponding example folders.