A sprite sheet generator script for Adobe Photoshop
Switch branches/tags
Nothing to show
Clone or download
Latest commit 777c6f7 Apr 27, 2012
Failed to load latest commit information.
README.md Update README.md Apr 27, 2012
SpritePlane.jsx final v1.0 commit Apr 26, 2012


Welcome to SpritePlane v1.0!


SpritePlane is a sprite sheet generator script for Adobe Photoshop that relieves you from many monotonous and time-consuming tasks, such as manually dragging and aligning sprite frames, and makes the generation of sprite sheets a matter of seconds.

So basically what it does is it converts Sprites to Sprite sheets.

I'm an aspiring video game artist, and while working on my latest project me and my team felt the need of an automated solution to generating sprite sheets. Most of the scripts we found online were either stand-alone, with external library dependencies, or lacked the features we were looking for. And so I've decided to develop a script for Photoshop, the tool we're using in our development, and then release it to the public. I sincerely hope that our script will aid you in your development, and improve your sprite workflow.

Questions? Issues? Requests? Found a bug? Just thanks? Hit me up right here in Issues, by email, or on Polycount.

Tested on:

  • Adobe Photoshop CS5 x86-32
  • Adobe Photoshop CS5 x86-64


  • Fast, simple workflow via the automation of repetetive tasks
  • Two layout planning modes: automatic and manual
  • Support for direct Photoshop transparency


  1. Close Photoshop.
  2. Copy the SpritePlane.jsx file to:
    • Windows: C:\Program Files\Adobe\your_photoshop_version\Presets\Scripts
    • Mac: Applications > Your Photoshop Version > Presets > Scripts
  3. Open Photoshop.
  4. The script should now be accessible from the File > Scripts menu.


  1. Open your sprite in Photoshop (imported animated gifs work perfectly and without any tweaks).
  2. The structure of your document must follow several guidelines:
    • There must be no background layer or locked layers.
    • The layers must be arranged in a way that the first frame of your sprite is on Layer 1, the second — on Layer 2 and so on.
    • Layers with applied styles, masks or adjustments must be rasterized or converted to smart objects (rasterization works best).
  3. Run the script from the File > Scripts menu or from the actual SpritePlane.jsx file.
  4. Follow the helpful dialogues to generate the sprite sheet.


  • Nothing here. Yet...

Future plans

  • The reverse (sprite sheet to animated sprite) functionality
  • Less restrictions, more exceptions
  • Alpha channel (indirect transparency) support
  • Proper GUI, with a more user-friendly look
  • More poka-yoke
  • Even more useful features, like instant saving, loading multiple images etc.
  • Cleaner code with more comments
  • A web interface, maybe?

Version history

VersionDateNotes release.


Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.