Subscribe to download
Custom Painting Loader

A framework to load your own custom pictures as framed paintings.

- Start with the Volcanoids SDK.
- Click "Create new mod".
- Inside the `Data` folder of your mod, right-click and select "Import New Asset".
(You can also just drag/drop a png into it.)
- Select some image file, or some other file Unity can convert into a texture.
- Name the file you import like so: ModPainting_Frame{N}_AnythingGoesHere

The _{N}_ part says exactly which frame type to use:
- 1: Horizontal Frame (Landscape)
- 2: Square Frame
- 3: Vertical Frame (Portrait)

PAINTINGS WILL STRETCH/SKEW TO FIT THE FRAME!
I'll add the aspect ratios when I know them, but they aren't standard so things may be a bit off. Pad images yourself, etc.

Example for the pic in the mod thumbnails/images:

You can put whatever text you want after the second underscore, incl. more underscores.
The text after the second underscore is what's shown as the item name when scrolling through the variants with the wrench.

Now just build and test your mod.
This mod/loader is set to load late so it should always load after default mod load orders. (And thus it should be late in the list.)
Make sure, when you enable your mod and this loader, that the loader is being configured to load after yours.

IF YOU HAVE ANY ISSUES CHECK YOUR GAME'S LOG FIRST.

The game log will have lines like this if all is going as planned:


THE PREVIEW YOU HAVE WHEN PLACING THE DEVICE WILL ALWAYS BE A SOLID COLOR!!!!!!!!!
Known issue, and obnoxious enough to get working in the first place. Probably won't ever be fixed.
You can read the name below in the variant list when placing the device with the wrench. See the pics for an example of what I mean by this.


Lastly, just publish your mod and list this mod as a dependency.

Have fun!


PS: Due to how the game has implemented the whole thing, I had to manually create a whole bunch of placeholder assets for the frame types.
This means there's 31 total pictures you can load for each frame type.
I can add more in the future if needed, but it's kinda a pain so I stopped at 31.
(This also becomes unfeasible as the variant list you see with the wrench does have entries for everything you override, so it's a bit nuts with too many.)