Installing mods

1. Back up any saves you care about. Often. Using mods has a possibility of corrupting a save, especially if you add or remove mods from an existing save.

2. Download the mods that you want to play. You can find most mods on mod.io or here. Don't go overboard, the more mods you install the more likely something won't be compatible.
3. Find the JS file you just downloaded. If using mod.io, open the downloaded ZIP file to find the JS file.

4. Run the standalone game. Usually this will be through Steam.
5. Starting from the main menu, follow the purple buttons to the mod folder.

6. Drag the JS file from step 3 into the mod folder. It must be directly inside the folder, if it is in a deeper folder or still in the ZIP, it will not be found.

7. Restart the game.
8. If you've done everything correctly, the mod should show up in the mods list.

FAQ

I don't see the mod in the mod list!

Make sure you followed the instructions.

I launched the game and it gave an error!

There's a mod that doesn't work. Find which mod doesn't appear in the mod list & remove it.

The game crashed!

Do the same thing again, see if you can get it to crash the same way. Start removing mods and try to make it crash again. Maybe a mod is incompatible with other mods you have installed?

I can't load my save!

I told you to backup your saves... but you can also try WhoCares, it might fix something

I think I found a bug!

See if you can figure out what mod is causing it, let the developer for that mod know in #mod-feedback on the shapez Discord.

Can I turn off a mod?

Not really, but you could just move it out of the /mods directory. I just have a /mods/disabled directory I use to move them out of the way. Or, check out dengr1065's launcher that lets you toggle mods and even group them for quick switching.