← 模组:目录
模组使用指南
入门
疑难解答
按键绑定
兼容性（站外）
想在星露谷物语里使用 Mod 吗？ 别被“修改文件”听起来的复杂感吓到。本指南将带你轻松跨入模组大门，开启全新的农场之旅！
目录
1 核心概念
1.1 什么是模组 (Mod)？
2 快速上手
2.1 1. 安装加载器 (SMAPI)
2.2 2. 寻找心仪的模组
2.3 3. 定位游戏文件夹 (重要)
3 模组管理
3.1 安装与组织结构
3.2 配置与更新
4 常见问题
5 故障排查
核心概念
什么是模组 (Mod)？
模组 (Mod) 是用于扩展或修改游戏本体的文件包。无论是想在地图上看到 NPC 的实时位置、减缓围栏腐烂速度，还是想把房子装修成霍比特人洞穴，Mod 都能帮你实现。
在使用 Mod 前，请牢记这个核心逻辑：
安装 SMAPI (桥梁) + 放入 Mods 文件夹 (内容) = 成功加载 Mod
安装 SMAPI：它是 Mod 与游戏之间的“桥梁”。安全、兼容且易于卸载。
放入 Mod 文件：将下载的 Mod 压缩包解压到游戏目录下的 Mods 文件夹即可。
快速上手
1. 安装加载器 (SMAPI)
绝大多数模组都需要 SMAPI 才能运行。 请根据你的平台查看详细安装步骤：
Windows | macOS | Linux
Android | Steam Deck
2. 寻找心仪的模组
⚠️ 避雷与注意：
优先检查 Mod 是否适配最新的游戏版本（如 1.6.15）。
推荐查阅 Mod 兼容性列表。
拒绝“搬运站”：切勿从 stardewvalleymods.net 下载，那里的资源通常未经授权且版本陈旧。
推荐站点
特点描述
Nexus Mods
全球最大 Mod 站。资源最全，更新最快（需注册免费账号）。
ModDrop
界面友好，提供客户端支持一键安装与自动更新。
官方论坛
官方社区，有许多开发者首发或测试中的精品资源。
3. 定位游戏文件夹 (重要)
你需要找到包含游戏执行程序（ Stardew Valley.exe）的根目录。
平台
默认路径参考
Steam(Windows)
C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley
GOG(Windows)
C:\GOG Games\Stardew Valley
Xbox(Windows)
C:\Program Files\ModifiableWindowsApps\Stardew Valley
Android
内部存储/StardewValley/Mods
macOS
~/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS
💡 小技巧：在 Steam 库中右键点击游戏 -> 管理 -> 浏览本地文件，可以直接跳转到该位置。
模组管理
安装与组织结构
将解压后的文件夹放入 Mods 目录。必须确保每个 Mod 都有自己的独立文件夹。
Stardew Valley/
Mods/
PineapplesEverywhere/ <-- Mod主文件夹
manifest.json <-- 身份清单 (核心文件)
PineapplesEverywhere.dll
分类管理： 你可以在 Mods 下创建子文件夹（如 `Mods/美化/`），SMAPI 会自动扫描。
一键禁用： 在文件夹名前加一个英文句点（如 `.PineapplesEverywhere`），该 Mod 就会被 SMAPI 跳过。
配置与更新
配置 (config.json)：运行一次 Mod 后会自动生成。使用记事本修改数值即可自定义功能。
更新：直接下载新版并覆盖旧文件夹。若有自定义设置，建议保留旧的 `config.json`。
卸载：直接删除该 Mod 对应的文件夹即可，非常干净。
常见问题
Q: Mod 会损坏我的存档吗？
概率极低。绝大多数 Mod 仅在运行时修改数据。SMAPI 每天会自动在 SaveBackup 文件夹中为你备份一份存档。
Q: 使用 Mod 后还能拿成就吗？
完全可以！ 只要你是通过 SMAPI 启动游戏的。
Q: 联机时需要大家都装一样的 Mod 吗？
视情况而定。贴图美化等“本地 Mod”仅自己可见；如果是添加了新物品、新地图的“内容 Mod”，所有玩家都必须安装相同的版本，否则会报红或崩溃。
故障排查
如果游戏启动时出现满屏红字、黑屏或闪退：
找到你的 SMAPI 日志：位于游戏目录下的 ErrorLogs 文件夹。
上传至 日志解析器。
它是你的“私人医生”，能准确告诉你哪个 Mod 缺失、冲突或需要更新。
查看：如何看懂日志分析结果（点击展开）
疑难解答 →
Modding:Player Guide/Getting Started