EPL接口

创作者: GhostNarwhal

已更新:2026-07-27 21:07:22

11KB

关于此 MOD

用于通过你自己的模组与增强预制体加载器进行交互的开放API。

强化预制体加载器API

的同伴模组增强型预设加载器从6.0.2版本开始，EPL要求这样做。

如果你是玩家

把它装在EPL旁边就不用管了：把zip解压到你的BepInEx文件夹里，和EPL一样。它会按自己的节奏更新——只在API本身发生变化时才更新——所以别担心它的版本号和EPL的不一致。

一条规则： 只有这个模组页面应该提供 EnhancedPrefabLoader.API.dll。如果有其他模组自带了这个文件的副本，请删除那个副本——残留的旧 dll 是“模组 X 更新后就坏了”的头号原因。

如果你是模组开发者

这是EPL的公开API。针对EnhancedPrefabLoader.API.dll进行编译，即可在纯JSON包所能实现的功能之上添加自定义行为——你自己的卡包生成器、卡牌/物品价格公式、商店钩子和事件。

将EPL声明为可选依赖——这正是这个API的意义所在。你的模组无需EPL即可运行，而当EPL存在时还能启用额外集成，无需强制用户下载它：

[BepInDependency("EnhancedPrefabLoader.API", BepInDependency.DependencyFlags.SoftDependency)]
[BepInDependency("EnhancedPrefabLoader", BepInDependency.DependencyFlags.SoftDependency)]

入口点是 Epl.Api。务必检查可用在使用它之前，请将你的EPL调用保留在只有通过该检查时才会运行的方法中——如果API dll未安装，任何涉及其类型的代码一运行就会抛出异常。
永远不要把API dll打包进你的mod压缩包里。 仅在构建时引用。想要EPL集成的用户安装此模组页面即可获取。
API 在同一个主版本内是增量式的——针对 6.0.x 构建的代码在后续的 6.0.x 版本上仍然可以正常运行。

Discord：https://discord.gg/XUMZwsYQCX
完整 API 文档：文档站点 · 来源： GitLab