BepInEx 从零安装15 分钟跑通 Unity 模组框架【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInExBepInEx 是面向 Unity Mono、IL2CPP 和 .NET 游戏的插件框架让你把模组 .dll 加载进已有的游戏进程。本文面向没装过模组、想动手的第一批人。你肯定想过给一款 Unity 游戏加功能但游戏本身没有任何模组入口模组站发来的却只有一个 .dll你连往哪放都不知道。BepInEx 干的事就是给游戏装一个统一的加载入口装一次之后所有 .dll 放进固定目录就能生效。✅ 确认游戏与系统的前置条件目标游戏是 Unity Mono 编译的这是目前唯一有稳定发布的分支IL2CPP 与 .NET 版本仍属实验性质系统是 Windows、macOS 或 Linux游戏可执行文件为 32 位或 64 位 x86你对游戏安装目录有读写权限游戏装在受保护目录时请用管理员身份操作已按游戏平台下载好对应的发布包已备份游戏存档和重要配置如果以上任何一项不满足先解决再往下看。 把 BepInEx 装进游戏根目录这一节分三个动作完成放文件、查注入配置、指启动入口。解压安装包让 BepInEx 与游戏主程序并排框架是按游戏可执行文件所在目录去找配置的所以文件必须放在游戏根目录。把发布包直接解压到游戏安装目录解压完应该长这样游戏目录/ ├── BepInEx/ │ ├── core/ │ ├── plugins/ │ ├── patchers/ │ └── config/ ├── doorstop_config.ini └── 游戏可执行文件以游戏可执行文件所在目录为准多解一层目录出现 BepInEx/BepInEx/ 嵌套就一定会失败 ⚠️核对 Doorstop 的注入配置先做这一步是因为 doorstop_config.ini 负责告诉游戏去哪个程序集找 BepInEx 加载器。关键参数[General] # Enable Doorstop? enabled true # Path to the assembly to load and execute target_assembly BepInEx\core\BepInEx.Unity.Mono.Preloader.dll [UnityMono] # Overrides default Mono DLL search path dll_search_path_override BepInEx\coreenabled是否启用注入必须是 truetarget_assemblyDoorstop 要加载执行的程序集Mono 版本指向 BepInEx.Unity.Mono.Preloader.dlldll_search_path_override让 Mono 去 BepInEx/core 目录找核心库完整注释版模板可参考仓库里的 Runtimes/Unity/Doorstop/。路径分隔符 Windows 用反斜杠、Linux 用正斜杠混用会导致加载不到 ⚠️指定启动入口指向游戏可执行文件Windows 上直接像平常一样双击游戏主程序游戏自己会读取 doorstop_config.ini。Linux/macOS 使用随包附带的一键启动脚本# run_bepinex_mono.sh 中填入游戏可执行文件名后运行 executable_name你的游戏可执行文件名 ./run_bepinex_mono.sh脚本报not compiled for x86 or x64说明可执行文件名填错或者把 Windows 版游戏拿到了 Linux 环境 ⚠️ 验证 LogOutput.log 正常生成启动游戏等它进入主菜单出现下面三点即算跑通BepInEx/LogOutput.log文件已生成日志里能看到Chainloader initialized和N plugins to load这类行BepInEx/plugins/目录被自动创建初始为空️ 速查高频的模组操作操作怎么做涉及路径装普通插件把 .dll 放进 plugins重启游戏BepInEx/plugins/装补丁程序把 .dll 放进 patchersBepInEx/patchers/改插件配置用文本编辑器打开对应插件的 .cfgBepInEx/config/看本次运行日志用文本编辑器打开 LogOutput.logBepInEx/LogOutput.log临时停用框架把 enabled 改为 false 再启动doorstop_config.ini查已发现插件数在日志里搜 plugins to loadBepInEx/LogOutput.log 改两个最关键的配置文件doorstop_config.ini 管注不注得进去BepInEx.cfg 管日志怎么写后者在首次运行后自动生成。[Logging.Disk] Enabled true AppendLog false LogLevels Fatal, Error, Warning, Message, Info InstantFlushing false ConcurrentFileLimit 5Enabled是否把日志写进磁盘文件排错时建议保持开启AppendLog启动时是追加还是覆盖false 表示每次启动都是全新日志LogLevels写到磁盘日志的级别只关心报错时可收窄InstantFlushing每条日志立即落盘查崩溃有用但明显拖慢性能ConcurrentFileLimit同时打开的日志文件上限每个游戏实例占一个 按症状定位问题现象可能原因处理动作游戏秒退没有 LogOutput.logenabled 不是 true 或 target_assembly 路径错核对 doorstop_config.ini 两项参数脚本提示 not compiled for x86 or x64可执行文件名填错或平台不匹配填入本机真实可执行文件名日志出现 Skipping type [...]插件缺元数据或 GUID 格式非法换用匹配当前 BepInEx 版本的插件插件加载了但没效果插件进程过滤器与当前游戏不符看日志里该插件的进程匹配信息多实例同时开时日志缺失超过 5 个并发日志文件上限调大 BepInEx.cfg 的 ConcurrentFileLimit读日志有个简单套路用文本编辑器打开 LogOutput.log先搜 Error 和 WarningN plugins to load那行告诉你实际发现几个插件跟预期对不上就回查 plugins 目录结尾出现Chainloader startup complete说明整个加载流程正常走完。 进阶到自定义构建与插件开发从源码构建先 clone 仓库 https://gitcode.com/GitHub_Trending/be/BepInEx 然后./build.sh --target Compile需 .NET 6.0 及以上MakeDist 与 Publish 目标可产出分发包细节见 docs/BUILDING.md插件开发继承 BaseUnityPlugin 并加 [BepInPlugin] 特性即可写第一个插件框架核心源码在 BepInEx.Core/多游戏并行每个游戏各自独立的 BepInEx 目录可以按游戏装不同版本互不干扰 回看安装流程并规划下一步BepInEx 的安装本质上就是三件事文件放对目录、配置指对程序集、正常启动游戏。接下来你可以把一两个社区插件放进 BepInEx/plugins/验证完整加载链路通读一遍 LogOutput.log熟悉各日志级别分别代表什么跟着 docs/BUILDING.md 亲手构建一次理解项目结构风险提示模组注入会影响游戏稳定性重要存档先备份再动 BepInEx 目录想彻底移除时删掉整个 BepInEx 文件夹和 doorstop_config.ini 即可恢复原状。【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考