BepInEx下载、安装和使用教程（附安装包）

BepInEx 是一款专门给 Unity 游戏“打补丁”的开源插件框架。

用大白话说，BepInEx 就像给游戏加了一个“小尾巴”，启动游戏时先加载 BepInEx，再由 BepInEx 去帮你运行玩家自己写的代码，于是不用改游戏原文件就能加新功能、改数值、甚至画新的菜单。

BepInEx 最初服务于《饥荒 Together》和《嗜血代码》等 Unity 作品，后来扩展到 IL2CPP、Mono、.NET Framework/6/7 等多种运行时，现在已成为 RimWorld、Valheim、TerraTech、Among Us、雀魂麻将等上百款热门游戏的“标配”Mod 框架。

对完全没接触过 Mod 的新手而言，只要把 BepInEx 解压到游戏根目录，再把下载来的“一键拾取”“双倍经验”插件扔进 plugins 文件夹，双击游戏，进服后就能看到效果，全程不用碰 C++ 也不用反编译 exe，门槛极低。

BepInEx 的应用场景大致分三类：

• 第一类是玩家向的“便利模组”，如自动拾取、显示伤害数字、解锁帧率，这类插件通常只放 plugins 文件夹，装完即用；
• 第二类是服主向的“管理工具”，如 Rcon 控制台、防作弊检测、白名单系统，这类插件会配合 config 文件做开关，常用于私服；
• 第三类是开发者向的“逆向辅助”，通过 BepInEx 注入自己的调试代码，再借助 Harmony 动态 Patch，可在不重新打包游戏的情况下测试新机制，极大降低迭代成本。

使用 BepInEx 需注意三点：

• 单机游戏随意改，但联网游戏需遵守官方条款，部分竞技游戏会把 BepInEx 识别为外挂，导致封号；
• IL2CPP 游戏（如《原神》《崩坏：星穹铁道》）需要额外下载 Il2CppInterop 系列依赖，否则插件无法 hook；
• 游戏更新后原插件可能出现崩溃，需等待插件作者升级，或自己用 Harmony 重新匹配新地址。

下载BepInEx

这里为大家提供了 BepInEx 的最新版压缩包：

网盘下载：https://pan.quark.cn/s/056651ec189f

网盘中提供了适用于 Windows、Linux 和 Mac OS 三个平台的 BepInEx 压缩包，大家可以根据情况自行选择。

安装BepInEx的准备工作

安装前的准备工作非常轻量：

• 确认游戏是 Unity 引擎（可在游戏目录里找 UnityPlayer.dll 或 GameAssembly.dll）；
• 确认系统已装 .NET 6 运行时（BepInEx 5.x 需要 .NET 4.7.2，BepInEx 6.x 需要 .NET 6）；
• 再准备一个解压工具。

Windows 10/11 用户建议直接下载 BepInEx_win_x64_5.4.23.4.zip，Linux 玩家用 BepInEx_linux_5.4.23.4.tar.gz，macOS 用户选 BepInEx_macos_5.4.23.4.tar.gz。

安装BepInEx

1) 把压缩包解压到游戏根目录，确保出现 doorstop_config.ini 和 BepInEx 文件夹；

|-XXXGame
  |-BepInEx*
    |-core
      |-...
  |-XXXGame_Data
  |-doorstop_config.ini*
  |-UnityCrashHandler64.exe
  |-UnityPlayer.dll
  |-XXXGame.exe
  |-winhttp.dll*

2) 启动游戏之后，在 BepInEx 文件夹下应该会生成几个文件夹，如下：

|-BepInEx
  |-cache //缓存文件夹
  |-config //插件配置文件夹
  |-core //框架核心文件夹
  |-patchers //特殊插件文件夹
  |-plugins //常规插件文件夹
  |-LogPutput.log //BepInEx日志

如果没有生成这几个文件夹，请重新确认游戏使用的 Unity 版本、游戏路径是否有中文、安装位置是否正确。

3) 将下载的插件 .dll 放进 BepInEx/plugins，重启游戏，屏幕左上角会弹出加载日志，表示成功。若想验证是否生效，可在控制台输入 help，若返回插件列表，即说明框架已正常运行。