前言：为什么你需要安装Mod？

《星露谷物语》作为一款经典的农场模拟游戏，其原版内容已经足够丰富。但通过安装Mod（游戏模组），你可以解锁更多玩法：增加新作物、美化界面、自动化农场操作，甚至加入全新的NPC和剧情。本教程将手把手教你如何安全、高效地安装Mod，避免常见错误。

第一步：准备工作

1.1 确认游戏版本

在安装Mod前，请确保你的《星露谷物语》版本为最新（通常为1.5.6或更高）。你可以在Steam库中右键点击游戏 → 属性 → 测试版，确保未勾选任何Beta版本。Mod通常基于最新稳定版开发，版本不匹配会导致崩溃。

1.2 备份游戏存档

虽然Mod安装一般不会影响存档，但为防万一，建议你手动备份存档文件夹。存档路径：
Windows：%AppData%\StardewValley\Saves
Mac：~/Library/Application Support/StardewValley/Saves
复制整个文件夹到安全位置即可。

第二步：安装SMAPI（核心工具）

2.1 什么是SMAPI？

SMAPI（Stardew Modding API）是所有Mod运行的基础。它像一个桥梁，让Mod代码与游戏正常交互。没有SMAPI，Mod无法生效。

2.2 下载与安装

访问SMAPI官网（注意：不要直接在百度搜索，以免进入钓鱼网站）。找到对应你操作系统的安装包（Windows用户下载.exe文件，Mac用户下载.pkg文件）。
安装步骤：
1. 运行安装程序，选择你的游戏安装目录（Steam默认路径为：SteamLibrary/steamapps/common/Stardew Valley）。
2. 安装程序会自动识别并添加SMAPI。
3. 完成后，你会在游戏目录下看到一个名为“StardewModdingAPI.exe”的文件。

2.3 启动方式

以后启动游戏时，请直接运行“StardewModdingAPI.exe”，而不是原版游戏启动器。SMAPI会加载所有Mod并显示控制台窗口（不要关闭它）。你也可以在Steam中设置启动参数：右键游戏 → 属性 → 通用 → 启动选项，输入：
"StardewModdingAPI.exe" %command%
这样从Steam启动也会自动加载Mod。

第三步：安装Mod文件

3.1 Mod文件格式

大多数Mod以压缩包（.zip或.rar）形式提供。解压后，你会看到一个文件夹，里面包含manifest.json（清单文件）、dll文件（代码文件）以及可能有的assets（资源文件）。

3.2 正确放置Mod

将解压后的整个文件夹复制到游戏目录下的“Mods”文件夹中（如果不存在，请手动创建）。路径示例：
.../Stardew Valley/Mods/你的Mod名字/

注意：不要将Mod文件夹内的文件直接复制到Mods根目录，必须保留文件夹结构。

3.3 检查Mod依赖

部分Mod需要额外前置Mod才能运行，例如“Content Patcher”（内容补丁）或“Json Assets”。在Mod的Nexus页面或下载说明中会注明。如果缺少依赖，游戏会报错。建议安装“SMAPI日志解析器”（一个在线工具）来检查错误。

第四步：常见Mod推荐（入门级）

4.1 UI美化类

- Stardew Valley Expanded（SVE）：增加新地图、NPC、剧情，是目前最受欢迎的大型Mod。
- Interface with Harvest with Scythe：自动收获作物，节省时间。
- Lookup Anything：按F1即可查看任何物品、NPC的信息。

4.2 功能增强类

- Automate：让箱子自动连接机器（如熔炉、罐头瓶），实现自动化生产。
- CJB Cheats Menu：作弊菜单，可修改时间、金钱、技能等级等（适合单机娱乐）。
- Timespeed：控制游戏时间流逝速度。

4.3 视觉美化类

- Elle's Seasonal Buildings：将建筑改为四季变化的样式。
- DaisyNiko's Earthy Recolour：重新着色地图，使画面更柔和。

第五步：解决常见问题

5.1 游戏崩溃或无法启动

原因通常是Mod版本不匹配。检查SMAPI控制台中的红色错误信息，禁用冲突的Mod。也可以尝试删除Mods文件夹，逐个添加Mod来排查。

5.2 Mod不生效

确认Mod是否已正确放入Mods文件夹，并且游戏是通过SMAPI启动的。部分Mod需要新开存档才能生效（如SVE）。

5.3 存档损坏

如果之前安装了Mod的存档，在移除Mod后加载可能会报错。建议安装“Save Backup”Mod自动备份，或者手动恢复之前备份的存档。

结语：享受你的Mod农场

现在你已经掌握了安装Mod的全部技能！从简单的外观美化到宏大的内容扩展，Mod能让你在鹈鹕镇的生活焕然一新。记得定期更新SMAPI和Mod，关注Nexus Mods上的最新动态。祝你在星露谷的每一天都有新惊喜！