星露谷物语：启动项设置教程（装完 SMAPI 后必做这一步）

2026年10月15日 · 使用教程

先讲清楚为什么必须做这一步：

SMAPI 的官方安装器不会改名游戏本体的 Stardew Valley.exe（这是官方行为，不是我们的问题）。所以装完 SMAPI 后，如果你还是直接点 Steam 的「开始游戏」，进的是原版游戏——模组一个都不会加载，看起来就像"装了个寂寞"。

要让游戏带着模组启动，只有两条正确的路：用模组加加启动，或者给 Steam 设置启动选项。下面分别说明，任选一种即可。

方法一：用模组加加启动（最省事，推荐）

在主界面底部点 「启动选项」，打开设置窗口。
启动方式选「直接启动（直接启动游戏主程序）」。
启动程序这一栏点右边的「定位」按钮，选中你游戏目录里的 StardewModdingAPI.exe。
- 游戏目录一般在 ...\steamapps\common\Stardew Valley\（嫌麻烦可以在 Steam 里右键游戏 → 管理 → 浏览本地文件，从地址栏复制路径）。
- 你在这个目录里应该能看到 StardewModdingAPI.exe（装 SMAPI 之后才有）。
下面「此游戏的额外配置」两栏建议按这样填（大多数情况下软件已经填好，不用动）：
- 主进程名（关闭游戏时需要）：StardewModdingAPI.exe
  
  这一栏决定了管理器的「关闭游戏」能不能找到游戏进程。填成 Stardew Valley.exe 的话，用 SMAPI 启动后是找不到进程的。
- STEAM ID（使用 steam 启动游戏时需要）：413150（星露谷物语的 Steam AppID）
点 「保存配置」。以后每次直接点主界面右下角的 「启动游戏」 就行——管理器会拉起 SMAPI，你会先看到 SMAPI 的控制台窗口（黑底白字，显示加载了哪些模组），然后游戏跟着启动。

注意：如果你把「启动方式」选成 Steam启动，那走的是 Steam 的启动流程，Steam 拿到的还是原版 Stardew Valley.exe —— 这时必须配合下面的方法二，否则模组依旧不生效。

这样设置后，从 Steam 启动就是带模组的，同时 Steam 的成就、覆盖层、游玩时长统计都正常。

"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%

如果你的游戏装在别的盘/别的目录，只需改引号里的那段路径，让它指向你游戏目录里的 StardewModdingAPI.exe。比如装在 G:\SteamLibrary\... 就写成：

"G:\SteamLibrary\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%

这行容易写错的三个地方（官方文档特别强调）：

🔴 两边的引号必须保留 —— 路径里有空格时，没有引号 Steam 会截断路径、找不到程序。
🔴 %command% 不能删 —— 它是 Steam 传给游戏的原始启动参数，少了它 Steam 会认为程序启动异常（覆盖层、成就、时长统计都会失效）。
🔴 路径要真实存在 —— 写完后确认这个 StardewModdingAPI.exe 确实在游戏目录里（装了 SMAPI 才有）。

启动后如果先出现 SMAPI 的控制台窗口（标题类似 SMAPI 4.x.x with Stardew Valley 1.6.x，并列出正在加载的模组），就说明走对了。

如果没看到 SMAPI 控制台、直接进了游戏标题画面 —— 那就还是启动的原版，回头检查：

现象	原因 / 解决
模组加加点「启动游戏」弹「您配置的启动程序不存在！请重新配置哦。」	游戏目录或 `StardewModdingAPI.exe` 路径变了（重装游戏、换盘、更新过 SMAPI），点「定位」重新选一次即可
点「关闭游戏」没反应 / 检测不到游戏	「主进程名」要填 `StardewModdingAPI.exe`（用 SMAPI 启动后，游戏的主进程是 SMAPI）
Steam 启动后没有成就、没有覆盖层	启动选项那一行漏了 `%command%`
想原版和模组版分开启动	可选做法：Steam → 游戏 → 添加非 Steam 游戏 → 选 `StardewModdingAPI.exe`，库里会多一个条目，原版条目保留

一句话总结：装完 SMAPI 后，要么在模组加加的「启动选项」里把启动程序指到 StardewModdingAPI.exe，要么在 Steam 的属性里填 "…\StardewModdingAPI.exe" %command%。二选一，别都不做。