如何让你的 Unity 游戏跑起 MODMelonLoader 模组加载器完全指南【免费下载链接】MelonLoaderThe Worlds First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono项目地址: https://gitcode.com/gh_mirrors/me/MelonLoader你给一款 Steam 游戏找到了心仪的模组却发现游戏是 Il2Cpp 架构、目录里没有任何 C# 程序集模组根本装不进去。MelonLoader 就是一个同时支持 Il2Cpp 和 Mono 双架构的 Unity 游戏模组加载器不改游戏一行代码把两个文件拷进游戏目录游戏启动时就会弹出控制台自动发现并加载Mods文件夹里的所有模组。先花 30 秒判断你的游戏能不能跑MelonLoader 的兼容性覆盖两种 Unity 编译架构平台支持情况如下| 运行环境 | 支持情况 | 说明 | | - | - | - | | Windows | 完整支持 | 通过代理 DLL 注入最成熟的环境 | | LinuxWine / Proton | 支持 | 能识别 Wine 环境并自动调整加载策略 | | Linux原生 | 支持 | 通过 PLT hook 注入底层代码在MelonLoader.Bootstrap/Utils/PltHook.cs| | macOS | 支持 | 内置启动脚本melonloader-launch.sh位于MelonLoader.Bootstrap/OSXEntry/|唯一的硬性前提按架构区分Il2Cpp 游戏需要安装 .NET 6.0 Desktop RuntimeWindows 下会自动安装其他平台需自备Mono 游戏无额外要求启动时由内置的 Mono 运行时直接接管只需往游戏目录拷两个文件手动安装以官方发布包为例完整流程只有 3 步确认游戏已完全关闭把压缩包里的MelonLoader文件夹解压到游戏安装目录把压缩包根目录的version.dll和dobby.dll也解压到与游戏主程序同级这里的关键是version.dll——它是一个代理 DLLProxy利用 Windows 会优先加载同名系统库的特性在游戏启动瞬间把 MelonLoader 本体带进进程。如果某些游戏不认这个名字可以把它重命名为winmm.dll、dinput8.dll、d3d9.dll、dsound.dll等完整的 14 个可选名称可以在MelonLoader.Bootstrap/Proxy/Exports/目录里逐一对照那里为每个名称都实现了导出函数。第一次启动你会看到什么游戏正常进入后有三样东西值得认识启动画面加载期间播放动画 Logo源码在Dependencies/MelonStartScreen/支持 Normal 和 Lemon 两套主题悬浮控制台实时显示模组注册顺序、加载进度颜色对应不同模组日志与配置所有日志写入游戏目录下的MelonLoader/Logs配置文件UserData/Loader.cfg在第一次运行后才会生成加载顺序不是随机的MelonLoader/InternalUtils/DependencyGraph.cs会先按声明的依赖做拓扑排序再用MelonPriorityAttribute排优先级结果都会打印在控制台里。写你的第一个模组五行 C#模组就是一个继承自MelonMod定义在MelonLoader/Melons/MelonMod.cs的类编译出的 dll 放进Mods文件夹即可[MelonInfo(typeof(MyMod), MyMod, 1.0.0, me)] public class MyMod : MelonMod { override public void OnInitialize() MelonLogger.Msg(Hello from MyMod!); }几个要点[MelonInfo]里的名称、版本、作者是必填项版本遵循 SemVer 规范解析逻辑见MelonLoader/Attributes/MelonInfoAttribute.cs生命周期回调如OnInitialize、OnSceneWasLoaded直接覆写即可事件定义集中在MelonLoader/MelonEvents.cs改游戏逻辑不用改原代码内置 Harmony0Harmony兼容层在MelonLoader/BackwardsCompatibility/Harmony/对方法打前缀/后缀补丁Il2Cpp 游戏的特殊处理首次运行时Dependencies/Il2CppAssemblyGenerator/会基于 Cpp2IL 和 Il2CppInterop 从原生代码反推出一套 C# 程序集供你的模组引用顺带一提Dependencies/CompatibilityLayers/还内置了对 Illusion 系 IPA、Muse Dash、Stress Level Zero 等旧模组框架的包装老模组也能跑起来给模组配一个设置面板TOML 偏好系统MelonLoader 的偏好系统MelonLoader/Preferences/让模组作者可以声明式地创建配置项自动落盘为 TOML 文件玩家改文件后自动热更新重启后保留。核心 API 就两步[MyMod] sensitivity 0.75 show_hud truevar cat MelonPreferences.CreateCategory(MyMod, MyMod 设置); var entry cat.CreateEntryfloat(sensitivity, 1.0f, 灵敏度);每个条目可以附默认值、显示名和校验器ValueValidator非法值会被拒绝而不是让模组崩掉。常用 Loader.cfg 配置项对照表UserData/Loader.cfg中的每个配置项都有等价的启动参数两处任选其一| 配置项 | 默认值 | 作用 | 等价启动参数 | | - | - | - | - | |disable|false| 完全禁用加载器 |--no-mods| |debug_mode|true| 开启调试模式控制台标题加[D]标识 |--melonloader.debug| |capture_player_logs|true| 把游戏自身日志一并收进 MelonLoader 日志 |--melonloader.captureplayerlogs| |harmony_log_level|Warn| Harmony 日志级别可选 None/Error/Warn/Info/Debug/IL |--melonloader.harmonyloglevel| |force_quit|false| 修复部分游戏退出时进程挂起的问题 |--quitfix| |disable_start_screen|false| 关闭启动画面 |--melonloader.disablestartscreen| |theme|Normal| 控制台/启动画面主题可选 Lemon |--melonloader.consolemode| |max_logs|10| 日志文件保留份数 |--melonloader.maxlogs| |launch_debugger|false| 启动时等待 .NET 调试器附加仅 Il2Cpp |--melonloader.launchdebugger|完整的启动参数表含 Cpp2IL、Mono 调试服务器等都在README.md的 LAUNCH OPTIONS 一节里。模组不加载时日志在哪、怎么对比排查按顺序做基本能定位 90% 的问题看日志MelonLoader/Logs里最新一份失败原因写得很直白。加载失败的模组会被标记为烂瓜RottenMelon见MelonLoader/Melons/RottenMelon.cs日志里会有对应条目隔离对比用--no-mods启动确认游戏本体正常再逐个移除模组做二分开调试模式debug_mode true时控制台输出更详细Il2Cpp 游戏还可以设launch_debugger true直接挂调试器确认版本匹配CHANGELOG.md记录了每个版本的行为变更模组要求的加载器版本与当前版本最新为 v0.7.3不一致时先看这段记录下一步去哪查参数README.md里有全部配置项、启动参数和代理 DLL 命名表参与开发源码用dotnet构建根目录compile.sh封装了跨平台编译流程参数为版本号、RID、配置git clone https://gitcode.com/gh_mirrors/me/MelonLoader跟进版本CHANGELOG.md和RELEASE-NOTES.md同步更新项目采用 Apache 2.0 许可【免费下载链接】MelonLoaderThe Worlds First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono项目地址: https://gitcode.com/gh_mirrors/me/MelonLoader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考