Empress ShopLoaderAPI v1.1.4
A developer-focused API for R.E.P.O. that simplifies custom shop loading with automatic networking, RNG selection, and BepInEx config integration.
Message to my awesome friends and the players who use my mods.
- I was banned from the REPO modding server when I was taking a temp leave from the server due to drama. I was not even in the server when the ban happened. As such, if you need support for my mods or just want to hang out join my new personal server on Discord: https://discord.gg/QXDj8hrdRc
Developers Only: This is an API for loading your custom shops. You still need to create your own shop Prefab. This API handles the loading, networking, and integration for you.
Features & Configuration
- Automatic Config Generation: My API automatically generates a configuration entry for ALL shops that use it. Users can find these under
[Registered Shops] in the com.Empress.ShopAPI.cfg file.
- Built-in RNG Failsafe: To prevent game-breaking overlaps, my API ensures only one custom shop is loaded per level. If multiple shops are enabled, the API uses Random Number Generation to select one.
- Seamless Integration: My API automatically injects your shop into the
LevelGenerator and handles the ResourceCache for both singleplayer and multiplayer pools.
For Developers
⚠️ Critical Requirement: The Truck, Spawn Points, & Screens
Since version 1.1.0, this API overrides the default Shop Start Room. Because of this, you must follow these rules to prevent the game from crashing:
- Use the Module Shop as your Base: When creating your shop, use the Module Shop prefab as your foundation. It contains the working shop interior, extractor components, items ect.
- COPY THE TRUCK: The Module Shop prefab does not include a truck by default. You MUST open a standard Shop Start Room, copy the Truck parent object, and paste it into your custom shop prefab.
- Why? The Truck handles the game's Spawn Points, Truck Screens, and critical level logic. If you do not have the Truck object in your prefab, the game will find zero spawn points and crash.
Implementation Guide
- **Add EmpressShopAPI.dll as a reference