[Script] Export Modular Spritesheets with Nested Tags in Aseprite (for 2D Character Customization)

Scripts & Extensions
1

Hey everyone!

I’m excited to share a free Aseprite script I made for exporting spritesheets. If you’re building 2D games with modular or customizable characters, this is for you!

This script really shines by:

  • Exporting individual modular layers using a deeply nested tag structure.

  • Making it super easy to integrate with character customization systems in Unity. (And a Unity Character Customization System is coming soon!)

  • Letting you quickly export thousands of variations—perfect for complex character customization!

How It Works: Your Folder Structure

The script organizes your exported files into a logical folder structure:

LayerGroup/TagLevel1/TagLevel2/.../Layer.png

Let’s break down what each part means:

  • LayerGroup: These are your character’s body parts like Head, Weapon, Torso, BackLeg, FrontLeg, etc.

  • TagLevel1: This defines a state, such as Idle, Run, or Walk.

  • TagLevel2: Here, you specify the weapon the player is using.

  • TagLevel3: This can be a sub-action, like Weapon/BowShoot/Bow/Raise/Wooden or Weapon/BowShoot/Bow/FollowThrough/Wooden.png

  • Layer: This represents a variation of your Layer Group (e.g., Wooden, Golden, Iron).

Here’s an example:

Weapon/Run/Staff/Loop/Wooden.png

This means you’re looking at a spritesheet for a Wooden Staff, specifically for a Weapon that’s in a Run state, with its animation set to Loop.

Perfect For:

  • Games with deep 2d character customization

  • Projects that require bulk sprite exporting

  • Anyone building modular animation systems

  • Using the output for Dynamic cutscenes, trailers, or VFX composition

If you find it useful, please consider heading over to my GitHub and giving it a star to help motivate me!

GitHub Link: ntd280804/Aseprite-Export-Combinations

I’ve included a format template file for testing and all the requirements to run the script in the wiki on GitHub.

Feel free to leave any suggestions or questions in the comments below. I’m really looking forward to hearing your feedback!

1 Like