全站通知：

模组:使用指南/入门

来自站务
跳到导航 跳到搜索
← 模组:目录
模组使用指南 SMAPI mascot.png

想在星露谷物语里使用 Mod 吗？ 别被“修改文件”听起来的复杂感吓到。本指南将带你轻松跨入模组大门，开启全新的农场之旅！

🌟 核心概念

什么是模组 (Mod)？

模组 (Mod) 是用于扩展或修改游戏本体的文件包。无论是想在地图上看到 NPC 的实时位置、减缓围栏腐烂速度，还是想把房子装修成霍比特人洞穴，Mod 都能帮你实现。 在使用 Mod 前，请牢记这个核心逻辑：

安装 SMAPI (桥梁) + 放入 Mods 文件夹 (内容) = 成功加载 Mod

  1. 安装 SMAPI：它是 Mod 与游戏之间的“桥梁”。安全、兼容且易于卸载。
  2. 放入 Mod 文件：将下载的 Mod 压缩包解压到游戏目录下的 Mods 文件夹即可。

---

🚀 快速上手

1. 安装加载器 (SMAPI)

绝大多数模组都需要 SMAPI 才能运行。 请根据你的平台查看详细安装步骤：

2. 寻找心仪的模组

⚠️ 避雷与注意：

  • 优先检查 Mod 是否适配最新的游戏版本（如 1.6.15）。
  • 推荐查阅 Mod 兼容性列表。
  • 拒绝“搬运站”：切勿从 stardewvalleymods.net 下载，那里的资源通常未经授权且版本陈旧。
推荐站点 特点描述
Nexus Mods 全球最大 Mod 站。资源最全，更新最快（需注册免费账号）。
ModDrop 界面友好，提供客户端支持一键安装与自动更新。
官方论坛 官方社区，有许多开发者首发或测试中的精品资源。

3. 定位游戏文件夹 (重要)

你需要找到包含游戏执行程序（Stardew Valley executable icon.png 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 对应的文件夹即可，非常干净。

---

❓ 常见问题 (FAQ)

Q: Mod 会损坏我的存档吗？

概率极低。绝大多数 Mod 仅在运行时修改数据。SMAPI 每天会自动在 SaveBackup 文件夹中为你备份一份存档。

Q: 使用 Mod 后还能拿成就吗？

完全可以！ 只要你是通过 SMAPI 启动游戏的。

Q: 联机时需要大家都装一样的 Mod 吗？

视情况而定。贴图美化等“本地 Mod”仅自己可见；如果是添加了新物品、新地图的“内容 Mod”，所有玩家都必须安装相同的版本，否则会报红或崩溃。

---

🛠️ 故障排查

如果游戏启动时出现满屏红字、黑屏或闪退：

  1. 找到你的 SMAPI 日志：位于游戏目录下的 ErrorLogs 文件夹。
  2. 上传至 日志解析器。
  3. 它是你的“私人医生”，能准确告诉你哪个 Mod 缺失、冲突或需要更新。

取自“https://wiki.biligame.com/stardewvalley/index.php?title=模组:使用指南/入门&oldid=136379”