为什么你需要安装Mod？

《星露谷物语》虽然原版已经足够丰富，但Mod（模组）能彻底改变你的游戏体验。无论是增加新作物、自动化农场操作，还是美化画面，Mod都能让你玩出全新花样。本教程将手把手教你从零开始安装Mod，避开常见坑点。

准备工作：必备工具与文件

1. 下载SMAPI（模组加载器）

SMAPI（Stardew Modding API）是所有Mod运行的基础。前往SMAPI官网（注意不要使用第三方下载站），选择与你的游戏版本匹配的安装包（通常是最新版）。下载后解压到一个容易找到的文件夹，比如桌面上的“SMAPI”文件夹。

2. 确认游戏版本

在Steam库中右键点击《星露谷物语》→“属性”→“测试版”，确保“参与测试”选项为“无”。Mod通常支持最新稳定版，不要随意切换测试分支。

3. 备份原文件（重要）

在安装任何Mod前，建议复制一份游戏根目录（通常位于Steam\steamapps\common\Stardew Valley）到安全位置。如果Mod出现问题，可以直接覆盖还原。

第一步：安装SMAPI

找到你解压后的SMAPI文件夹，运行其中的“install on Windows”或“install on Linux/Mac”批处理文件（根据你的操作系统）。安装程序会自动检测游戏路径，并提示安装成功。完成后，游戏启动器会新增一个“SMAPI”启动选项。

验证安装：打开Steam，点击“开始游戏”旁边的下拉菜单，选择“SMAPI 3.x.x”（版本号可能不同）。如果游戏正常启动且控制台窗口弹出，说明安装成功。

第二步：下载Mod

1. 推荐Mod来源

安全可靠的Mod下载站包括Nexus Mods和ModDrop。搜索“Stardew Valley”分类，按下载量或评分排序。新手建议从“CJB Cheats Menu”（作弊菜单）、“Automate”（自动化）或“Stardew Valley Expanded”（扩展地图）开始。

2. 下载注意事项

每个Mod页面都会注明“Requirements”（依赖项），例如某些Mod需要“Content Patcher”或“Json Assets”作为前置。请一并下载这些前置Mod，否则Mod无法生效。下载时选择“Manual Download”，避免使用自动安装器（容易出错）。

3. 解压Mod文件

下载的Mod通常是.zip或.rar格式，解压后你会看到一个文件夹（例如“[CP] Stardew Valley Expanded”）。注意文件夹名称不要修改，且内部必须包含一个“manifest.json”文件（这是Mod的身份证）。

第三步：安装Mod

找到你的游戏根目录下的“Mods”文件夹（如果不存在，请手动创建一个）。将解压后的Mod文件夹整个复制粘贴到“Mods”文件夹内。例如：
Stardew Valley\Mods\[CP] Stardew Valley Expanded

注意：不要将Mod文件夹内的文件直接散放在Mods目录中，每个Mod必须保持自己的独立文件夹。同时，避免文件夹名称包含中文或特殊符号。

第四步：启动与测试

通过SMAPI启动游戏（确保Steam启动选项已选择SMAPI）。游戏加载时，控制台窗口会滚动显示Mod加载信息。如果一切正常，你会看到类似“Loaded X mods”的提示。进入游戏后，检查Mod是否生效（例如按“P”键打开CJB菜单，或查看农场是否有新建筑）。

常见问题与解决方法

问题1：游戏无法启动或闪退

原因：Mod冲突或版本不兼容。解决方法：逐个移除Mods文件夹中的子文件夹，每次移除后启动游戏测试，直到找到问题Mod。或者检查SMAPI控制台输出的红色错误信息，它通常会指出冲突原因。

问题2：Mod不显示或功能异常

原因：缺少前置Mod。例如安装了“Stardew Valley Expanded”却没有安装“Content Patcher”和“Farm Type Manager”。返回Mod下载页仔细阅读“Requirements”部分，补全所有依赖项。

问题3：Mod更新后失效

原因：游戏版本更新导致Mod不兼容。解决方法：前往Mod下载页查看是否已适配最新游戏版本，等待作者更新或暂时回退游戏版本（Steam测试版功能）。

进阶技巧：Mod管理与优化

1. 使用Mod管理器

推荐“Stardew Mod Manager”或“Vortex”（Nexus Mods官方工具）。这些工具可以自动检测Mod冲突、一键启用/禁用Mod，并保持Mod更新。对于超过20个Mod的玩家，强烈建议使用。

2. 排序与优先级

某些Mod（如地图美化类）需要调整加载顺序。在Mods文件夹中，你可以通过修改文件夹名称前加数字来排序，例如“01. [CP] Map Recolor”、“02. [CP] Stardew Valley Expanded”。SMAPI会按字母顺序加载，数字越小越优先。

3. 清理缓存

如果Mod频繁出错，可以删除游戏根目录的“bin”文件夹（但不要删除其他内容），然后通过Steam验证游戏文件完整性（右键游戏→“属性”→“本地文件”→“验证游戏文件的完整性”）。这会重新生成干净的缓存文件。

安全提醒：避免Mod陷阱

不要从不明来源下载Mod，它们可能包含恶意代码。只使用Nexus Mods、ModDrop或官方论坛推荐的Mod。另外，部分Mod（如“CJB Cheats Menu”）可能破坏游戏平衡性，建议单机使用，联机时禁用。如果遇到游戏存档损坏，利用之前备份的原文件恢复。

现在，你已经掌握了完整的Mod安装流程。打开你的《星露谷物语》，用Mod打造独一无二的农场吧！记住，遇到问题时先检查SMAPI控制台输出，那是最直接的诊断工具。祝游戏愉快！