Mod 不加载?先查这 6 件事
星露谷 mod 不加载,绝大多数是这 6 个原因之一:没有通过 SMAPI 启动游戏、mod 放错了文件夹、缺少前置 mod、mod 版本太旧、同一个 mod 装了两份、SMAPI 本身过旧。把 SMAPI 日志贴进检测工具,就能知道是哪一个。
游戏没有通过 SMAPI 启动
只有用 SMAPI 启动游戏,mod 才会加载。如果没看到 SMAPI 的黑色控制台窗口,mod 就没在运行。
怎么修: Steam(Windows):右键星露谷物语 → 属性 → 启动选项,填入
"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%(游戏装在别处就改成你的路径),之后照常从 Steam 启动。Mod 放错了位置
每个 mod 都要在
Mods里有自己的文件夹,文件夹里要有manifest.json。怎么修: 先解压,不要把 .zip 直接丢进 Mods。打开 mod 文件夹:如果里面只有另一个文件夹,把里面那层移到 Mods 下。
缺少前置 mod
很多 mod 需要 Content Patcher、SpaceCore 这类框架。缺了的话,SMAPI 会跳过它,并提示 “requires mods which aren't installed”。
怎么修: 把 mod 页面 Requirements 里列出的前置全部装上。检测工具会写出缺的是哪个,并附上搜索链接。
Mod 太旧,和当前游戏不兼容
星露谷 1.6 让很多老 mod 失效,SMAPI 会标记为 “no longer compatible” 或 “broken”。
怎么修: 去 mod 页面找新版本。没有的话就移除,或者到 smapi.io/mods 找非官方更新。
同一个 mod 装了两份
两个文件夹用同一个 mod ID,SMAPI 只能加载其中一个。常见于更新 mod 时没删旧文件夹。
怎么修: 保留最新的文件夹,删掉另一个。
SMAPI 版本太旧
新 mod 往往需要更新的 SMAPI,日志里会写某个 mod 需要更高版本的 SMAPI。
怎么修: 到 smapi.io 下载最新版 SMAPI,重新运行安装程序,原有的 mod 会保留。