Empress ShopLoaderAPI v1.1.0

A developer-focused API for R.E.P.O. that simplifies custom shop loading with automatic networking, RNG selection, and BepInEx config integration.

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:

1. 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.
2. 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.
3. 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

1. Add EmpressShopAPI.dll as a reference in your IDE project.
2. Add [BepInDependency("com.Empress.ShopAPI")] to your plugin metadata.
3. Call ShopAPI.RegisterShop in your Awake method.

using BepInEx;
using UnityEngine;
using Empress_ShopLoaderAPI; // Reference my API namespace
using System.IO;

[BepInPlugin("com.YourName.MyCoolShop", "My Cool Shop", "1.0.0")]
[BepInDependency("com.Empress.ShopAPI")]
public class MyShopPlugin : BaseUnityPlugin
{
    private void Awake()
    {
        string bundlePath = Path.Combine(Path.GetDirectoryName(Info.Location), "my_shop_bundle");
        AssetBundle bundle = AssetBundle.LoadFromFile(bundlePath);

        if (bundle != null)
        {
            GameObject myShopPrefab = bundle.LoadAsset<GameObject>("MyShopPrefabName");

            if (myShopPrefab != null)
            {
                // Register your prefab (ensure it has the TRUCK object inside!)
                ShopAPI.RegisterShop(myShopPrefab, "YourName/MyCoolShop");
            }
        }
    }
}

Credits

• Omniscye / Empress