Mod 不加载?先查这 6 件事

星露谷 mod 不加载,绝大多数是这 6 个原因之一:没有通过 SMAPI 启动游戏、mod 放错了文件夹、缺少前置 mod、mod 版本太旧、同一个 mod 装了两份、SMAPI 本身过旧。把 SMAPI 日志贴进检测工具,就能知道是哪一个。

  1. 游戏没有通过 SMAPI 启动

    只有用 SMAPI 启动游戏,mod 才会加载。如果没看到 SMAPI 的黑色控制台窗口,mod 就没在运行。

    怎么修: Steam(Windows):右键星露谷物语 → 属性 → 启动选项,填入 "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%(游戏装在别处就改成你的路径),之后照常从 Steam 启动。

  2. Mod 放错了位置

    每个 mod 都要在 Mods 里有自己的文件夹,文件夹里要有 manifest.json。

    怎么修: 先解压,不要把 .zip 直接丢进 Mods。打开 mod 文件夹:如果里面只有另一个文件夹,把里面那层移到 Mods 下。

  3. 缺少前置 mod

    很多 mod 需要 Content Patcher、SpaceCore 这类框架。缺了的话,SMAPI 会跳过它,并提示 “requires mods which aren't installed”。

    怎么修: 把 mod 页面 Requirements 里列出的前置全部装上。检测工具会写出缺的是哪个,并附上搜索链接。

  4. Mod 太旧,和当前游戏不兼容

    星露谷 1.6 让很多老 mod 失效,SMAPI 会标记为 “no longer compatible” 或 “broken”。

    怎么修: 去 mod 页面找新版本。没有的话就移除,或者到 smapi.io/mods 找非官方更新。

  5. 同一个 mod 装了两份

    两个文件夹用同一个 mod ID,SMAPI 只能加载其中一个。常见于更新 mod 时没删旧文件夹。

    怎么修: 保留最新的文件夹,删掉另一个。

  6. SMAPI 版本太旧

    新 mod 往往需要更新的 SMAPI,日志里会写某个 mod 需要更高版本的 SMAPI。

    怎么修: 到 smapi.io 下载最新版 SMAPI,重新运行安装程序,原有的 mod 会保留。

现在就检测你的整合包?

大多数整合包几秒就能查完,什么都不上传。

打开检测工具