BepInEx框架Mod管理工具

BepInEx框架Mod管理工具是一款面向 Unity 游戏 的通用插件加载框架和 Mod 运行平台，主要用于为游戏注入扩展功能、加载第三方模组、执行脚本补丁，以及管理插件运行环境，采用模块化设计，包含预加载器、补丁系统、注入组件和运行库，能够在不直接修改大量原始游戏文件的前提下，为 Unity 游戏提供稳定的扩展能力。它既适合普通玩家安装游戏 Mod，也适合开发者进行插件开发、功能调试和游戏行为修改。

bepinex亮点

1. 模块化结构清晰

BepInEx 并不是一个单文件程序，而是由多个组件共同组成：

BepInEx.dll：核心框架

BepInEx.Preloader.dll：预加载器，用于游戏启动早期介入

BepInEx.Harmony.dll：补丁支持模块

0Harmony.dll：方法级别的 Hook / Patch 引擎

MonoMod.*：运行时修改与重定向支持

Mono.Cecil.*：程序集分析与处理支持

doorstop_config.ini + winhttp.dll：用于注入与启动拦截

这种结构的好处是：

功能分层明确、扩展能力强、兼容性好，后续添加插件或排查问题也更方便。

2. 面向 Unity 游戏的通用扩展框架

BepInEx 的定位不仅是“加载 Mod”，更像是 Unity 游戏的一个 插件运行平台。

它可以在游戏启动时接管插件初始化，让外部 DLL 插件在游戏运行过程中被加载并执行，从而实现界面增强、功能修改、参数调整、作弊菜单、辅助工具、翻译补丁等多种扩展效果。

3. 具备补丁与注入能力

从 0Harmony.dll 和 BepInEx.Harmony.dll 可以判断，这套环境支持 Harmony 补丁机制。

也就是说，BepInEx 不只是“外挂式追加功能”，还能够：

修改已有函数逻辑

在原函数执行前后插入新逻辑

重写部分游戏行为

动态扩展或修复原版功能

这使它在 Mod 生态里非常灵活。

4. 预加载机制完整

BepInEx.Preloader.dll、doorstop_config.ini、winhttp.dll 表明它具备较完整的预加载链路。

这意味着 BepInEx 可以在游戏主逻辑启动之前提前介入，完成环境准备、插件扫描、依赖加载和补丁注入，从而提高插件加载成功率。

BepInEx使用教程

一、先分清你玩的游戏是哪种

BepInEx 官方把 Unity 游戏安装分成两类：

Unity Mono

Unity IL2CPP

一般玩家不用自己深究太多，很多 mod 页面会直接写：

“Requires BepInEx 5”

“For BepInExPack”

“IL2CPP only”

“Mono only”

如果 mod 作者已经写明要哪种，就按作者要求装。

二、怎么安装 BepInEx

1）下载对应版本

官方文档要求你按 游戏类型 + 系统 + 位数 下载对应压缩包，例如：

Mono：

Unity.Mono-win-x86

Unity.Mono-win-x64

IL2CPP：

Unity.IL2CPP-win-x86

Unity.IL2CPP-win-x64

2）解压到游戏根目录

官方安装步骤很直接：
把压缩包内容解压到游戏根目录，也就是和游戏 exe 同一级的目录。

比如你游戏目录原来是这样：

MyGame

├─ MyGame.exe

├─ UnityPlayer.dll

解压后通常会变成这样：

MyGame

├─ MyGame.exe

├─ UnityPlayer.dll

├─ BepInEx/

├─ doorstop_config.ini

├─ winhttp.dll

这些文件名会随版本有些差异，但核心思路就是：都放在游戏根目录。

3）启动一次游戏

第一次启动后，BepInEx 会初始化并生成配置、日志、插件目录。官方文档说明配置文件在 BepInEx/config/BepInEx.cfg。

三、mod 放哪里

大多数 BepInEx mod，直接放到：

BepInEx/plugins

也就是 plugins 文件夹。

常见情况：

.dll 插件：放进 BepInEx/plugins

有的 mod 会带子文件夹，也是一整个放进去

有些 mod 还有配置文件，第一次运行后会在 BepInEx/config 生成

所以最常见操作就是：

下载 mod → 解压 → 把 dll 放进 BepInEx/plugins

四、怎么判断装成功了

启动游戏后，通常会出现这些现象：

游戏目录里生成 BepInEx 相关文件夹

有日志输出

插件被自动加载

报错也会写进日志里

日志和配置是排错的关键，官方文档明确提到配置文件位置为 BepInEx/config/BepInEx.cfg。

你实际排错时最该看的是：

BepInEx/LogOutput.log

如果某个 mod 没生效，先看这里。

五、最常见的使用流程

拿一个普通 Unity 游戏举例：

场景：给游戏装一个 BepInEx mod

下载对应的 BepInEx

解压到游戏根目录

启动一次游戏

关闭游戏

下载 mod

把 mod 的 .dll 放到 BepInEx/plugins

再启动游戏

看 LogOutput.log 是否成功加载

六、常见问题

1）没反应 / 游戏打不开

通常是这几种原因：

下错版本：Mono 装成 IL2CPP，或者反过来

32 位和 64 位下错

mod 版本和游戏版本不匹配

mod 依赖别的前置插件

反作弊或启动器拦截

官方安装文档里最核心的要求就是：下载正确类型和位数的包。

2）IL2CPP 为什么更麻烦

因为官方目前仍说明：只有 Unity Mono 有稳定版发布；IL2CPP 支持存在，但常常要看较新的构建或特定整合包。

3）BepInEx 和 Thunderstore 是什么关系

很多游戏社区会直接发 BepInExPack 或 Thunderstore 整合包。
这种情况下通常更省事：你直接按整合包说明装，不一定要自己手动找原版压缩包。

bepinex主要功能

插件加载

BepInEx 最基础的功能，就是为 Unity 游戏提供插件加载能力。

用户只需要把对应的插件或 mod 文件放到指定目录中，框架就会在游戏启动时自动识别并加载。

游戏行为修改

借助 Harmony 和相关运行库，BepInEx 可以修改游戏内部逻辑，例如：

调整数值

修改 UI

增加快捷功能

改写系统判定

增强交互体验

运行时补丁

不同于直接覆盖原文件，BepInEx 更偏向于 运行时动态补丁。

这种方式通常更灵活，也更适合多个 mod 共同存在的场景。

依赖管理与兼容支持

MonoMod.*、Mono.Cecil.* 可以看出，BepInEx 不仅能加载插件，还提供了一套底层依赖支持，帮助插件进行程序集操作、方法重定向和代码注入，减少开发难度。

启动接管与环境初始化

通过 winhttp.dll 和 Doorstop 相关配置，BepInEx 可以在游戏启动初期接管流程，为后续插件加载建立稳定环境。

产品特色

1. 轻量但功能完整

虽然目录中文件不算少，但整体部署方式仍然很直接：

把核心文件放进游戏目录后，就能形成完整的插件运行环境。

对用户来说安装门槛不高，对开发者来说扩展能力又很强。

2. 兼容常见 Mod 开发方式

从目录里的 Harmony、MonoMod、Mono.Cecil 就能看出，BepInEx 兼容当前常见的 Unity Mod 开发思路。

不管是简单插件加载，还是高级补丁注入，它都能提供支持。

3. 可维护性强

文件结构清楚，核心模块和依赖模块分工明确。

出了问题时，开发者或玩家更容易定位是：

注入层问题

预加载器问题

核心框架问题

补丁组件问题

某个插件本身的问题

4. 适合形成完整 Mod 生态

BepInEx 不只是运行单个插件，而是可以作为多个 Mod 的公共底座。

对于一个游戏社区来说，它很适合作为统一的插件平台，降低不同 Mod 之间的接入成本。