Docs
Mod developer docs
Developer documentation for my mods, in both games. Pick the one you are modding.
Put your own upgrades in my upgrade tree
Both games have one: Tech Tree in Supermarket Simulator and Mega Tree in Megastore Simulator. Both let any BepInEx mod register its own upgrade lines, through the same API - you describe the node and write the effect, the tree draws it, prices it, gates it, saves it per slot and translates it.
The two games are not interchangeable
This is the first thing to get right, and the most common reason a mod loads in one game and does absolutely nothing in the other. The API is the same; the platform underneath is not.
| Supermarket Simulator | Megastore Simulator | |
|---|---|---|
| Runtime | IL2CPP | Mono |
| BepInEx | 6 | 5 |
| Plugin base | BasePlugin + Load() | BaseUnityPlugin + Awake() |
| Target framework | net6.0 | netstandard2.1 |
| Game assemblies | BepInEx/interop/ | ..._Data/Managed/ |
| Il2CppInterop | required | does not exist |
| The tree | Tech Tree | Mega Tree |
A dll built for one never loads in the other, even when the names match. If you already shipped for one game, the project setup page is where the port starts - the registration code itself barely changes.
Every mod
Supermarket Simulator
The mods I have been building the longest. Tech Tree is the one others plug into. Mods here need BepInEx 6 (IL2CPP).
| Mod | What it does | Docs |
|---|---|---|
| Tech Tree | Register your own upgrade nodes in the Tech Tree. You describe the node and write the effect; Tech Tree handles the interface, buying, saving and translation. |
Read the docs
Nexus |
| Tips System | Customers leave a tip when they are happy with the service, paid on the completed sale and summed up in the end-of-day screen. | soon |
| Custom Intro | Replaces the game intro with your own images and sound, configured in a single intro.jsonc. | soon |
| Demand System | A daily demand mechanic: some days a few products get unusually popular and customers buy extra units of them, so stocking takes a little planning. | soon |
| Footfall | Shoe prints on the shop floor as you walk around, fading away on their own. Purely cosmetic - nothing is saved and no gameplay changes. | soon |
Megastore Simulator
The second game. Mono instead of IL2CPP, which changes how every mod here is built. Mods here need BepInEx 5 (Mono).
| Mod | What it does | Docs |
|---|---|---|
| Mega Tree | Register your own upgrade nodes in the Mega Tree. Same API as Tech Tree, built for Mono - you describe the node and write the effect, Mega Tree handles the interface, buying, saving and translation. |
Read the docs
Nexus |
| Mega UI | Put your own app on the store computer. You describe the screen top to bottom and Mega UI does the icon, the window, the taskbar tab and the layout - no world-space maths, no RectTransform. | Read the docs |
Are you a player, not a modder?
Then none of this is for you, and that is fine. These pages are about writing mods that plug into mine. If you just want to install and play, everything you need is on the mod page:
Tech Tree on Nexus Mods →
Mega Tree on Nexus Mods →
Reporting something
The Posts tab of the mod on Nexus is the fastest way to reach me. If it is about the API,
include the [api] lines from
BepInEx/LogOutput.log - they almost always name the cause.