如何在《星露谷物语》中安装Mod（2026）

一篇关于如何在 PC 上为 Stardew Valley（星露谷物语）下载并安装模组的指南。我们将介绍三种常见方法:手动安装模组(这是本游戏的标准方式)、Vortex(Nexus Mods 出品的模组管理器),以及 CurseForge app。

本指南主要面向 Windows,但 Stardew Valley 的模组在 Linux 和 macOS 上同样可用,我们会在有差异的地方特别注明。

Stardew Valley 是最容易上手模组的游戏之一。没有加载顺序需要处理,没有插件数量限制,没有 archive invalidation,也没有需要打补丁的东西。几乎每个模组都只是一个文件夹,你把它放到一个地方,游戏会在控制台窗口里告诉你是否加载成功。

有且只有一件事你需要先做对,那就是 SMAPI。它是让模组成为可能的加载器,Nexus 上几乎所有模组都依赖它。我们会先安装 SMAPI,然后以 Pathoschild 制作的 Tractor Mod 为示例模组,分别用三种方法安装在它之上。

Requirements

• 一份 PC 版 Stardew Valley(本指南使用 Steam 版)。
• 7-Zip 或任意其他解压软件。
• 一个免费的 Nexus Mods 账号(可选,但你会需要一个)。
• 对复制和移动文件夹有基本了解。

Game Version Notes

本文撰写时 Stardew Valley 的版本是 1.6.x,模组兼容性总体很好。在这款游戏里版本号的重要性不如大多数游戏,但有两点值得了解。

• SMAPI 必须与你的游戏版本匹配。 游戏更新后,SMAPI 通常一两天内也会更新,你只需安装新版本即可。这个过程通常很顺利。
• 模组可能会滞后。 大版本更新后,个别模组有时需要几天才能跟上。SMAPI mod compatibility list 会追踪哪些模组目前可用,是更新前最快的检查方式。

Steam、GOG 和 Xbox Game Pass 的 PC 版本都支持模组。Microsoft Store / Game Pass 版本需要额外几个步骤,smapi.io/install 有详细说明,因为 Windows 对该安装文件夹有额外保护。

Running Mods On Linux & macOS

Stardew Valley 在 ProtonDB 上评级为 Platinum,而且有原生 Linux 版本,所以这是在 Windows 之外比较容易安装模组的游戏之一。

SMAPI 的同一个下载包里附带了三个平台的安装程序 - install on Windows.bat、install on Linux.sh 和 install on macOS.command。运行适合你系统的那个,本指南其余部分的操作方式都是一样的。

NOTE - 在 Linux 和 macOS 上,安装程序会重命名游戏的启动器,而不是新增一个独立的可执行文件,所以你只需正常启动游戏,SMAPI 就会随之启动。不需要设置任何启动选项。

Back Up Your Saves!

Stardew Valley 中的模组可以且确实会写入你的存档文件。添加物品的模组会把这些物品放进你的存档,之后如果移除该模组,可能导致存档无法读取。

开始之前,先备份这个文件夹。

C:\Users\<user>\AppData\Roaming\StardewValley\Saves

在 Linux 上是 ~/.config/StardewValley/Saves,在 macOS 上同样是 ~/.config/StardewValley/Saves。

TIP - SMAPI 会安装一个内置模组,叫 Save Backup,它会每天自动备份你所有的存档。即使你不安装其他任何东西,这也是使用 SMAPI 的一个实实在在的理由。

What Is SMAPI?

SMAPI(Stardew Modding API)是一个模组加载器。它位于 Stardew Valley 和你的模组之间,为模组提供接入游戏的方式,并处理所有繁琐的部分,比如加载顺序、版本检查和错误处理。

实际使用中,你会注意到它做了三件事。

• 它会在你的游戏目录中创建并读取一个 Mods 文件夹。所有模组都放在这里。
• 它会在游戏旁边打开一个控制台窗口,列出加载了什么、出了什么问题。
• 它会捕获模组的错误,让出问题的模组打印一条信息,而不是让游戏崩溃。

Nexus Mods 上几乎所有模组都需要它。例外是那些直接覆盖游戏自身文件的内容替换包,而这类模组现在已经很少见了,因为 Content Patcher(它需要 SMAPI)能更好地完成同样的工作。

Installing SMAPI

Downloading SMAPI

从 smapi.io 或它的 Nexus Mods page 获取 SMAPI。两者是同一个下载文件,均由 Pathoschild 维护。

1. 通过 Vortex(模组管理器)下载:橙色的 Vortex 按钮会把文件交给模组管理器。
2. 手动下载:Manual 会通过浏览器下载压缩包。

这一部分我们要用手动下载,因为 SMAPI 有自己的安装程序。

1. 免费下载速度较慢,但免费:Slow download 会被限速到大约 1.5-3 MB/s,并且开始前有短暂延迟。SMAPI 大约只有 40 MB,所以无论如何都只需几秒钟。

Running The Installer

解压压缩包并打开里面的文件夹。

1. 运行这个来安装 SMAPI:install on Windows.bat。Linux 和 macOS 用户在同一个文件夹里有各自的脚本。
2. 如果需要,可参考手动安装步骤:README.txt 记录了手动安装的过程。你几乎肯定用不上它 - 安装程序才是推荐的方式,README 自己也是这么说的。

双击安装程序,它会询问你的游戏在哪里。

1. SMAPI 找到了游戏：它会扫描你的磁盘并列出找到的结果。输入 1 并按回车，或者如果需要手动指定位置，选择 2。

接下来它会询问你想要执行的操作。

1. 输入 1 并按回车：安装 SMAPI。选项 2 可以在以后干净地卸载它，如果你想让游戏恢复原版的话。

这只需要几秒钟，然后它会准确地告诉你接下来该做什么。

1. 把这个复制到你的 Steam 启动选项中：StardewModdingAPI.exe 的完整路径，后面跟着 %command%。请原样复制这一行——下一节会讲到它要粘贴到哪里。
2. 或者直接运行 StardewModdingAPI.exe：如果你不是通过 Steam 玩，这就是你需要做的全部。运行游戏文件夹里的这个文件，而不是运行游戏本体。

注意它在过程中做了什么：创建 mods 目录 以及 添加内置 mod——Console Commands 和 Save Backup。这两个文件夹出现在 Mods 里是正常的，应该保留它们。

设置 Steam 启动选项

在 Steam 上，你可以直接运行游戏文件夹里的 StardewModdingAPI.exe，但这样 Steam 就不知道游戏正在运行，你会失去成就、游戏时长统计和 Steam 悬浮窗。启动选项可以解决这个问题。

打开你的 Steam 库，右键点击 Stardew Valley 并选择 属性。

1. 右键点击游戏并打开属性：右键菜单底部的 属性 选项。

然后在 常规 标签页中找到 启动选项。

1. 在这里粘贴 SMAPI 路径，然后加上 %command%：SMAPI 安装器给你的那一行，包括引号也要一起粘贴。

它应该看起来像这样，只是路径换成你自己的。

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

警告 - 引号很重要，%command% 也是。没有引号，Steam 会在 "Stardew Valley" 的空格处截断路径；没有 %command%，Steam 就不会传递自己的参数。

提示 - 如果想在某次游玩时不使用 mod，只需清空启动选项框即可。什么都不会被卸载，游戏只是不通过 SMAPI 启动。

启动游戏

在 Steam 中点击 游玩，控制台窗口会随游戏一起打开。

1. SMAPI 加载的每一个 mod 及其版本：这里是 Console Commands、Save Backup 以及 Tractor Mod 4.24.4 by Pathoschild。如果某个 mod 不在这个列表中，说明它没有被加载，SMAPI 通常会在下面几行说明原因。

这个控制台窗口是这个游戏 mod 化过程中最有用的东西。让它一直开着——错误、警告和 mod 更新提示都会显示在这里，出问题时应该第一时间查看它。

注意 - SMAPI 还会对它已知可能冲突的软件发出警告，比如悬浮窗和监控工具。截图中关于 MSI Afterburner 的信息就是这种情况，它只是一个警告，而不是错误。

在哪里下载 Mod

主要来源是 Nexus Mods，上面有超过 30,000 个 Stardew Valley mod。

下面这些也值得了解。

• CurseForge - 第二大的来源，有自己的桌面应用。详见下文。
• ModDrop - 规模较小，但有些 mod 是它独占的。
• Stardew Valley Forums - 官方论坛的 mod 板块。
• TMC - 就是我们！我们还很新。

提示 - 在安装任何东西之前，先在 SMAPI mod 兼容性列表 上查一下。它由社区维护，可以搜索，能用一行文字告诉你某个 mod 是否适配你的游戏版本——这比翻三页评论要快得多。

我们要安装的 Mod

Tractor Mod 由 Pathoschild 制作，让你能从 Robin 那里购买一个拖拉机车库，然后开着拖拉机在农场里以较大范围收割、浇水、耕地和清理杂物。一旦你的农场变大，这就是一个巨大的生活质量提升。

它是一个很好的示例 mod，有三个原因：它很受欢迎、维护活跃，而且它的 Nexus 页面展示了一个让很多人感到困惑的小细节。

1. 这里只有一个 Manual 按钮：页面顶部没有橙色的 Vortex 按钮。这不意味着这个 mod 只能手动安装。
2. Files 标签页有 Vortex 按钮：切换到 FILES，每个文件都有自己的模组管理器按钮。

这是 Files 标签页。

1. 该文件所需的 SMAPI 版本："Requires SMAPI 4.1.10 or later." 总是值得看一眼——mod 所需的 SMAPI 版本高于你已安装的版本，是 mod 无法加载的两三个最常见原因之一。
2. 模组管理器下载（Vortex）：将文件交给 Vortex。
3. 手动下载：通过浏览器下载 .zip 文件。

注意列表中的第二个文件，Tractor Mod 4.24.3，标注为“仅限安卓手机玩家使用”。因为文件排在页面靠上位置就下载了旧版本，是很容易犯的错误。请仔细阅读说明。

手动安装 Mod

这是安装星露谷物语 Mod 的常规方式，实际上就是两个步骤。

下载 Mod

使用 Files 标签页上的 Manual download 按钮。你会得到一个 .zip 文件。

解压并复制

使用 7-Zip 解压压缩包，然后看看解压出了什么。

1. 这个文件夹就是要放进 Mods 的内容：一个名为 TractorMod 的单独文件夹，里面包含该 Mod 的 manifest.json 及其文件。

把这个文件夹复制到你游戏的 Mods 文件夹里。

C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods

1. SMAPI 自带的 Mod：ConsoleCommands 和 SaveBackup，由 SMAPI 安装。不要动它们。
2. 每个 Mod 一个文件夹：TractorMod。安装就这么简单。

所以最终的结构如下。

Stardew Valley\Mods\TractorMod\manifest.json
Stardew Valley\Mods\TractorMod\...

警告 - 不要嵌套文件夹。Mods\TractorMod\TractorMod\manifest.json 是无法加载的，这是迄今为止最常见的手动安装错误。SMAPI 会在一到两层深度内寻找 manifest.json，如果找不到会在控制台里告诉你——但一开始就做对会更省事。

提示 - 你也可以在 Mods 内创建子文件夹来整理内容——比如 Mods\Farming\TractorMod 也完全可以正常工作。SMAPI 会递归搜索。

作为参考，这是安装完 SMAPI 后你的游戏文件夹的样子。

1. StardewModdingAPI.exe——启动这个：就在 Stardew Valley.exe 旁边。这正是你的 Steam 启动选项所指向的文件。

通过 Vortex 安装 Mod

Vortex 是 Nexus Mods 官方的 Mod 管理器。对于星露谷物语来说，它提供的功能其实比严格意义上所需的要多，但一旦你运行了二十来个 Mod，并且想要更新检测和一键安装，它就会非常实用。

关于 Vortex 的完整教程，请参阅我们专门的 如何使用 Vortex 及其基础操作 指南。以下部分只涵盖星露谷物语特有的内容。

在 Vortex 中管理星露谷物语

Vortex 在你告诉它要管理某个游戏之前，是不会动它的。

1. 搜索游戏：打开左侧栏中的 Games，在搜索栏中输入 stardew。
2. 将鼠标悬停在图块上并点击 Manage：Vortex 会扫描安装位置，并将星露谷物语添加到左侧栏。

如果 Vortex 找不到你的安装位置，点击图块角落的 三个点 (⋮)，选择 Manually Set Location，然后指向包含 Stardew Valley.exe 的文件夹。

让 Vortex 安装 SMAPI

Vortex 知道星露谷物语需要 SMAPI，如果没有安装会提示你。

1. Get SMAPI 会直接带你去下载页面。

如果你已经用它自己的安装程序安装了 SMAPI，这个通知就不会出现。如果你想让 Vortex 来处理，点击按钮，让它像安装其他 Mod 一样安装 SMAPI。

1. 免费账号一次只能下载一个：Download manually 会打开该文件的 Nexus 页面。高级会员可以使用 Auto-download all，无需访问页面即可获取所有内容。

安装完成后，SMAPI 会像其他内容一样出现在 Mods 页面上。

1. SMAPI 已安装并启用：被归类在 Modding Tools 下。
2. 兼容性检查：Vortex 会将 Mod 与该游戏的兼容性数据库进行比对，并标记出已知损坏的项目。绿色对勾表示良好，信息图标表示有内容需要阅读。

注意 - 通过 Vortex 安装 SMAPI 不会 设置 Steam 启动选项。这部分仍需你自己完成，具体内容见上文的 设置 Steam 启动选项。

安装 Mod

前往 Mod 页面，打开 FILES 标签页，使用 Mod manager download。你的浏览器会询问是否允许打开 Vortex——接受即可，如果不想每次都被询问，可以勾选 Always allow。

Vortex 会为你下载并安装它，并把文件夹放进你的 Mods 目录中。

Mods 页面

你安装的一切都在这里。

1. 启用、禁用或卸载：每个 Mod 的 Status 下拉菜单。
2. 移除，或打开操作菜单：Remove 会卸载该 Mod，旁边的箭头则会打开完整的操作菜单。

状态下拉菜单有三个选项。

1. Mod 可能处于的三种状态：Enabled 表示该 Mod 文件夹已放入你的 Mods 目录。Disabled 会将该 Mod 保留在 Vortex 中，但会把文件夹移出。Uninstalled 会移除文件，但保留已下载的压缩包，方便你重新安装而无需再次下载。

操作菜单涵盖了其余的一切功能。

1. 你能对模组做的其他所有操作：选项如下。
   • Reinstall（重新安装） - 重新运行安装程序。
   • Remove related（移除相关项） - 移除该模组以及与其相关联的所有内容。
   • Check for Updates（检查更新） - 向 Nexus Mods 询问是否有新版本。
   • Manage File Conflicts（管理文件冲突） - 决定两个模组写入同一文件时谁生效。
   • Open in File Manager（在文件管理器中打开） - 打开该模组的暂存文件夹。
   • Open Archive（打开压缩包） - 打开下载的压缩包。
   • Install Recommendations（安装推荐项） - 安装作者推荐与此模组搭配使用的其他模组。
   • Refresh Content（刷新内容） - 重新从磁盘读取模组文件。
   • Create Report（生成报告） - 生成报告，在寻求帮助时很有用。
   • Open on Nexus Mods（在 Nexus Mods 上打开） - 在浏览器中打开该模组页面。

注意 - 星露谷物语没有插件（plugins）也没有加载顺序（load order），所以 Vortex 在这里的侧边栏比 Bethesda 游戏的要简短。这里没有 Plugins 页面，因为没有什么需要排序的东西。

通过 Vortex 启动游戏

Vortex 的 Play 按钮会通过 SMAPI 启动游戏。

1. Play 会通过 SMAPI 启动游戏：一旦安装了 SMAPI，Vortex 会自动识别到 StardewModdingAPI.exe。

通过 CurseForge 应用安装模组

CurseForge 是另一个大型模组托管平台，其桌面应用支持星露谷物语。如果你已经在用它玩 Minecraft，这会让你感到熟悉。

1. Browse 列出了所有星露谷模组：大约有 1,800 个项目，可按下载量、分类和游戏版本排序。
2. 直接安装到 Mods 文件夹：一键完成。CurseForge 会下载模组并为你解压到 Mods 文件夹中。
3. SMAPI 也在这里：SMAPI 是排名第一的结果，同样可以从这里安装。

你安装的模组会显示在 My Mods 下。

1. 你已安装的模组：显示已安装版本、所针对的游戏版本以及作者。顶部的 Update all 可以一次性更新所有模组。

就这款游戏而言，CurseForge 可以说是三种方法中最省心的——每个模组只需一次点击，且能自动处理更新——但它的星露谷模组库比 Nexus Mods 小，所以你很可能最终会混合使用几种方法。

警告 - 不要在两个地方同时管理同一个模组。如果 Vortex 和 CurseForge 都认为自己拥有 Mods\TractorMod，你最终会得到重复文件，或者一个被你移除后又重新出现的模组。每个模组只选一个管理器来管理，或者手动安装。

提示 - 关于 CurseForge 应用的完整介绍，请参阅我们的如何使用 CurseForge 应用及其基础知识指南。

检查你的模组是否已加载

启动游戏并查看 SMAPI 控制台。你的模组应该出现在 Loaded N mods 列表中，附带其名称、版本和作者信息。

具体到 Tractor Mod，前往 Robin 的木匠铺，你会发现一个新的 Tractor Garage（拖拉机车库） 在售，价格为 150,000g（外加一个铁锭、一个铱锭和一个电池组）。建造它之后，拖拉机就在里面。

如果模组没有出现在列表中，请按以下步骤排查。

• 文件夹结构对吗？应该是 Mods\ModName\manifest.json，而不是 Mods\ModName\ModName\manifest.json。
• 控制台是否打印了 skipped mod（跳过的模组） 警告？SMAPI 会说明模组名称和原因。
• 你的 SMAPI 版本够新吗？模组页面会写明所需的最低版本。
• 你是通过 SMAPI 启动的，而不是直接启动游戏吗？
• 该模组在兼容性列表上被标记为损坏了吗？

更新与移除模组

更新和安装是同一个流程——下载新版本，替换文件夹。

1. 如果你自定义过设置，先备份模组的 config.json。大多数模组在你覆盖文件夹时会保留你的设置，但不是所有模组都会这样。
2. 删除旧文件夹，而不是直接粘贴覆盖。旧版本残留的文件确实是导致奇怪问题的一个常见原因。
3. 把新文件夹拷贝进去。

移除模组只需从 Mods 中删除它的文件夹即可。

警告 - 移除一个曾向存档添加物品或建筑的模组，可能会破坏该存档。如果模组页面有卸载说明，请遵照执行——通常是在移除模组之前，先卖掉它添加的所有物品之类的操作。

提示 - SMAPI 在启动时会检查模组更新，并在控制台中打印结果，所以当有东西过时了，你会被告知，而无需手动检查。

其他有用的模组

有几个模组值得提前安装，因为很多其他模组都依赖它们，或者因为它们能让一切变得更简单。

• Content Patcher - 让模组无需修改游戏文件即可更改游戏的图片、地图和数据。星露谷的绝大部分模组都是 Content Patcher 包，所以无论你是否有意为之，最终都会用上它。
• Generic Mod Config Menu - 为支持它的模组（也就是绝大多数模组）添加一个游戏内设置菜单。没有它的话，配置模组就意味着要用记事本编辑 config.json 文件。
• Lookup Anything - 在游戏中任何东西上按一个键即可查看其详情。不是依赖项，只是非常好用。
• SpaceCore - 许多大型内容模组所依赖的一个框架。

疑难解答

• 没有出现控制台窗口。 你启动的是游戏本体而不是 SMAPI。检查你的 Steam 启动选项，或者直接运行 StardewModdingAPI.exe。
• SMAPI 提示某个 mod 被跳过（skipped）。 仔细看那一行——它会说明原因，通常是缺少依赖项或 mod 版本过旧。
• 列表里完全没有这个 mod。 文件夹结构不对，或者你把它放到了 Mods 以外的地方。
• SMAPI 说找不到游戏。 用选项 2 手动指向游戏所在文件夹。
• 更新后游戏启动时崩溃。 SMAPI 版本比你的游戏版本旧了。下载最新的 SMAPI 并重新运行安装程序。
• 某个 mod 昨天还能用，今天不行了。 游戏自动更新了。解决方法一样——先更新 SMAPI，再到兼容性列表查一下这个 mod。
• 我的存档打不开了。 某个曾写入过存档的 mod 被移除了。把它装回去，读取存档，然后按照该 mod 的正确卸载说明操作。
• 成就不再生效了。 你是在 Steam 之外启动的 SMAPI。改用启动选项来运行。

说明

多人游戏

多人游戏可以使用 mod，只有一条规则：所有人都要用相同的 mod。SMAPI 在连接时会检查这一点，并对不匹配的情况发出警告。

有些 mod 只影响客户端（UI 调整、视觉效果之类），不需要所有人一致。任何改变玩法、物品或地图的 mod 都需要一致。mod 页面通常会说明属于哪一类，而且当有玩家连接时缺少某个 mod，SMAPI 也会在控制台里提示。

Mod 配置文件

大多数 SMAPI mod 会在第一次运行时在自己的文件夹里生成一个 config.json。这里存放的是该 mod 独有的设置——按键绑定、开关选项、数值平衡之类。

你可以用记事本编辑这些文件，不过 Generic Mod Config Menu 能提供一个游戏内的设置界面来调整同样的选项，比手动编辑 JSON 出错的概率要低得多。

注意 - 如果 config.json 中有语法错误，会导致该 mod 无法加载。如果你手动编辑后 mod 从 SMAPI 的列表中消失了，几乎可以肯定就是这个原因——删除该文件，mod 就会重新生成一份默认配置。

另请参阅！

• SMAPI
• SMAPI mod 兼容性列表
• Nexus Mods - Stardew Valley
• Tractor Mod
• CurseForge - Stardew Valley
• Stardew Valley Modding Wiki
• How to Use Vortex & The Basics
• How to Use the CurseForge App & The Basics
• ProtonDB - Stardew Valley（适用于 Linux 用户）
• r/SMAPI

结语

就是这样！一旦装好了 SMAPI，Stardew Valley 的模组化过程就几乎不会出什么岔子，之后添加 mod 真的就是复制一个文件夹这么简单。

简而言之——先安装 SMAPI，设置好 Steam 启动选项 以保留成就，把每个 mod 作为单个文件夹放进 Mods，遇到问题时看看 SMAPI 控制台，它通常会准确告诉你哪里出了问题。

我们创建的指南始终欢迎修改和改进，如果你有任何建议或发现任何问题，欢迎在我们的 GitHub 仓库上创建 pull request 来参与贡献！

如果你有任何问题，或者在模组制作或我们的指南方面需要帮助，欢迎加入我们的 Discord 服务器！