You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

2 months ago

Downloads

95K

Size

57KB

Dependency string

Omniscye-Empress_ShopLoaderAPI-1.2.2

Download

Details Required (2)Versions

Empress ShopLoaderAPI v1.2.2

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

Changelog

1.2.1

Vanilla Shops added to RNG Rotation and also config now!

Message

If you need support for my mods or just want to hang out join my new personal server on Discord: https://discord.gg/TnruJeXdAw

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 in your IDE project.
Add [BepInDependency("com.Empress.ShopAPI")] to your plugin metadata.
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

Message

If you need support for my mods or just want to hang out join my new personal server on Discord: https://discord.gg/TnruJeXdAw

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 in your IDE project.

Add [BepInDependency("com.Empress.ShopAPI")] to your plugin metadata.

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

R.E.P.O.

Details

Empress ShopLoaderAPI v1.2.2

Changelog

1.2.1

Message

Features & Configuration

For Developers

⚠️ Critical Requirement: The Truck, Spawn Points, & Screens

Implementation Guide

Empress ShopLoaderAPI v1.2.2

Changelog

1.2.1

Message

Features & Configuration

For Developers

⚠️ Critical Requirement: The Truck, Spawn Points, & Screens

Implementation Guide