Please note this is an alpha software. Use in production at your own risk!
The purpose of this package is to give robust, solid and production-ready way to create spritesheets from a bunch of bitmap images. It is written in pure Javascript and has no native dependencies.
It can be used as a standalone command-line tool (which is useful for development and CI environments) and as a Node.js module (in case your building toolchain includes some JS code).
This package is intended as a replacement for some commercial packages and is meant to be easy to use, pluggable and open-source.
It takes a bunch of image files, packs them into a single texture (called a spritesheet) and provides the metadata for the game engine of choice.
Basically spritesheet-creator supports every image format supported by jimp library. For the metadata currently the following output formats are supported:
- Godot 3
Work in progress:
- cocos2d-x
- Unity
To install as a CLI tool:
yarn global add spritesheet-creator
Then you can generate some spritesheets for Godot! Just do:
spritesheet-creator generate_spritesheet godot3 <target_texture> <target_meta_folder> <paths to source files>... --project-root <godot_project_root>
Please note, that target paths must be inside <godot_project_root> for the tool to properly generate Godot-specific res:// paths.
In a few seconds you will (hopefully) get a large texture and a bunch of .tres files. You can use them right out of the box as a replacement for the stand-alone sprites.
This will dramatically increase the performance of the large scenes due to the batch draw call optimisation and zero texture switching.
Options:
--sort-method [height,width,area,maxside]
Before packing sprites are sorted by of these algorithms.
--pack-algorithm [binpacking,growing-binpacking,horizontal,vertical]
The algorithm to pack sprites. Highly recommended to use the default growing-binpacking one.
--width <width> --height <height>
The width and height of the texture for binpacking algorithm.