Idiot's guide to macOS installation - toebeann/BepInEx.SupermarketSimulator GitHub Wiki

This guide was written for macOS Sequoia. The instructions below should still work for other versions of macOS, but there may be some slight differences.

If you run into any unexpected issues while following this guide, join the Modded Supermarket Simulator discord server and send a message in the #general-support channel describing your problem. Make sure to mention you were following this guide and what step you got stuck on, and I or someone else will help you out.

Automated Installation with gib

By far the easiest, most foolproof way to get BepInEx working for Supermarket Simulator is to to use gib (tobey's Guided Installer for BepInEx).

Simply download Tobey's BepInEx x MelonLoader Pack for Supermarket Simulator, then follow the instructions in the gib README to get BepInEx up and running.

Manual Installation

If you're a glutton for punishment, follow these instructions to install manually:

Step one is to download BepInEx and put the files in your Supermarket Simulator installation folder:
1. Download Tobey's BepInEx x MelonLoader Pack for Supermarket Simulator. You can get this either from the Files tab on Nexus Mods, or here on GitHub, whichever you prefer.
2. Find Supermarket Simulator in your Steam library, then right-click it and choose Manage -> Browse local files.
3. Move the contents of the BepInEx archive you downloaded into the Supermarket Simulator folder.
  
  ⚠️ The contents of the archive are the files and folders inside the outer folder generated when you/Safari unzipped the downloaded archive. You want those inner files and folders (run_bepinex.sh etc.) directly in the game folder like the below screenshot! Getting this wrong may result in some mods failing to work properly!
  
  ℹ️ The contents of the archive may have changed since this screenshot was taken - make sure to move all files and folders from inside the downloaded archive into the folder, whether they appear in this screenshot or not. However, the run_bepinex.sh file should always be here - in the same folder as the Contents or Supermarket Simulator_Data folder - as it is integral to this guide.
For step two, we need to make the run_bepinex.sh file executable, as this shell script is how we will launch the game with mods:
1. Open Terminal from Launchpad by pressing Command Space, typing terminal and pressing enter.
  
  ℹ️ This guide hasn't been tested with iTerm2 or other terminal apps. Use the standard terminal if you have problems.
2. In the Terminal window, type the following command followed by a Space. Don't press enter yet!
```
chmod u+x 
```
  ⚠️ The Space after the u+x is important! Better to have too many spaces than not enough 😄
3. Now, drag the run_bepinex.sh file from your Supermerkat Simulator folder into the Terminal window:
4. Press enter to run the command:
  
  ℹ️ It's normal for there to be no output after running the command. If you get output, it probably means you did something wrong. Check that you have a Space after the u+x and before the path to run_bepinex.sh, like in the screenshot above.
5. You can now close the Terminal window.
Step three is telling Steam to launch the game via the run_bepinex.sh script:
1. Back in the Finder window of your Supermarket Simulator folder, right-click the run_bepinex.sh file, and holding the Option key, click Copy "run_bepinex.sh" as Pathname.
  
  Your clipboard should now contain the full path to the run_bepinex.sh script in your Supermarket Simulator folder when you paste it with Command V. For example, on my machine it looks like this:
  
  '/Users/toebean/Library/Application Support/Steam/steamapps/common/Supermarket Simulator/run_bepinex.sh'
2. In your Steam library, right-click Supermarket Simulator and this time choose Properties... from the menu.
3. In the General tab (or the Shortcut tab if you have added Supermarket Simulator as a non-Steam game), set your launch options like this, replacing <PASTE THE PATHNAME HERE> with the pathname you just copied:
```
<PASTE THE PATHNAME HERE> %command%
```
Run the game via Steam.

If Steam says the game is launching forever but it never actually loads, follow these steps:
1. Open a Terminal window in the game folder (navigate to the game folder as before via Manage -> Browse local files..., hold Option, at the bottom right of the Finder window right-click Supermarket Simulator and click New Terminal at Folder).
2. Paste the following command:
```
./run_bepinex.sh
```
3. You should now be able to continue by following the below steps. You'll probably need to quit Steam (Command Q) to run the game again.
If you see a prompt warning you that libdoorstop.dylib cannot be opened, follow these steps:
1. Click Done (you may need to do this multiple times) and Ignore any warnings about Supermarket Simulator failing to run.
2. Open System Preferences.
3. Go to Privacy & Security.
4. Towards the bottom you should see a message saying that libdoorstop.dylib was blocked. Click Allow Anyway and confirm any prompts that pop up.
5. Run the game via Steam, confirming any prompts that pop up.
On the other hand, in some instances Steam may just say that the game is launching forever but never actually load. To remedy this:

At this point, assuming the game opens as normal, you're done! BepInEx is installed! You're ready to go wild installing mods. Have fun!

If you ran into any unexpected issues while following this guide, join the Modded Supermarket Simulator discord server and send a message in the #general-support channels describing your problem. Make sure to mention you were following this guide and what step you got stuck on, and I or someone else will help you out.