Tobey's BepInEx Pack for Supermarket Simulator

Download Mod


About this mod

A BepInEx pack for Supermarket Simulator, preconfigured and ready to use on Windows and Linux, including SteamOS and Steam Deck handhelds!

This is a BepInEx pack for Supermarket Simulator, preconfigured and ready to use on Windows and Linux, including SteamOS and Steam Deck handhelds!

💬 Important

As of Supermarket Simulator v1.1 (the co-op update), MelonLoader compatibility is no longer supported by this pack.

The Supermarket Simulator co-op update (v1.1) made many significant changes to the game which collectively have rendered all mods broken.


All mods containing .dll files need to be updated to work with the new changes to the game. That includes all BepInEx and MelonLoader mods. If a mod has not been updated since the co-op update came out on 8th October 2025, it simply will not work.


 As such, we have made the decision to drop MelonLoader support since the majority of active Supermarket Simulator mod developers are using BepInEx to make and maintain their mods, and the magic glue we previously used to load MelonLoader mods with BepInEx does not support the latest IL2CPP game builds.


If you are a MelonLoader mod developer, I humbly request that you please consider migrating to BepInEx moving forward - users will no longer be able to use both at the same time.


Installation

💡Tip

Make sure to check out the "Installing mods" section below once you have finished installing this pack!


💡Tip

The game folder is the folder containing the game's executable (e.g. Supermarket Simulator.exe).

Steam users can find this folder by right-clicking the game in their library and selecting Manage > Browse local files.

PC Game Pass users can find this folder by right-clicking the game in their library, selecting Manage, navigating to the Files tab, clicking Browse... and finally navigating into the Supermarket Simulator > Content folder.

Quick Start for Windows


Extract the archive into the game folder replacing any files if prompted, run the game once to prepare the game for modding (can take a while and requires internet access), then quit the game at the main menu and you're good to go. Remember to check the "Installing mods" section below for info on how to install mods!


If something doesn't go according to plan or you need further guidance, please refer to the full instructions below. Don't worry, it looks harder than it is. Please don't skimread!



Quick Start for Linux and Steam Deck handhelds


Same as for Windows but additionally follow step 4 from the full instructions below.


For Steam Deck handhelds, switch to Desktop mode to follow the instructions. Once you've got it all working, you'll be able to play with mods in either Desktop or Gaming mode as preferred.


Sorry macOS users...



💬 Important

As of Supermarket Simulator v1.1 (the co-op update), macOS is no longer directly supported by this pack.

Sadly, after much testing, I have not been able to find a way to get mods to load with the native macOS copy of the game with this update. While BepInEx and MelonLoader do both have IL2CPP builds for macOS, neither seem to work with this game. I have discussed with some of the maintainers of these mod loaders and at this time it seems that it is an issue that will not be resolved for the foreseeable future.


This means that unfortunately, if you're playing a macOS copy of the game, you're out of luck.


That said, you may find some success if you are willing to use tools like CrossOver or HyperPlay to install a Windows copy of Steam and the game, and configure your bottle with the environment variable WINEDLLOVERRIDES="winhttp=n,b" or to modify its Wine Configuration to add winhttp as an override in the Libraries tab. Please note that I offer no support for this.


Full instructions for Windows, Linux and Steam Deck handhelds



💡Tip

The game folder is the folder containing the game's executable (e.g. Supermarket Simulator.exe).

Steam users can find this folder by right-clicking the game in their library and selecting Manage > Browse local files.

PC Game Pass users can find this folder by right-clicking the game in their library, selecting Manage, navigating to the Files tab, clicking Browse... and finally navigating into the Supermarket Simulator > Content folder.

1. Download Tobey's BepInEx Pack for Supermarket Simulator from the Files tab.


2. Make sure the game is not running.


3. Extract the contents of the downloaded archive into the game folder. Replace any files if prompted.


ℹ️That just means open the .zip file (e.g. double click it) and drag-and-drop the files and folders into the game folder!


If done correctly, inside your game folder it should look something like this:


⚠️ This list is used as a reference and is non-exhaustive, there will be other stuff, please don't delete anything!


  • BepInEx
  • dotnet
  • Supermarket Simulator_Data
  • baselib.dll
  • doorstop_config.ini
  • GameAssembly.dll
  • Supermarket Simulator.exe
  • winhttp.dll

⚠️ If you are missing any of these files or folders, you are probably installing to the wrong place, and this pack will not work.


4. Skip this step if you play on Windows!


Linux and Steam Deck handheld users: go to your Steam library, right-click the game, select Properties... and set the launch options:


WINEDLLOVERRIDES="winhttp=n,b" %command%


⚠️ Do not set the launch options if you play the game on Windows!


ℹ️If preferred, Linux users can instead set the Wine configuration (winecfg) for the game to add winhttp as a DLL override via the Libraries tab. Remove the launch options if applicable. Full instructions here.

5. Run the game from Steam as normal.


On first launch after installing this pack, it may take a while to load and you will not see any indication that anything is happening.


This is normal, be patient and wait - BepInEx is doing work in the background to prepare the game for modding. This process will be much faster on subsequent launches of the game, although the "first launch" process may repeat whenever the game updates.


6. Exit the game at the main menu.


Assuming you have followed these instructions correctly, inside the BepInEx folder there will now be a file LogOutput.log (or simply LogOutput - it's the same thing). This is your log file, and it will be regenerated every time the game runs with technical and diagnostic information about your installed mods. It's very useful for troubleshooting, and it is recommended to share it whenever asking for help with your mods. It is equivalent to the console window you might be familiar with, containing all of the same information.


If this file is missing, it usually means that you have not installed the pack correctly and you should probably try again from scratch. Make sure to pay careful attention to the instructions and don't skimread any of the steps.

 

Otherwise, you can now install mods according to the section below.


💬 Important

With just this pack installed, you will not see any changes in-game!

Check the file BepInEx > LogOuput.log to determine whether BepInEx has loaded.

Installing mods


💬 Important

Always make sure the game is not running when installing, removing, or otherwise changing mod files!

⚠️Warning[/b]

If a mod tells you to install MelonLoader, it is incompatible with this pack!

Since v1.1 of Supermarket Simulator, MelonLoader is no longer compatible with BepInEx, which means that mods made for MelonLoader are incompatible with mods made for BepInEx. Moving forward, we hope that all mod authors for Supermarket Simulator will migrate to BepInEx, which the majority are already using.

If you do choose to install MelonLoader, be aware that any BepInEx mods you have installed will stop working until you uninstall MelonLoader.

Installing BepInEx mods is generally as simple as opening up their .zip file and dragging their contents into the right folder.


Typically, that folder is BepInEx > plugins, unless the mod's instructions say otherwise.


There may be exceptions to this basic rule, so please do make sure to read the instructions of each mod you download - but remember that if a mod specifies that it requires MelonLoader, it is not compatible with this pack, and if you install MelonLoader then any mods you have installed for BepInEx will stop working until you uninstall MelonLoader.


If you still can't figure out how to install a mod, double check and follow the instructions on the mod page. If there aren't any instructions or you simply don't understand them, you'll have to get in touch with the mod author somehow. Your best bet is usually going to be the posts tab of that mod. Make sure to check that the question hasn't already been asked and answered!