BepInEx 5.x 下载安装与使用指南（附安装包）

BepInEx 是做什么的

BepInEx 是一款免费、开源、专门为 Unity 游戏打造的 Mod 加载框架，名字由 BepIn 和 Ex(extension) 组合而来。它本身不提供任何游戏修改功能，而是为 Unity 游戏提供一个插件加载环境，让 Mod 开发者可以编写脚本注入到游戏中，实现修改游戏内容、增加新功能、改善体验等效果。

在 Unity 游戏 Mod 加载领域，MelonLoader 是另一个常见选择，两者在支持游戏范围、插件格式、配置方式和社区规模上有所不同。目前 BepInEx 最新版本是 5.x 系列（稳定版），5.4.x 是目前最广泛使用的版本，兼容绝大多数 Unity 游戏。

BepInEx 安装包下载方式

BepInEx 下载地址：BepInEx 安装包（源自 GitHub，长期维护，放心使用） 夸克网盘下载

BepInEx 安装步骤

BepInEx 的安装方式和普通软件不太一样，它是以”注入”方式安装到游戏目录里的。下面以 Windows 平台为例：

1）找到你要装 Mod 的游戏安装目录。比如在 Steam 里，右键游戏→管理→浏览本地文件，就能打开游戏所在文件夹。

2）把下载好的 BepInEx 压缩包解压，把里面的所有文件和文件夹复制到游戏根目录（和游戏 exe 文件同一个目录）。解压后游戏目录里应该会有 BepInEx 文件夹、doorstop_config.ini 文件、winhttp.dll 文件等。

3）运行一次游戏。BepInEx 会在首次启动时自动创建必要的配置文件和文件夹。启动后你会看到游戏窗口顶部出现 BepInEx 的版本信息，同时游戏目录的 BepInEx 文件夹里会多出 config、plugins、patchers 等子文件夹。如果没有生成这几个文件夹，请重新确认游戏使用的 Unity 版本、游戏路径是否有中文、安装位置是否正确。

4）关闭游戏。现在安装就完成了，可以开始装 Mod 了。

BepInEx 使用注意事项

BepInEx 安装好之后，核心文件夹都在游戏根目录的 BepInEx 文件夹里，日常使用主要和几个关键文件夹打交道：

• plugins 文件夹（BepInEx/plugins）：从网上下载的 Mod 插件（.dll 文件）放到这里，BepInEx 会在游戏启动时自动加载。有些 Mod 可能需要额外的资源文件，通常会放在 Mod 自带的子文件夹里。
• config 文件夹（BepInEx/config）：存放 BepInEx 本身和各 Mod 的配置文件，用记事本打开 .cfg 文件就可以修改参数，比如调整 Mod 开关、修改数值、改变热键绑定等。
• Log 输出：BepInEx 启动时会生成日志文件，放在 BepInEx/LogOutput.log（旧版）或 BepInEx/BepInEx_Log.txt（新版）。如果装了 Mod 后游戏崩溃或者 Mod 没生效，先看日志，排查问题时的第一步就是看日志。
• 禁用 BepInEx：如果装了 BepInEx 后遇到问题想先排除是不是它引起的，不需要卸载——直接把游戏根目录下的 winhttp.dll（或者 BepInEx 文件夹重命名）就行，BepInEx 就不会加载了。想恢复的时候改回来即可。

常见问题

问：装了 BepInEx 后游戏启动闪退，一般是什么原因？ 答：最常见的两个原因：一是 BepInEx 版本和游戏使用的 Unity 版本不兼容，检查游戏是 Mono 版还是 IL2CPP 版，选对应版本；二是某个 Mod 插件和游戏或者其他 Mod 冲突，把 plugins 文件夹里的 .dll 文件全部移走，一个一个放回去测试，日志文件能帮上大忙。

问：BepInEx 启动后顶部显示版本信息，但 Mod 没生效怎么办？

答：这说明 BepInEx 本身加载成功了，问题出在 Mod 上。检查 Mod 插件是否放对了位置（必须是 plugins 文件夹下的 .dll 文件，不能有子文件夹嵌套），并确认 Mod 兼容的 BepInEx 版本和你装的是否一致。

问：游戏更新后 Mod 不能用了，需要重新安装 BepInEx 吗？

答：先确认 BepInEx 本身是否需要更新到最新版，然后等 Mod 作者更新 Mod。BepInEx 的配置文件和 plugins 文件夹不会因为游戏更新被删除，所以不用担心重装 BepInEx。等待期间如果特别想玩，可以在 Steam 里回退到旧版本。