BepInEx插件框架5分钟给Unity游戏装上插件【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx手动修改游戏的Managed目录或反编译 dll一次操作失误就可能让游戏无法启动。BepInEx 是面向 Unity Mono、Unity IL2CPP 与 .NET/XNA 游戏的插件加载框架它在运行时动态加载插件、统一管理配置与日志全程不改动游戏原始文件。能力边界BepInEx 只负责加载、管理和打补丁 .NET 程序集不做其他事做运行时扫描BepInEx/plugins/下的插件、解析依赖顺序、提供统一的配置与日志入口插件卸载后游戏保持原样。做覆盖 Unity Mono、Unity IL2CPP 和 .NET 框架XNA、FNA、MonoGame游戏但按 README 的平台兼容表目前只有 Unity Mono 有稳定发布版IL2CPP 仅在 Windows 与 Linux 上支持。不做非 .NET 的自研引擎游戏不支持它也不是资源/模型替换工具不负责游戏本体文件的热更新。部署前怎么判断你的游戏动手前先确认三件事确认运行时类型。游戏目录含UnityPlayer.dll且Managed/下有mscorlib.dll的是 Unity Mono存在GameAssembly.dll的是 IL2CPP基于 .NET 框架的则归第三类。拿不准就用 Mono 路线验证。核对平台兼容。Windows、Linux、macOS 的支持范围不一致见仓库 README 中的 platform compatibility chartIL2CPP 无 macOS 与 ARM 支持。取对应发行包。直接下载对应平台与运行时的预编译包里面已含core/、patchers/、plugins/目录和 doorstop 注入库自己从源码编译属于开发者路径新手不需要。Linux/macOS 用户还要把发行包里的启动脚本run_bepinex_mono.sh与游戏可执行文件配对使用。最短路径部署5 分钟把发行包整个放入游戏根目录使BepInEx/文件夹与doorstop_config.ini并排。预期目录结构与官方布局一致BepInEx/core/下能看到BepInEx.Core.dll等文件。检查doorstop_config.ini。确认[General]段enabled true且target_assembly指向BepInEx/core/BepInEx.Unity.Mono.Preloader.dll仓库内该文件位于 Runtimes/Unity/Doorstop/发行包已带默认值。预期两个值与你的运行时匹配。启动游戏。Windows 直接运行游戏.exeLinux 编辑run_bepinex_mono.sh中的executable_name填入游戏可执行文件名后执行./run_bepinex_mono.sh。预期出现命令行窗口滚动打印 BepInEx 与插件的加载信息随后进入主菜单。装完怎么验证看三个信号全部满足即装好日志BepInEx/LogOutput.log开头出现 BepInEx 版本号随后逐行列出 Chainloader 加载的插件名与版本目录BepInEx/下自动补齐config/、plugins/、patchers/、cache/首次运行会在config/生成BepInEx.cfg冒烟测试把一个已知正常的.dll临时放进BepInEx/plugins/再启动日志中出现该插件的 GUID 即说明整条链路通畅。关键部位只有三处BepInEx/core/核心 dll 所在目录doorstop_config.ini的target_assembly就指向这里。升级 BepInEx 只动这个目录。BepInEx/plugins/插件 dll 的存放处。Chainloader 启动时扫描此目录读取每个程序集上的BepInPlugin特性按BepInDependency声明排序后依次实例化。doorstop_config.ini注入开关。除enabled与target_assembly外Mono 段还有dll_search_path_override BepInEx/core用于让 Mono 从正确位置找mscorlib等基础库。这些路径常量在 BepInEx.Core/Paths.cs 中统一定义。两个真实使用场景场景一定位插件没生效目标搞清楚插件为何没出现在运行列表里。 操作把BepInEx/config/BepInEx.cfg中的日志级别从Info改为Debug重启游戏。 效果LogOutput.log会额外输出类型解析与依赖检查记录缺依赖、版本不符等问题一目了然。场景二启动黑屏时合并引擎日志目标黑屏看不到任何报错需要引擎侧信息。 操作将doorstop_config.ini的redirect_output_log由false改为true重启。 效果Unity 原本的output_log.txt内容并入 BepInEx 日志一次看全引擎侧与应用侧输出。故障对照表症状可能原因处理方式游戏直接进原版无 BepInEx 日志注入层未生效enabled false、target_assembly路径写错或winhttp.dll/libdoorstop.so缺失核对 ini 两行配置确认注入库文件存在于游戏根目录plugins/有 dll 但日志里没有该插件类上缺BepInPlugin特性或依赖的插件未安装日志级别调Debug重看补齐缺失依赖Mono 游戏启动即崩溃游戏剥离了mscorlib运行时找不到基础库确认[UnityMono]段dll_search_path_override指向BepInEx/coreLinux/macOS 脚本直接退出未填游戏可执行文件名在run_bepinex_mono.sh中设置executable_name或以第一个参数传入最小可运行示例插件开发的最小形态是一个继承BaseUnityPlugin的类基类在 BepInEx.Unity.Mono/using BepInEx; using BepInEx.Configuration; namespace MyFirstPlugin { [BepInPlugin(com.you.myfirstplugin, MyFirstPlugin, 1.0.0)] public class MyFirstPlugin : BaseUnityPlugin { private void Awake() { var cfg Config.Bind(General, Enabled, true, 是否启用); Logger.LogInfo($插件加载完成, Enabled{cfg.Value}); } } }编译出的 dll 丢进BepInEx/plugins/即会被 Chainloader 加载。发布建议GUID 一旦确定就不要改依赖方靠它匹配版本用 SemVer有前置插件时加[BepInDependency]特性声明规则见 BepInEx.Core/Contract/。下一步BepInEx 的工作流到这就闭环了装包、看日志、放插件、改配置。下一步建议先按场景一把日志级别调到Debug完整跑一遍你的游戏熟悉LogOutput.log的输出格式再开始写第一个插件。关键词参考核心关键词BepInEx插件框架、Unity游戏插件加载、游戏模组开发长尾关键词BepInEx怎么安装到Unity游戏、BepInEx插件目录在哪里、BepInEx启动失败怎么排查、doorstop_config.ini参数怎么改、BepInEx日志文件在哪看【免费下载链接】BepInExUnity / XNA game patcher and plugin framework项目地址: https://gitcode.com/GitHub_Trending/be/BepInEx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
