孙圈圈接触Unity引擎mod制作的朋友，应该都绕不开BepInEx这个名字。简单说，BepInEx是一个专门为Unity游戏打造的mod运行框架，它负责在游戏启动时提前加载插件，让我们能用C#写mod去修改游戏行为，而不需要改动游戏本身的二进制文件。项目标题里这几个关键词——Unity、BepInEx、mod制作，正好就是这条技术路线的三个核心。这篇文章我会从环境准备、框架安装、第一个mod编写、常见问题排查四个块，把整个过程完整捋一遍，适合刚接触Unity mod、想自己动手做一个小插件的朋友参考。
老玩家可能知道，Unity游戏改mod的路径不止一条，有直接改游戏资源的，有做内存修改的，也有靠注入DLL的。但BepInEx是目前社区里最稳定、生态最完整的一套方案，特别是配上Harmony补丁库，很多主流Unity游戏的mod都是在它上面跑的。我自己从BepInEx 4时代就开始用，一路跟着升到5.x再到6.x预览版，踩过的坑也不少，这篇就当是帮你把地图铺开，少走点弯路。
1. 为什么是BepInEx
1.1 它到底做了什么
很多人第一次看到BepInEx的压缩包，不太理解为什么解压到游戏根目录后，第一次启动游戏会在BepInEx文件夹里生成一堆配置和日志。这其实是它的核心机制：BepInEx本质上是一个预加载器，它在游戏主程序启动时抢先运行，把Unity引擎的初始化过程拦一道，然后加载BepInEx/plugins目录下的所有插件DLL。
这套机制对用户来说最大的好处是：你不用改游戏本体文件。游戏原始程序集保持原样，mod作为外部插件被挂载，更新游戏后大概率还能继续用。对开发者来说，BepInEx提供了统一的插件入口、日志系统、配置系统，甚至还有控制台，极大降低了mod开发门槛——你只需要写一个继承BaseUnityPlugin的类，就能在游戏启动时拿到执行权。
另外要分清楚一个概念：BepInEx本身不会修改游戏代码，它只是“宿主”。真正实现修改效果要靠两种手段，一种是直接调用游戏内部方法（通过反射或程序集引用），另一种是给游戏方法打Harmony补丁。BepInEx和Harmony是两个独立的库，但几乎成了黄金搭档，后面写mod时会重点讲。
1.2 和同类框架怎么选
Unity mod框架不止BepInEx一家。UnityModManager、MelonLoader、KingmakerModLoader这些都是社区里常见的选择，简单对比一下：
| 框架 | 定位 | 优点 | 缺点 |
|---|---|---|---|
| BepInEx | 通用Unity游戏mod框架 | 支持Mono和IL2CPP，插件生态庞大，配置灵活 | 手动安装步骤稍多 |
| UnityModManager | 偏GUIManagement的mod加载器 | 有界面，安装mod方便 | 对IL2CPP游戏支持较弱 |
| MelonLoader | 偏游戏内注入的mod框架 | 启动极早，适合需要抢在游戏初始化前执行的mod | 兼容性不如BepInEx稳定 |
个人经验是：成熟的老游戏，比如城市天际线、堕落之王，社区mod基本都围绕BepInEx做；新出的游戏如果是IL2CPP后端，BepInEx 6.x预览版也有对应支持。选BepInEx还有个理由：它背后的社区文档和示例工程相对多，遇到问题搜BepInEx <问题>基本都能找到答案。UnityModManager适合只装别人写好的mod，不适合自己做mod开发的场景。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 开工前的准备：环境、工具与版本
2.1 先判断游戏后端
这一步是我见过最多的新手翻车点。Unity游戏的脚本运行环境分两种：Mono和IL2CPP。Mono是较早的解决方案，游戏目录下通常会有一个*_Data/Managed文件夹，里面放着能直接反编译的DLL；IL2CPP则是Unity把C#转成C++再编译成机器码，游戏根目录会出现一个大的GameAssembly.dll，原始DLL会被打包进global-metadata.dat。
怎么判断？打开游戏目录，看有没有GameAssembly.dll。有，就是IL2CPP；没有，大概率是Mono。再辅助看*_Data/Managed里