MelonLoader 快速上手教程5 分钟为 Unity 游戏装好 Mod 加载器【免费下载链接】MelonLoaderThe Worlds First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono项目地址: https://gitcode.com/gh_mirrors/me/MelonLoaderMelonLoader 是一款通用的 Unity 游戏 Mod 加载器也是市面上少有的同时支持 Il2Cpp 和 Mono 两种 Unity 运行时架构的开源方案。你不需要再为不同游戏维护不同的注入工具一个加载器就能覆盖新旧两代 Unity 项目。它通过一个代理 DLL在游戏启动时抢先加载自身随后把插件Plugins和模组Mods注入到游戏进程中运行。本文面向想给自己的 Unity 游戏加装 Mod 的玩家和想写 Mod 的开发者从安装到日常排错一次讲清楚。先分清你的游戏属于哪种架构装之前花 30 秒确认游戏用的是哪种运行时这直接决定你的准备事项运行时典型特征MelonLoader 的额外要求MonoUnity 传统脚本运行时游戏目录下有Managed文件夹无额外依赖Il2CppC# 编译为原生 C有Game.il2cpp、Game_Data内无托管 DLL需要 .NET 6.0 Desktop RuntimeWindows 下由 MelonLoader 自动安装简单判断方法看游戏安装目录里是否存在Game_Data/Managed文件夹有就是 Mono。Il2Cpp 游戏在首次启动时MelonLoader 会在后台用 Cpp2IL 等工具把原生代码转回 C# 程序集并缓存到MelonLoader/Il2CppAssemblies目录所以第一次启动会比平时慢一些属于正常现象。MelonLoader 安装步骤三条路径任选路径一官方安装器推荐。从发布页下载对应平台的安装器Windows 的MelonLoader.Installer.exe、Linux 的MelonLoader.Installer.Linux、macOS 的MelonLoader.Installer.MacOS.dmg运行后选择游戏目录即可。Linux 用户需要先赋予执行权限chmod x MelonLoader.Installer.Linux ./MelonLoader.Installer.Linux路径二手动安装。适合想完全掌控每一步的用户只需三步关闭游戏下载发布页的 MelonLoader 压缩包把压缩包中的MelonLoader文件夹解压到游戏安装目录把压缩包里的version.dll和dobby.dll放到游戏安装目录根下路径三源码编译。想改加载器本身可以克隆仓库后编译仓库内置了compile.sh脚本核心就是带平台参数跑dotnet buildgit clone https://gitcode.com/gh_mirrors/me/MelonLoader cd MelonLoader bash compile.sh 0.7.3 win x64 Release卸载时把version.dll和MelonLoader文件夹删掉即可若想彻底清干净可再删Plugins、Mods、UserData三个目录。装完之后游戏目录长这样启动一次游戏后MelonLoader 会自动创建以下结构这也是你日常放 Mod 的位置游戏根目录/ ├── version.dll # 代理 DLL游戏启动时加载它的钩子 ├── MelonLoader/ # 加载器本体与缓存 │ ├── Logs/ # 运行日志排错主要看这里 │ └── Il2CppAssemblies/ # Il2Cpp 游戏的程序集缓存 ├── Plugins/ # 插件目录面向框架类扩展 ├── Mods/ # 模组目录每个 Mod 一个文件夹 │ └── MyMod/ │ ├── manifest.json # Mod 元信息清单 │ └── MyMod.dll # Mod 主程序集 └── UserData/ └── Loader.cfg # 加载器主配置TOML 格式关于插件和模组的区分Plugins 更偏向功能框架和底层扩展Mods 是面向玩家的具体内容两者可以共存且加载顺序上插件先于模组。两个容易忽略的小机制值得知道实现见 MelonLoader/Melons/MelonFolderHandler.cs子文件夹也会被扫描但子文件夹内必须包含manifest.json才会被识别方便大型 Mod 包分目录管理重命名即禁用把 Mod 文件夹改名为Broken、Retired、Disabled或加~、.前缀加载器就会跳过它不用来回删文件核心配置Loader.cfg 与启动参数配置文件在UserData/Loader.cfg首次运行后自动生成。你 90% 的调参需求集中在前两个分区[loader] disable false # 置 true 等于不加载任何 Mod debug_mode true # 调试模式开发时打开 capture_player_logs true # 连 Unity 被禁用的日志也一并捕获 theme Normal # 控制台主题可选 Lemon [console] hide_console false # 隐藏控制台窗口 console_on_top false # 控制台始终置顶不想改文件的话几乎所有配置项都对应一个启动参数效果等价启动参数作用--no-mods本次启动不加载任何插件和模组--melonloader.debug开启调试模式--melonloader.hideconsole隐藏控制台--melonloader.consolemode4切换 Lemon 主题0 为 Normal--quitfix修复部分游戏退出时进程挂起的问题--melonloader.harmonyloglevelInfo调整 Harmony热补丁框架日志详细程度Il2Cpp 玩家还可能用到--melonloader.agfoffline离线生成程序集不访问远程 API和--melonloader.agfregenerate强制重新生成程序集缓存。完整参数列表见 MelonLoader.Bootstrap 下的启动参数解析逻辑。进阶玩法让加载器更贴合你的场景换代理 DLL 名称。version.dll不是唯一的入口名——部分游戏因为反作弊或加载顺序问题不吃它你可以把它重命名为winhttp.dll、winmm.dll、dinput8.dll、d3d11.dll等十几种兼容名称之一再放进游戏目录功能完全相同。默认名不好使时优先试winhttp.dll。多 Mod 冲突排查。给启动参数加--no-mods对比一次有 Mod 和一次无 Mod 的启动行为是最快的二分法。Mod 数量多时逐个把嫌疑 Mod 文件夹改名为Disabled来隔离比删文件安全。清理 Il2Cpp 缓存。游戏大版本更新后旧的Il2CppAssemblies缓存可能导致类型缺失或加载失败直接删掉该目录让 MelonLoader 重建即可首次启动会变慢。写自己的 Mod。Mod 入口是一个继承MelonMod的类类上用[MelonInfo]特性声明名称、版本和作者定义见 MelonLoader/Melons/Melon.cs程序集里再挂上[MelonGame]指明目标游戏 ID。加载器在扫描目录时会用 Cecil 预先读取每个 DLL 的特性没有[MelonInfo]的程序集会被直接跳过所以特性写错是最常见的Mod 不生效原因之一。MelonLoader 报错速查表遇到异常别慌先打开MelonLoader/Logs/latest.log然后对照这张表症状最可能原因处理方式游戏启动后闪退控制台无输出代理 DLL 未生效确认version.dll在游戏根目录换用winhttp.dll试试Il2Cpp 游戏卡在某处不动程序集正在生成看assembly_generation.log首次启动等待即可Il2Cpp 游戏报类型找不到缓存过期删除MelonLoader/Il2CppAssemblies重建游戏退出后进程不消失已知兼容问题加--quitfix启动参数控制台刷屏但看不到重点玩家日志太多配置里设capture_player_logs false或调低 Harmony 日志级别Mod 在日志中出现但功能无效特性缺失或版本不匹配核对[MelonInfo]特性用--melonloader.debug拿详细日志一个通用排查顺序--no-mods能正常启动→ 问题在 Mod 本身--no-mods也起不来→ 问题在加载器或环境先看日志再看缓存。下一步挑一个你正在玩的游戏把 MelonLoader 放进去跑一次--no-mods确认加载器干净启动——剩下的就只是往Mods文件夹里放东西了。装好第一个 Mod 的那一下你会明白为什么它叫 Melon甜瓜注入成功的那一刻是甜的。【免费下载链接】MelonLoaderThe Worlds First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono项目地址: https://gitcode.com/gh_mirrors/me/MelonLoader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
