A downloadable Script

Download NowName your own price
⚠️ Requires Aseprite 1.2.10 Beta 2 (or newer)
Read here how to install Beta version

This script lets you create boxes of various sizes in Aseprite.

You can set a custom color for each of the sides, set a highlight and stroke color. You can also choose between two types of the corners: 2px and 3px. You can read more about the differences here.

There are two versions of the script: Regular and Lite. Lite version generates a stroke only boxes, intended for quick prototyping with basic wired box without any colors. Using Regular version you can set a custom color for each of the sides of the box. By default it will generate shades of your current foreground color.


  • Custom X, Y and Z size of the box
  • Custom colors for Stroke, Highlight and each side of the box
  • Two types of the corners: 2px and 3px (Read more)
  • Optional Lite version of the script with a basic wired box for quick prototyping


Known issues:

Currently, Regular version of the script has some limitations of the box size. It is somewhere in the range of 30×30×30 but may vary. For example, you can have a box of 10×40×30 or 5×40×35 etc. Just try to mix and match different dimensions.

As far as I know, Lite version doesn't have this issue. Hopefully, I'll be able to fix this limitation in future updates.


  1. Open Aseprite
  2. Go to File → Scripts → Open Scripts Folder
  3. Place downloaded LUA files into previously opened directory
  4. Restart Aseprite

You will find installed scripts under File → Scripts menu. You can add shortcuts to each script under Edit → Keyboard Shortcuts (Read more)

You can also create a separate folder for these scripts for better organization (Read more)

Special thanks to @davidcapello for giving tips on how to improve the code 🙌


Download NowName your own price

Click download now to get access to the following files:

[KAM] Isometric Box Scripts (Regular + Lite versions) 10 kB


Log in with itch.io to leave a comment.

hi! i have a small problem, when i go on file on aseprite to find the scripts folder thing, it isnt there so i don't know how to access the script itself. i'm big confused :/

Please make sure you have installed Aseprite Beta: https://www.aseprite.org/beta

This was quite useful. If you set up a git repo for this, I'd be happy to pull request along some of my additions. In my version I needed bigger cubes so I rewrote your recursive implementation of floodfill to use a loop and a queue to speed up performance and allow it to go past the limits of the C stack for size (I was capping at about 30x30x30 pixels).

(1 edit)

Ooh! This is awesome! I will set up a repo and send the link to you. Thanks!

Repo is up: https://github.com/darkwark/isobox-for-aseprite

Thanks! Pull request has been placed.

Great! Thank you! I'll do some code clean up and release updated version!
Do you have a Twitter account or something like that, so I could mention you in the description?

Sure, @AimlessZealot

Great stuff, thanks! 

I was poking around in the script (the normal one not the lite one), and was wondering whether it would be better to replace the undo/redo command  for refreshing the screen at line 286 - 287  with a single call to the Refresh command. Not sure if one way is better than the other, but I did find that the undo/redo calls didnt always work in my own scripts, while refresh seemed to work every time.

I believe these lines were added by @davidcapello as a temporary solution, because app.refresh() didn't work correctly with my script on Windows in the Beta 2 or something like that. But it was probably already fixed in the latest Beta releases


Thanks man!

Looks so cool, nice one!

Thanks :)

this is not for windows right?

(1 edit)

This script is for Aseprite. It is available on Windows, macOS and Linux.

This is amazing! :D Great work!


It's beautiful, I can't wait to use this.

Hope you'll find it useful :)

The asesprite beta crashes immediately for me T_T I still have to troubleshoot. Maybe it's possible to fix?

I'm only able to use Asesprite by using the existing release.

I've heard people had some crash issues on Windows 10 because of the wrong beta branch. Make sure you have selected branch called beta - Beta version - Preview features in Steam. 



Nice! Definitely my favorite script so far ^-^