模组:目录

模组是改变星露谷物语的文件包。模组可以添加功能（例如在地图上显示 NPC）、改变游戏机制（例如让栅栏腐烂得更慢）、进行外观更改（例如让你的房子看起来像霍比特人的家）等等。

使用指南

模组使用指南

• 入门
• 疑难解答
• 按键绑定
• 兼容性

• 常见问题解答
• 寻求帮助或提出问题
• 加入社区论坛
• 使用 XNB 模组 (不推荐)

创建模组

模组大致可以分为两类：C# 模组和内容包（依赖于 C# 模组的格式化文本文件）。内容包可以制作新的 NPC、编辑地图、添加新物品、添加商店等，而 C# 模组可以改变基本的游戏机制。通常，从制作内容包开始是最简单的，因为不需要学习如何使用 C# 进行编程。

使用 JSON 创建内容包 为诸如 Content Patcher 之类的框架创建内容包

使用 C# 创建 SMAPI 模组 创建 SMAPI 模组，包括完整的 SMAPI API 和事件参考 如果您不会 C# 而会 Visual Basic，则可以放心使用另一门语言，社区中已经存在使用该语言编写的模组且运行正常

翻译模组 为游戏支持的任何语言提供模组翻译（对于模组开发者如何启用和请求翻译）

• 在查找特定的资料吗？不妨试着 搜索 模组 命名空间。
• 寻求帮助或提出问题
• 加入社区论坛
• 开源代码

高阶主题

• SMAPI API 参考
• 常用方法（SMAPI 模组）
• 编辑 XNB 文件
• IDE 参考

• 游戏：
  • 游戏基本架构（Game fundamentals）
  • 音频（Audio）
  • 自定义语言（Custom languages）
  • 控制台命令（Console commands）
  • 世界地图（World map）
  • 游戏状态查询（Game state queries）
  • 物品查询（Item queries）
  • 触发动作（Trigger actions）
  • 模板字符串（Tokenizable strings）
  • 商店（Shops）
  • 农场地图（Farm map）

• NPC：
  • 概述（Overview）
  • 对话（Dialogue）
  • 事件（Events）
  • 礼物喜好（Gift tastes）
  • 任务（Quests）
  • 行程（Schedules）

• 物品：
  • 物品（Items）
  • 农作物（Crops）
  • 果树（Fruit trees）

• 其他：
  • 动物（Animals）
  • 成就（Achievements）
  • 蓝图（Blueprints）
  • 收集包（Bundles）
  • 玩家模型（Farmer sprite）
  • 节日（Festivals）
  • 鱼（Fish）
  • 鱼塘（Fish Ponds）
  • 地点（Locations）
  • 地图（Maps）
  • 信件（Mail）
  • 怪物（Monsters）
  • 配方（Recipes）
  • 天气（Weather）

• 专用：
  • 常见的数据字段（Common data field types）

版本迁移指南

发行版本	发行时间
SMAPI 2.0	2017.7
游戏本体 1.3	2018.5
游戏本体 1.3（XNB 更改）	2018.5
游戏本体 1.3.36	2019.3
游戏本体 1.4	2019.11
SMAPI 3.0	2019.11
游戏本体 1.5	2020.12
在 Windows 上使用 64 位游戏版本	2021.5
Harmony 2.0	2021.7
游戏本体 1.5.5	2021.8
SMAPI 4.0	2024.3.19
游戏本体 1.6	2024.3.19

也看看

• 像素艺术资源：
  • 星露谷艺术风格指南
  • Pixel Joint 上的像素艺术教程
  • Medium 上的像素艺术指南
• 内容包资源：
  • 出色的 ID 电子表格
  • 自定义 NPC 节日图块位置
• 工具：
  • SMAPI 模组兼容表（你可以编辑它）
  • SMAPI 日志分析器
  • JSON 验证器
• Kdau 的关于 Android SMAPI 修改的笔记
• Dem1se 的模组 UI 入门指南

讨论

• 星露谷物语百度贴吧 — 为国内网友提供一个可以向大家分享自制模组的心得、提出问题、愉快议论话题的论坛，很多中文大佬都在这里溜达。
• Discord 频道 — 提出问题、获得帮助，与模组制作者和 SMAPI 开发人员讨论。