女皇商店加载 API

面向开发者的 R.E.P.O. 专用 API，简化自定义商店的加载流程，内置自动网络同步、随机选择、BepInEx 配置集成等核心能力。

核心特性 & 配置

自动配置生成：所有通过该 API 注册的自定义商店，都会在 com.Empress.ShopAPI.cfg 文件的 [Registered Shops] 节点自动生成配置项，玩家可直接开关；

内置随机容错机制：为避免自定义商店重叠导致游戏崩溃，API 强制每关仅加载一个自定义商店；若启用多个，会通过随机数选择其一；

无缝集成关卡：自动将自定义商店注入 LevelGenerator，并处理单人 / 多人模式下的 ResourceCache 资源缓存，无需开发者额外处理。

开发者关键要求

因 API 会覆盖默认商店起始房间，需严格遵循以下规则避免游戏崩溃：

基础模板：创建自定义商店时，必须以「Module Shop」预制体为基底（包含完整的商店内部、撤离器组件、物品系统等）；

必须复制卡车对象：「Module Shop」预制体默认不含卡车，需打开标准「Shop Start Room」，复制 Truck 父对象并粘贴到自定义商店预制体中；

→ 原因：卡车对象包含玩家生成点、卡车屏幕、核心关卡逻辑，缺失会导致游戏因找不到生成点而崩溃。

集成指南

在 IDE 项目中添加 EmpressShopAPI.dll 作为引用；

在插件元数据中添加依赖声明：[BepInDependency("com.Empress.ShopAPI")]；

在插件的 Awake 方法中调用 ShopAPI.RegisterShop 注册自定义商店预制体。

注意！！ 此mod与其他相同类型的mod有冲突，请单独使用！