[Tool] SMBX Tileset Compiler and Separator

[FrozenQuills]

The version in this topic is outdated, use this one instead.

Hey everyone, you may know me as the random guy that (somehow) got 5th place in the last community contest. After some messing around with SMBX graphics I found out that making changes to entire tilesets is a huge pain!

Thus I made a program to help compile a bunch of graphics into one big image you can edit, and then separate into the correct files later. If there is an easier way to do graphical edits then this was fun to make anyway, lol.

Let's say you want to recolor this tileset:

Spoiler: show

With the compiler, you can compile all your graphics into one big image file that you can edit like this:

Spoiler: show

And then you can separate them all into the original files:

Spoiler: show

This way, not only is it SUPER fast to recolor a tileset, but you also don't have to open a million files to edit a tileset as well!



DOWNLOADS

DOWNLOAD V1.11 (Fixed lightest-color-transparency bug)
DOWNLOAD V1.10 (only works with 64-bit OS)
DOWNLOAD V1.00 (only works with 64-bit OS)
To use this, just extract the folder to somewhere on your computer and follow the instructions in the README.



README

Spoiler: show

=== SMBX TILESET COMPILER/SEPARATOR by FrozenQuills ===

The goal of this package is to provide an easy way to edit numerous individual
graphical files by creating one big image file out of all of them. This joint image can
be recolored/modified efficiently, and then it can be broken back down to the
new graphical files (with the same original filenames and all).


=== Contents ===

This package should include:
- an edit folder
- an output folder
- JoinImages.exe
- SplitImage.exe


=== Instructions ===

1) Place all of the individual graphic files you want to modify all at once in the edit folder
2) Run JoinImages.exe (double click it). It should generate joinedImages.gif outside the edit folder
3) Open joinedImages.gif and make all of your graphical changes there (recolors, edits, etc.)
4) Once you're done, run SplitImage.exe
5) The resulting file graphics from joinedImages.gif should be in the output folder


=== Notes ===

- Ignore imageData.txt: This file is used by the SplitImage.exe and generated by
JoinImages.exe to keep track of the graphic names and heights/widths
in the order they appear in the joint image.

- Whenever you run JoinImages.exe, joinedImages.gif WILL be overwritten by
whatever is in the edit folder, so make sure you save a copy somewhere else if you haven't
run SplitImage.exe yet.

- Likewise, whenever you run SplitImage.exe, graphics in the output folder WILL be replaced by your
changed graphics in joinedImages.gif, so make sure to move them out if you want to use them.

- The edit directory contains a ruins tileset (unknown author) for you to get started (and see
how easy it is to make global recolors and edits).

- You can make super fast global recolors by messing with the hue/saturation in joinImages.gif

- I highly suggest using the recolor tool in Paint.NET in order to do specific color replacements.

- The programs cannot work without the edit or output folders so make sure they exist.

- The background in the joint image is pink in order to differentiate separate tiles.
There is also a 2 pixel buffer between each tile/graphic. Don't worry if you need
to change the background color; it won't affect the individual graphics.

- Contact FrozenQuills on Talkhaus or SMBX forums if you have any bugs or problems with this software.

CHANGELOG

Version 1.11 Changes:
- Should be compatible with 32-bit Windows

Version 1.10 Changes:
- Added PNG support (masks must not be complicated but transparent and semi transparent PNGs are allowed) for Lunalua users
- Two joint image files are now generated, one with all GIFs, and one with all PNGs



Hope people find this useful for editing SMBX graphics! Also feel free to suggest any improvements and whatnot; this is like the first time I released a program like this lol.

[Chip Potato]

Holy shit, this is actually exactly what I've always wanted. Thank you!

[TLtimelord]

If only this was made a week ago...

This is still a godsend. Amazing program you have here!

[FrozenQuills]

Thanks! Glad this is useful

Updated to v1.1

Version 1.1 Changes:
- Added PNG support (masks must not be complicated but transparent and semi transparent PNGs are allowed) for Lunalua users
- Two joint image files are now generated, one with all GIFs, and one with all PNGs

[Liraxus]

This is sexy as huck.

And we're talking Kim Kardashian levels here.

[Alagirez]

now i can recolor any GFX easily. Thanks frozenquills! will download this.

[PixelPest]

Wow. This is downright amazing. Great idea FrozenQuills! Maybe in the future you could find a way to reduce the length of the grouping of tiles, maybe be stacking smaller objects vertically. (Example: If you have a BGO that is 156px high and a block that is 32px high, you could have the program search for other blocks of the same size and stack three more on top.) It would help conserve space and make things even faster. Really like it so far.

[Alagirez]

I can't open it and idk why....
can you help me?

[FrozenQuills]

I can't open it and idk why....
can you help me?

Whoa, that's a weird error. Pyinstaller might have messed up maybe.
Do you have a 32-bit or 64-bit operating system? Also try to see if v1.0 works.

EDIT: after some looking around I think it's because I built the .exes in 64-bit python, so I'll see if I can get 32-bit versions up.

[Alagirez]

Do you have a 32-bit or 64-bit operating system?

32-bit operating system

Also try to see if v1.0 works.

Ok. I'll try it. I hope it works

[h2643]

Oh my god, finally I don't have to recolor >100 graphic images seperately instead I can recolor them all at once! Great program you have here.
Cheers for this!

[FrozenQuills]

Do you have a 32-bit or 64-bit operating system?

32-bit operating system

I think the error is due to the .exe's being built with a 64-bit Python. Try V1.11.

[AirShip]

My... my...

This is certainly the best support tool I've ever seen, very good.

[PersonNamedUser]

This is Great! Now my graphics pack can have more tilesets!

[Lx Xzit]

Amazing! now I can recolor a lot of pieces quickly. Thanks you for the great contribution! it will be very helpful!
A question, Did you consider add a support banner (or whatever) about this for can be more known in the forum?

[FrozenQuills]

Amazing! now I can recolor a lot of pieces quickly. Thanks you for the great contribution! it will be very helpful!
A question, Did you consider add a support banner (or whatever) about this for can be more known in the forum?

I don't have a banner but I do have a link to it in my signature. I didn't expect it to be so popular, hahah; I'll think about making a banner.

[Suckerman7 GM]

This tool looks great for new tileset packs! And I want to ask, which tool in Paint.Net you've used to recolor all the tiles to purple? I just wanted to know.

[HenryRichard]

This is really good, though whenever I join the .gifs together, the first color on the colormap always seems to be replaced with transparency. It's kind of annoying, but it's not too hard for me to fix on my own and it doesn't stop the fact that this program is a massive timesaver. Also, it could just be that I use Gimp instead of paint.net.

[FrozenQuills]

This tool looks great for new tileset packs! And I want to ask, which tool in Paint.Net you've used to recolor all the tiles to purple? I just wanted to know.

Just the Hue/Saturation tool under Adjustments.
And the transparent first color thing is something I haven't heard of before, so I'll look into that.

[Squishy Rex]

This is a great tool so far. It's certainly going to be a big time saver for me. I haven't found anything wrong with the program itself in terms of bugs, so it seems pretty solid. You've brought quite a useful tool to our graphics community FrozenQuills. All I can say is good job and thanks a bunch for making it.