This document describes using the PSD (Photoshop file format) Auto-Layout python script to assist you in laying out character layer regions exported out from a PSD framework like Photoshop.

Video Tutorial

Using Creature's built in Image Packer, basic and easy option:


Exporting data via Texture Packer, advanced option:



Python - You need this installed on your system. Here is a guide on how to install python on Windows. By default, python is already installed on Mac OSX machines. Once that is installed, setup the following:

  • psd.py Script. Grab it from here

  • layerExport.py Script. Grab it from here

  • psdGUI.py Script. Grab it from here

  • psd-Tools Python package. Instructions to install here

  • Pillow Python package. Instructions to install here

  • EasyGui Python package. Instructions to install here

  • TexturePacker Instructions to install here You only need this if you pick the advanced option.

Python Package installation Tip: In general if you have the PIP setup for python, installing the above python packages is very easy.

For example, to install EasyGui, you would simply type:

pip install easygui

at the command prompt/terminal.


  1. Make sure you install Pillow, EasyGui and TexturePacker python packages.
  2. After that, copy psd.py, layerExport.py and psdGUI.py into a directory of your choice

Start out your command prompt/terminal program from that directory in order to run the scripts.

Export with Gui


There is now a gui script to aid you in your PSD export. Just type at the command prompt:

python psdGUI.py

and it will take you through Phase 1 and Phase 2. Please read through the writeups below however to understand how the process works.

Phase 1

Run layerExport.py:

python layerExport.py <Source PSD> <Output Folder>

This will generate PNG files per layer into your specified Output Folder from your Source PSD file. These files will be brought into TexturePacker.

Phase 2

Run psd.py:

python psd.py <Source PSD> <Output JSON>

This will generate an output json file from your Source PSD file.

Phase 3

  1. Run TexturePacker (Remember to check DISALLOW ROTATION)

  2. Drag in the sprites generated from Phase 1

  3. Make sure your export format is set to JSON ARRAY

  4. Make sure you give enough padding for your images in your layout

  5. Export out the packed PNG and json file

Phase 4

  1. Enter Mesh Mode in Creature

  2. Import the packed PNG file from Phase 3

  3. Click Tools->Create Texture Regions from Layout JSON...

  4. Select the TexturePacker json file from Phase 3

  5. You should see your texture region meshes automatically renamed

Phase 5

  1. Enter Rig Mode in Creature

  2. Click on the menu Rig->Create Regions from Layout JSON...

  3. Select your Output JSON from Phase 2. Make sure al the layout regions are listed in the window and click OK

You should see Creature automatically create the appropriate layer region meshes and place them in approximately the correct positions.