BepInEx 入门：2 步装好、3 步编译，给 Unity 游戏挂上你的第一个 Mod

发布时间：2026/9/30 6:44:20来源：尧图网络

BepInEx 入门2 步装好、3 步编译给 Unity 游戏挂上你的第一个 Mod【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx手动给 Unity 游戏加 Mod你得自己写注入、钩子、依赖排序、配置和日志。装好 BepInEx 这个插件框架后这些脏活它全包了你只管往plugins文件夹里扔 DLL。适用边界谁该用、谁不用装 Mod 的玩家和写插件的开发者都适用不需要改游戏代码只要求游戏是 Unity Mono、Unity IL2CPPC 编译管线走 Bleeding Edge 构建或 .NET 系XNA、FNA、MonoGame。兼容性矩阵如下运行时WindowsmacOSLinuxUnity Mono✔️✔️✔️Unity IL2CPP✔️❌✔️.NET / XNA✔️Mono 运行Mono 运行注意当前仅 Unity Mono 有稳定发布版IL2CPP 走 Bleeding Edge 构建。运行机制像快递驿站分拣游戏启动就像一箱快递进门UnityDoorstop 先在门口把包裹截住游戏代码此时还没跑扫一遍plugins文件夹里每个插件的面单按声明的依赖关系排好先后整箱交接给游戏。所以依赖写错的插件不会抢跑日志也按同一顺序落盘。所有文件集中在游戏根目录的BepInEx/BepInEx/ ├── core/ # 框架核心 DLL ├── plugins/ # 你的插件 DLL 放这里 ├── patchers/ # 预加载修补程序 ├── config/ # 各插件的 .cfg 配置文件 └── cache/ # 缓存主日志在游戏根目录的LogOutput.log。按角色分两条线装好使用者 4 步到官方发布页下载最新版Mono 用稳定版IL2CPP 用 Bleeding Edge。解压出的BepInEx整个文件夹拷进游戏根目录exe 所在处。插件 DLL 丢进BepInEx/plugins/。启动游戏打开根目录LogOutput.log确认加载成功。开发者从源码编译 3 步git clone https://gitcode.com/GitHub_Trending/be/BepInEx装好 .NET 6.0 或更高CakeBuild 脚本的硬性要求。Linux 跑./build.sh --target CompileWindows 用build.cmd --target Compile要直接产出可分发包就换--target MakeDist。构建细节看 docs/BUILDING.md。调参与自定义 ⚙️enabled/target_assembly— Doorstop 的总开关与要加载的程序集路径 — 插件一个不加载时先核对这两项。dll_search_path_override— 让 Mono 到BepInEx/core找 mscorlib 等核心库 — 原游戏Managed目录被裁剪、报找不到系统程序集时改它。redirect_output_log— 把 Unity 原生日志转到当前目录output_log.txt— 想捕捉 BepInEx 介入之前的报错时设为true。Logging.Disk的InstantFlushing— 每条日志立即写盘默认false— 排查崩溃时开代价是性能。Logging.Disk的ConcurrentFileLimit— 同时允许打开的日志文件数默认 5 — 多开游戏实例调试时调大。踩坑速查Doorstop 没启用或路径不对怎么办打开doorstop_config_mono.ini确认enabled true且target_assembly指向BepInEx/core/BepInEx.Unity.Mono.Preloader.dll。改完重启游戏再看LogOutput.log。报找不到 mscorlib 或系统程序集游戏自带Managed目录被裁剪过。在 doorstop 配置里设dll_search_path_override BepInEx/core让 Mono 先从框架目录找库。插件 GUID 冲突排查同一个插件放了新旧两份 DLLGUID 相同时只留版本号最高的那份。删掉旧版本只留一份再启动。BepInProcess 限制导致插件不加载加了[BepInProcess(GameName)]的插件只在指定进程名下运行。核对属性里的名字和当前游戏 exe 名是否一致IL2CPP 没有稳定版属于正常现象走 Bleeding Edge 构建即可。BepInEx 是 Unity Mod 圈的事实基础设施下一步读 docs/BUILDING.md把构建目标和分发流程吃透。【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

网站建设高端定制企业官网