主页 > 软件下载

【2026最新】BepInEx下载和安装保姆级教程（附官网安装包）

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

BepInEx是"BepIn"和"Ex(extension)"的组合，它是一款免费、开源、专门为Unity游戏打造的Mod（模组/插件）加载框架。

BepInEx本身不提供任何游戏修改功能，它做的是给Unity游戏提供一个插件加载环境，让Mod开发者可以编写脚本注入到游戏中，实现修改游戏内容、增加新功能、改善体验等效果。

在 Unity 游戏 Mod 加载领域，MelonLoader 是另一个常见选择。它们的主要区别：

功能 BepInEx MelonLoader
支持游戏 绝大多数Unity游戏 大多数Unity游戏
插件格式 .dll（使用Harmony补丁） .dll或MelonMod
配置方式 配置文件（cfg文件） 命令行参数
社区规模 较大（主流Mod多） 中等
是否开源 是（LGPL） 是（Apache）

目前BepInEx的最新版本是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等子文件夹。 
|-BepInEx
  |-cache //缓存文件夹
  |-config //插件配置文件夹
  |-core //框架核心文件夹
  |-patchers //特殊插件文件夹
  |-plugins //常规插件文件夹
  |-LogPutput.log //BepInEx日志
如果没有生成这几个文件夹，请重新确认游戏使用的 Unity 版本、游戏路径是否有中文、安装位置是否正确。

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

BepInEx基础使用

BepInEx安装好之后，它的核心文件夹都在游戏根目录的BepInEx文件夹里。使用BepInEx主要就是和这几个文件夹打交道：

1）plugins文件夹（BepInEx/plugins）

这是最重要的文件夹。从网上下载的Mod插件（.dll文件）放到这里，BepInEx会在游戏启动时自动加载。有些Mod可能需要额外的资源文件（图片、配置文件等），通常会放在Mod自带的子文件夹里。

2）config文件夹（BepInEx/config）

这里存放BepInEx本身的配置文件和各Mod的配置文件。游戏的Mod设置通常在这里以.cfg文件的形式存在。用记事本打开就可以修改参数，比如调整Mod功能的开关、修改数值、改变热键绑定等。

3）Log输出

BepInEx启动时会生成日志文件，放在BepInEx/LogOutput.log（旧版）或BepInEx/BepInEx_Log.txt（新版）。如果装了Mod后游戏崩溃或者Mod没生效，可以先看看日志文件，里面会显示哪个插件加载失败、报了什么错。排查问题时的第一步就是看日志。

4）禁用BepInEx

如果装了BepInEx后遇到问题想先排除是不是它引起的，不需要卸载——直接把游戏根目录下的winhttp.dll（或者BepInEx文件夹重命名）就行，BepInEx就不会加载了。想恢复的时候改回来即可。

BepInEx常见使用问题

1）装了BepInEx后游戏启动闪退

最常见的两个原因：

2）BepInEx启动后顶部显示版本信息，但Mod没生效

这说明BepInEx本身加载成功了，问题出在Mod上。

检查一下Mod插件是否放对了位置（必须是BepInEx/plugins文件夹下的.dll文件，不能有子文件夹嵌套）。有些Mod会要求特定的BepInEx版本，确认一下Mod兼容的BepInEx版本和你装的是不是一致。

3）游戏更新后Mod不能用了

游戏更新后Unity版本可能发生了变化，或者游戏代码变了导致Mod的补丁失效。

先确认BepInEx本身是否需要更新到最新版，然后等Mod作者更新Mod。BepInEx的配置文件和plugins文件夹不会因为游戏更新被删除，所以不用担心重装BepInEx。

等待期间如果特别想玩，可以在Steam里回退到旧版本（Steam→游戏属性→测试版→选择旧版本）。

总结

BepInEx是目前给Unity游戏装Mod最常用的工具框架。它解决了Mod加载的核心问题，不需要修改游戏文件、不需要反编译、插件式管理。装好BepInEx后，把Mod作者的插件放到plugins文件夹就行，卸载Mod直接删除对应.dll文件。

对于喜欢折腾游戏Mod的玩家来说，下载BepInEx安装到游戏目录是第一步，后面的Mod世界就靠它支撑起来了。