UnityModManager安装教程：3步为游戏启用Mod支持（附5个常见坑）
【免费下载链接】unity-mod-managerUnityModManager项目地址: https://gitcode.com/gh_mirrors/un/unity-mod-manager
UnityModManager（常简称UMM）是一款开源的Unity 游戏 Mod 加载器，专门给基于 Unity 引擎制作的游戏"装上 Mod 支持"。它通过向游戏注入一个启动器、并内置 Harmony 热补丁框架，让你在不改游戏原始文件的前提下，一键启用、切换和管理各种 Mod。本教程用3 步带你完成 UnityModManager 安装，并附上新手最容易踩的5 个坑，帮你一次装成功。
运行环境：以 Windows 为主，同时兼容 Linux / macOS 上的 Mono 版游戏。
一、UnityModManager 能做什么（1 分钟看懂）
- 零门槛启用 Mod：无需手动改
Assembly-CSharp.dll，UMM 自动完成注入与补丁。 - 游戏内开关 Mod：进入游戏后按
F5呼出 Mod 管理窗口，勾选即可启停。 - 安全可回滚：安装前自动备份原文件（
.original_/.backup_），随时可还原。 - 拖拽装 Mod：在 Mods 标签页直接把
.zip拖进去即可安装。
核心源码：Form.cs（主安装窗口）、Injector.cs（注入逻辑）、ModManager.cs（Mod 调度）。
二、安装前准备
- 从官方发布渠道下载最新UnityModManager 压缩包（发布地址见 README.md）。
- 将压缩包完整解压到一个独立目录（如
D:\UMM），不要解压进游戏文件夹（这是后文的坑 3）。 - 确保游戏已正常安装并至少启动过一次，生成完整游戏文件。
💡 UMM 会读取 Steam 注册表自动定位游戏，Steam / GoG 用户基本无需手动设置路径。
三、3 步完成 UnityModManager 安装
第 1 步：选择游戏并确认游戏目录
双击运行UnityModManager.exe，在顶部下拉框中选择目标游戏。UMM 会自动扫描Steam 安装目录（如Steam\SteamApps\common\你的游戏）定位路径。自动扫描逻辑见 Utils.cs 的FindGameFolder。
若未自动识别，点击Select，手动选择游戏根目录——即直接包含.exe、且带Data文件夹的那一层。
第 2 步：确认安装方式（一般无需手动改）
UMM 会根据游戏情况自动选择注入方式：
- Assembly（默认）：直接补丁游戏主程序集，适合绝大多数游戏；
- DoorstopProxy：当游戏目录已存在
winhttp.dll时自动启用，改用代理 DLL 方式。
自动判定逻辑见 Form.cs。普通用户保持默认即可。
第 3 步：点击 Install 注入，游戏内按 F5 管理
点击Install后，UMM 会：备份原文件 → 把UnityModManager.dll、0Harmony.dll等复制到Data/Managed/UnityModManager/→ 写入启动配置Config.xml。看到Installation was successful.即完成。
现在启动游戏，按 F5打开 Mod 管理窗口（按键定义见 KeyBinding.cs），即可勾选 / 关闭各个 Mod。
四、新手最容易踩的 5 个坑
坑 1：游戏目录没选对（缺 exe 或缺 Data 文件夹）
现象：点 Select 后按钮变红、Install 一直灰色。原因：必须选到含.exe的根目录，且能递归找到Data/.../Managed并含Assembly-CSharp.dll或UnityEngine.dll。常见错误是选到了Data里面或层级不对。见 Utils.cs。
坑 2：IL2CPP 游戏不支持
现象：日志提示This game version (IL2CPP) is not supported.。原因：很多新版/移植游戏采用IL2CPP（编译为原生代码），UMM 的托管补丁对它无效，标志是目录里存在GameAssembly.dll。见 Form.cs。
坑 3：把 UMM 安装包放进游戏文件夹
现象：Install 按钮置灰、无法安装。原因：UMM 会检测自己是否被放进游戏目录（向上追溯 3 层父目录），是则拒绝。请把 UMM 放独立目录。见 Form.cs。
坑 4：权限不足（游戏装在 Program Files）
现象：点 Install 没反应 / 报does not have write permission。原因：UMM 需向游戏目录写文件。若游戏装在C:\Program Files\...等受保护目录，请以管理员身份运行 UMM。见 Form.cs。
坑 5：游戏自带旧版 0Harmony.dll 冲突
现象：提示游戏里存在额外的0Harmony.dll，建议删除。原因：UMM 需要 Harmony 2+，游戏自带的旧版0Harmony.dll会冲突，按提示删除那个多余的 DLL（别误删 UMM 自己的）。见 Form.cs。
五、卸载与还原（安全网）
- Remove：完整卸载 UMM 注入的 Mod 支持。
- Restore：从
.original_备份还原原始程序集。
逻辑见 Form.cs；备份机制见 Utils.cs。
六、常见问题速查（FAQ）
- Q：装完游戏启动闪退？A：多为坑 2（IL2CPP）或坑 5（Harmony 冲突），先查看 UMM 目录内的日志定位。
- Q：能同时装多个 Mod 吗？A：可以，在 F5 窗口各自勾选；相互冲突的 Mod 请只保留一个。
- Q：换游戏要重装吗？A：要。UMM 的注入是按游戏目录的，换游戏重新走一遍 3 步即可。
📌 小结：选对目录 → 保持默认方式 → 点 Install → 游戏内按 F5，四件事做好，99% 的 Unity 游戏都能顺利启用 Mod。
【免费下载链接】unity-mod-managerUnityModManager项目地址: https://gitcode.com/gh_mirrors/un/unity-mod-manager
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
