BepInEx 插件框架安装三步锁好门首启 10 分钟跑通【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInExBepInEx 是面向 Unity Mono、IL2CPP 和 .NET 游戏的插件框架。它会在游戏启动的瞬间锁好一扇门plugins 文件夹里所有 dlldll 就是编译好的组件一个插件一份都从这扇门进来、按序加载日志和配置统一管理。Windows、Linux、macOS 都能用目前只有 Unity Mono 有稳定发布。适合想装第三方 MOD 的玩家和要在上面写插件的开发者。 判断卡你的游戏配不配这扇门它是什么一个在游戏启动门口进程入口生效的轻量注入框架接管所有插件的加载、日志和配置它不做什么不改画面、不做 MOD它是底座一堆第三方加载器都架在它上面谁该用想装第三方模组的玩家、要写插件的开发者谁先别用游戏是 IL2CPP游戏代码的另一种编译模式或根本不是 Unity/.NET 的先对照 README 里的 Platform compatibility chart 表——IL2CPP 在 macOS 和 ARM 上都不支持 动手前自查五件事✅ 游戏根目录下有游戏名_Data/Managed文件夹——这是 Unity Mono 游戏的标志✅ BepInEx 包的位数32 位/64 位和游戏主程序一致✅ 磁盘空间够框架本身很小预留 100MB 富余✅ IL2CPP 游戏再对一遍 README 的兼容表确认你的系统在支持列⚠️ 唯一不可逆的东西游戏存档。动手前先备份别信手气 操作主线三步锁门全部工作压成三步拿包、落位、首启验证。拿包按系统加游戏位数选新手路线去项目 Releases 发布页按操作系统 游戏位数选比如 Windows 64 位 Unity Mono 就选 win64 的 Unity Mono 包。 进阶路线git clone https://gitcode.com/GitHub_Trending/be/BepInEx拉源码Windows 跑build.cmd --target CompileLinux 跑./build.sh --target Compile需要 .NET 6.0 及以上。⚠️ 常见坑位数和游戏对不上 → 对策核对游戏主程序位数与包名不一致就回发布页换对应版本重新下载。落位BepInEx 与主程序平级新手路线解压工具选解压到当前目录让 BepInEx 文件夹和游戏主程序放在同一层。 进阶路线源码自建的从构建输出取包摆法一样落好之后目录长这样游戏根目录/ ├── BepInEx/ │ ├── core/ # 框架核心 dll不要动 │ ├── plugins/ # 插件放这里 │ ├── patchers/ # 需要修改游戏代码的补丁 │ └── config/ # 配置目录首启自动创建 ├── doorstop_config.ini # 启动钩子配置指向入口 dll └── 游戏主程序⚠️ 常见坑解压时 BepInEx 又套进游戏目录变成 BepInEx/BepInEx 两层 → 对策BepInEx 必须与主程序平级多套一层启动时就读不到核心 dll重新解压即可。首启验证日志里看两个标志新手路线Windows 双击游戏主程序Linux 用发布包里的run_bepinex_mono.sh把游戏可执行文件作为第一个参数传入。 进阶路线Linux 下在终端执行./run_bepinex_mono.sh ./游戏可执行文件边跑边盯日志。跑通的标志有两个BepInEx/LogOutput.log出现开头是 Chainloader接管插件加载的组件启动记录BepInEx/config/BepInEx.cfg被自动创建首启慢一点是正常的——它在扫描插件目录、注册插件。⚠️ 常见坑启动后没有 LogOutput.log → 对策确认 BepInEx 与主程序平级再查 doorstop_config.ini 的 target_assembly 是否指向BepInEx/core/BepInEx.Unity.Mono.Preloader.dll改对再启动。 跑通之后最高频的两件事装插件拖进去就行没有注册一说没有安装步骤也不用注册。把下载好的.dll放进BepInEx/plugins/重启游戏日志里多了一条这个插件的加载记录就成了。改配置大概率只改这两个全局配置BepInEx/config/BepInEx.cfg是 TOML 格式键值对文本能手改。最容易动的就是[Logging.Disk]下面这两个[Logging.Disk] LogLevels Info # 只写 Info 及以上日志小很多 AppendLog false # 每次启动覆盖旧日志排查更清爽游戏是 IL2CPP 的话再核对 doorstop_config.ini 里 target_assembly 指向的 dll两份模板在 Runtimes/Unity/Doorstop/Mono 模板指向BepInEx/core/BepInEx.Unity.Mono.Preloader.dllIL2CPP 模板指向BepInEx/core/BepInEx.Unity.IL2CPP.dll。 排障卡住先看这三条如果你发现游戏起不来或秒退先查 BepInEx 是否被套成两层、包位数与游戏是否一致然后回发布页换对应版本重新下载安装验证手段重装后启动看BepInEx/LogOutput.log是否出现。如果你发现插件在plugins/里却没生效先查LogOutput.log里搜Skipping——多半是依赖插件没加载或插件要求的 BepInEx 比你的新然后补装缺失依赖或升级 BepInEx验证手段重启后在日志里找到该插件的加载记录。如果你发现日志太长找不到关键行先把LogLevels改成Info、AppendLog改成false再重启一次然后只看从第一行开始的新日志验证手段LogOutput.log开头应为本次启动的 Chainloader 记录而不是上次残留。 收尾两个去处和三个习惯源码构建的完整流程看 docs/BUILDING.md要求 .NET 6.0 及以上Compile/MakeDist/Publish 三个构建目标各做什么文档里写清楚了写插件的话看 BepInEx.Core/BepInPlugin 特性、插件契约、配置与日志 API 全在这个目录里从今天起养成的三个习惯装任何新插件之前先备份存档而不是等出问题再找版本只认稳定发布而不是把尝鲜版放主力存档上装插件、改配置之后先打开BepInEx/LogOutput.log看一眼而不是等游戏出怪现在就去解压你的包落位到主程序平级然后确认日志里出现了它。【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考