从下载到跑通BepInEx 插件框架上手完整记录【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInExBepInEx 是给 Unity、.NETXNA、MonoGame 等游戏用的插件模组框架把核心 dll 和配置放进游戏根目录游戏启动时自动注入再加载 plugins 目录里的 C# 插件。下面是我装完、跑完记下的过程。它到底能帮你做什么不罗列功能按场景看更直观场景对应能力给 Unity Mono 游戏加自定义 HUD、改数值插件 dll 放进 BepInEx/plugins重启即生效写插件同时要配置项和日志BepInEx.Core 的 ConfigFile、Logger 自动生成 cfg 和日志目标是 IL2CPP 编译的游戏IL2CPP 版本走 CoreCLR 注入目前属实验性给 .NET/XNA 老游戏加模组.NET 预加载器接管启动入口Windows 下直接可用动手之前先花 30 秒确认游戏目录要有Data/Managed这类标准 Unity 结构BepInEx 靠它定位游戏根目录判断逻辑在 BepInEx.Core/Paths.cs预编译包必须和游戏的 32/64 位一致位数不对注入直接失败平台支持Unity Mono 版本覆盖 Windows、macOS、LinuxIL2CPP 版本不支持 macOS存档先备份一份走源码构建的话本机要有 .NET 6.0 以上两条路线把它跑起来第一次用直接拿预编译包只有要改注入行为或自己打包时才碰源码。路线 A预编译包怎么装按平台选包Unity Mono 版本是稳定版IL2CPP 是实验版全部解压到游戏根目录与游戏 exe 同层不要多套一层文件夹确认根目录出现了doorstop_config.ini和BepInEx/目录我装完发现默认注入入口写在 doorstop_config.ini 的target_assembly里Mono 版本指向BepInEx/core/BepInEx.Unity.Mono.Preloader.dll一般不用动它。路线 B源码构建一条命令clone 仓库git clone https://gitcode.com/GitHub_Trending/be/BepInEx后在仓库目录里执行./build.sh --target Compile装完怎么确认没翻车日志文件 LogOutput.log 在哪里看启动一次游戏我观察到的成功信号游戏根目录出现BepInEx/LogOutput.log开头是 BepInEx 版本号和插件加载记录日志文件被占用时会自动改用LogOutput.1.log、LogOutput.2.log顺延这是源码里写的降级逻辑BepInEx/下core/、plugins/、patchers/、config/子目录齐全config/BepInEx.cfg是框架主配置装完的目录结构长这样游戏根目录/ ├── BepInEx/core/ ├── BepInEx/plugins/ ├── BepInEx/config/ └── doorstop_config.ini卡住了先看这张表现象处理方式启动后没生成 LogOutput.logDoorstop 没注入确认装在游戏根目录平台与位数选对启动即崩溃检查 doorstop_config.ini 的 target_assembly 是否指向 BepInEx/core/BepInEx.Unity.Mono.Preloader.dll插件没生效确认 dll 在 BepInEx/plugins/ 里并且重启过游戏改配置后数值被还原打开 BepInEx/config/ 下对应 cfg 查语法错误备份后删除让游戏重新生成IL2CPP 版本行为不稳README 说明目前只有 Unity Mono 是稳定发布先换 Mono 版本验证想再往前一步官方构建文档在 docs/BUILDING.md三个平台的脚本和 Compile、MakeDist、Publish 目标都列了构建前读一遍。核心源码集中在 BepInEx.Core/插件契约、ConfigFile、Logger 都在这里查行为比翻文档快。社区以官方 Discord 为主提问前把 LogOutput.log 里报错那一段贴出来效率最高。整个流程不复杂时间大多花在确认目录和版本对上没有。下一步建议往BepInEx/plugins/里放一个已知好用的插件 dll重启游戏在 LogOutput.log 里看到它的加载记录就算完整跑通了。【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
