提示 Game GML change、需要新版 MOMI 怎么办

看到 “Game GML change caused by game update. Unable to install. A new version of MOMI required when available.” 时，先停止反复安装，核对版本。它与“没有检测到模组文件夹”不是同一个问题。

  1. 记下游戏和 MOMI 的实际版本，退出游戏，保存一份带日期的存档副本。
  2. 游戏 1.0.5 对应的作者发布记录是 MOMI v0.16.4：9 月 18 日更新了 MMAPI 支持。从作者发布页取得，不要继续使用旧教程的下载版本。
  3. 逐个查看模组更新说明。该版移除了 monster.draw；依赖它的模组需要作者适配。仍调用旧函数 gpu_set_extra 的模组，也要适配引擎改名后的 gpu_set_draw_kind。只升级 MOMI 不代表这些模组已修好。
  4. 暂停不兼容的包，按卸载并恢复先确认原版能运行，再逐个装回作者明确支持的包。
  5. 版本已匹配却仍报错时，保留完整报错、游戏／MOMI 版本及启用列表，交给作者排查。不要删存档，也不要反复安装同一组不受支持的版本。

**完成检查：**安装不再出现兼容错误，临时存档能进入游戏。游戏若已高于 1.0.5，不能据此认定 v0.16.4 支持，先查作者后续发布记录。

官方态度与兼容门槛

NPC Studio 在新引擎说明中明确旧引擎模组都要更新，并提醒模组存档跨引擎时可能出问题。官方建议启动新引擎前卸载或更新模组，但没有发布模组 API、指定加载器或认可商店。MOMI、MMAPI 和 Nexus Mods 都是第三方项目。

模组环境出现卡顿时，先按下方性能排查表建立可回退的基线，再改设置。

2026 年 7 月的引擎迁移改变了文件结构，MOMI 文档说明此前的模组都要更新。新包使用 manifest.toml，围绕 data.win、YYToolkit、Aurie 或注册表注入的旧教程已经过时。本指南采用 MOMI v0.16.4 文档，安装前仍须查看仓库与单个模组作者页。

下载检查清单

  1. 页面写明适配新引擎及你的游戏版本。
  2. MOMI、MMAPI、框架与前置版本吻合。
  3. 文件和更新记录来自同一作者页。
  4. 卸载说明交代存档残留与依赖。
  5. 页面没有写清兼容或卸载方法时跳过该包。

存档备份与文件验证分开做

先退出游戏，再复制 Windows 的 %LOCALAPPDATA%\FieldsOfMistria。副本放在游戏目录外并标日期。另记下游戏、MOMI 和模组版本。

存档副本用于恢复玩家数据。Steam 文件验证只修复安装文件，不会回滚存档或清掉模组数据。Steam Deck 或 Linux 玩家可使用当前支持页与 Steam 存储视图定位存档，不要照搬旧教程路径。

安全安装

只用作者的 Nexus 页面或 canonical GitHub 仓库，并核对文件、前置与更新记录。发布提交的 verified signature 不能认证另一个镜像下载。文件来源与作者页不一致时立即停止。

当前 MOMI 安装顺序

  1. 从 Garethp GitHub Releases 取得作者要求的 MOMI 稳定版。
  2. Windows 在游戏目录创建 mods，它与 FieldsOfMistria.exe 同级。
  3. Linux 可在游戏目录建 mods，也可在主目录建 mistria-mods。
  4. 解压模组，让其文件夹直接位于上述目录内，根部能看到 manifest.toml。
  5. 打开 MOMI，核对位置和已检查的包，再使用 Install。
  6. 每次只加一个新模组，先用临时存档测试，再打开重要存档。

不要运行短链接、网盘、聊天附件或镜像里的安装器。不要关闭系统防护。模组求助不需要 Steam 密码、Cookie、两步验证码或付费游戏文件。

游戏更新后处理

游戏更新后，先卸载或更新模组。重新运行 MOMI。等作者页确认兼容，再逐个装回。

  1. 关闭游戏，再做一份带日期的存档备份。
  2. 记下最后一次正常运行的游戏、MOMI 和各模组版本。
  3. 大型引擎更新前，先卸载由安装器管理的模组层。
  4. 只从原作者发布页更新 MOMI 与模组。
  5. 先启动原版，再逐个加入版本匹配的模组。

卸载并恢复

回滚顺序

  1. 退出游戏，再做一份带日期的存档副本。
  2. 使用当前 MOMI 的 Uninstall 撤回它管理的改动。
  3. 在 Steam 的 Properties 与 Installed Files 内运行 Verify integrity of game files。
  4. 不装模组启动游戏，用临时或复制存档测试。
  5. 只装版本吻合的模组，每装一个就检查一次。

单个模组没有通用卸载结论。自定义物品或数据可能留在存档，应遵循作者说明并保留备份。原版能启动而模组存档不能时，停止加文件，提交版本信息，不要删除唯一存档。

性能与启动问题排查

不装模组也卡：先固定一条测试路线

先记录标题页的实际版本、硬件、显示模式和一条短路线。用当前安装的版本作对照，不要为了跟旧攻略一致而降级到 1.0.2。突然停顿、持续低帧、画面横向撕裂要分别记录；每次改完都走同一路线比较。有模组时，先备份存档，按上方流程测试干净安装。

按官方排查页，先核对最低配置并更新系统、显卡驱动。Windows 在 Graphics Settings → Options → High performance 为游戏选择高性能显卡。

顺序游戏内 Graphics 设置
先试Fullscreen 全屏，非无边框；VSync 选 On，支持时可试 Adaptive。
无效再试Fullscreen；VSync Off；60 FPS 上限 On；Snap Frame Rate Off。

失败就恢复原值。再分别试亮度／饱和度回中点、提高 In-Game Scale，或降低分辨率／缩小窗口并关闭 Smooth Camera Tracking。VSync、Snap 和帧率上限全关是官方的最后尝试，可能更卡。

仍有问题时，用上方官方页面的报错表提交设备信息和复现路线，注明实际版本及无模组是否仍失败。不要删存档来测性能。

MOMI 找不到游戏或模组

现象处理步骤
找不到游戏位置把 MOMI 放到游戏目录的 Maybe.toml 旁，再重新打开。
找不到模组文件夹在 Maybe.toml 旁创建 mods；Steam Deck/Linux 也支持用户目录里的 mistria-mods。
没有检测到模组先解压 ZIP，确认目录为 mods/模组名/manifest.toml，中间不能再套一层同名文件夹。
安装后没有新外观用适配的 MOMI 版本重新安装，再查看作者写的获取方式和杂货店，物品不一定直接进入背包。

以上对应 MOMI v0.16.4 文档的排错步骤。下载时仍要采用模组作者声明支持的版本。

现象处理
还没到标题画面就退出通过 MOMI 卸载，验证 Steam 文件，再测试无模组启动。
原版能进、模组存档不能进用存档副本测试，恢复所需模组版本，并按作者卸载说明处理。
新增一个模组后开始卡顿只禁用这个新模组，在同一路线复现并比较帧率表现。
游戏更新后才出问题暂停所有模组，直到 MOMI 与每个启用包都明确支持该补丁。
重装后问题不变检查旧引擎迁移前文件是否残留，再次验证游戏文件。

每次测试只改一个变量。保留未动过的可用备份，绝不能靠删除唯一存档来排查性能。

先更新 v1.0.5，再复测同一个场景

9 月 18 日补丁改善帧时间、高刷新率显示器表现，以及低于 60 FPS 时的运行；也优化了掌机常用的 30 FPS 设置，并修复打开宝箱时的减速。先在 Steam 更新，再回到原来卡顿的位置，重复同一操作，对比前后表现，记录版本与帧率设置。不同电脑的改善幅度不能预先保证。

亲吻导致崩溃时，还要检查是否下载了公告末尾追加的热修复。本次也修复了节日配偶日程、叠石怪战斗和模组背包容量相关的部分崩溃。修复一种模组背包崩溃，不代表全部模组都已兼容。官方补丁与热修复说明。