Skip to content
Geoffrey Benson edited this page Dec 12, 2013 · 8 revisions

sprite-magic

A tool for making and sharing game-ready spritesheets. Comes with a library of free sprites!

This software is in pre-release, though it's probably getting good enough to actually use now. If you're just looking to get down to business and have an easy-to-use, battle-tested program, be sure to check back later once the dust has settled a bit.

A pre-packaged Windows executable is available via the releases page; a Mac OS package will come eventually. If you want to run from source, you'll need: Python 2.7, NumPy, and PIL. New features, bugfixes, documentation, and art + spec contributions are welcome!

What is this?

Sprite Magic has two purposes:

  • To provide a tool which can bridge the gap between paperdoll-style artwork and game-ready spritesheets.
  • To provide a library of free (libre) artwork which can be used in a game.

As a bonus, Sprite Magic can easily be used by artists to preview animations when creating sprites.

How do I run this?

For Windows: Extract the .zip file from the releases page wherever you like. Run sprite_magic.exe.

Elsewhere: Check out the repo, then: $ python sprite_magic.py

(A MacOS packaged version will be coming eventually.)

How do I use artwork with this?

You'll need the following pieces in place:

  • A folder under assets/ to group together artwork which shares a common format and base artwork (known as a "type"). Name it whatever you like.
  • A .spec file defining that type
  • Some artwork spritesheet files inside that folder. Anything in RGB with an alpha channel should work (tested with transparent .PNG's)
  • One or more .spec files specifying where the various frames can be found on the sheet.

That's it! Reload Sprite Magic and start playing around!

What's not yet complete?

Among the things that are still on tap to implement:

  • Fixed-palette variations generation (automated palette-swapping)
  • More prettification of the UI
  • Bugfixes galore
  • Wizards to help with creating .spec files
  • A built-in sprite editor, maybe?
  • More artwork!

A word about licensing...

The GPLv3 only applies to the code for this project itself. Free artwork provided on this project has a variety of licenses and attribution requirements, including: CC0 public domain, GPL, Creative Commons, and others. Please check the individual art directories for licensing and attribution.