LoginRegister

Shapez 2 Custom Scenario Installation Guide

Follow these steps to install your custom scenario in shapez 2 and troubleshoot any issues.

How to Install Your Scenario

Step 1: Download Both Files

When exporting your scenario, you need to download both files:

  • Scenario file - The main scenario data
  • Parameter preset file - The scenario configuration

Step 2: Place Files in Correct Folders

Navigate to your shapez 2 data folder and place the files as follows:

If the folders do not exist, create them.

Scenario file:

%userprofile%\AppData\LocalLow\tobspr Games\shapez 2\custom-scenarios\

Parameter preset file:

%userprofile%\AppData\LocalLow\tobspr Games\shapez 2\custom-scenario-parameter-presets\

Step 3: Finding Your Scenario in Game

After placing both files in the correct folders:

  1. Start shapez 2
  2. Click "New Game"
  3. Your custom scenario will appear to the right of the default game modes

Troubleshooting

Scenario Not Visible?

If your scenario doesn't appear in the game, check the log file for errors:

  1. Open the same folder where you placed the scenario files %appdata%/LocalLow/tobspr Games/shapez 2/
  2. Look for a file called Player.log
  3. Open the log file with any text editor and search for "Failed to load custom scenario"
  4. Make sure you are looking at the correct scenario (you could have multiple errors)
  5. Check the error message to understand what went wrong
  6. There is often a line and a position indicated, showing where exactly in the scenario file the problematic part is

Common Issues

  • Wrong folder: Double-check the folder paths are correct
  • Scenario is present but difficulty can not be chosen: Happens when you don't have a parameter preset file for your scenario. Make sure you download BOTH files and put them into correct folders.
  • Wrong FormatVersion: Happens when you minified the JSON. To avoid this issue we don't minify the JSON. Game expects it to be "FormatVersion": 2, with a space between colon and the number ¯\_(ツ)_/¯
  • Wrong JSON encoding of arrays or objects: Some configurations require object {} and some array []. Using the wrong one will cause an error.

Is it safe to install custom scenarios?

Ability to add custom scenarios is a feature of Shapez 2, provided by game developers and hence should not pose any risks. Those scenarios also don't affect the core game, so should not "break" anything. You can always remove them and related save files.

As with any files downloaded from the internet, you should always exercise caution and verify what you're installing. Here's what you need to know about scenario files:

  • Always check the file extension - scenario files should have a .json extension
  • Scenario files are plain JSON text files that you can safely open and inspect using any text editor or online JSON viewer. JSON is an open standard that uses human-readable text to store and transmit data
  • These files are "static" (not executable) configuration files that only contain game settings and level data