模组:Content Patcher

← 模组是改变星露谷物语的文件包。模组可以添加功能（例如在地图上显示 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）

版本迁移指南

发行版本	发行时间
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 开发人员讨论。

“ “我这里还有很多事情需要处理。” — 罗宾 不完整的翻译 本文或部分尚未完全翻译成中文。 欢迎您通过编辑帮助其建设。 最后编辑1059 Studio于2021-04-16 00:44:34.

想为游戏创建内容包模组吗？教程就在这里。有关如何使用模组，请参阅 模组:使用指南/入门

快速开始

此页面是对创建 Content Patcher 的内容包的简要介绍。如果你不需要介绍，请参阅 完整的技术资料

基本概念

什么是 Content Patcher ？

Content Patcher是一种 SMAPI 模组，可更改游戏资源（图像、对话、数据和地图），而无需替换游戏文件或编写代码。可以通过创建包含几个 JSON 文件（基本上是文本）的内容包（基本上是文件夹）来使用它。只需编辑 JSON 文件就可以：

• 替换一个图像文件
• 制作季节性的变化
• 根据天气、日期、与其他 NPC 的关系等进行更改
• 进行非常具体的更改（例如，在完成乔家超市献祭之后，在下雪的冬天的周末，咖啡价格会更高）
• 以及更多

资源 Assets

一个 asset 本质上是游戏中的 Content 文件夹，具有唯一的“资源名称”。 资产名称从不包含 Content路径、语言或文件扩展名（可以使用令牌来定位特定的语言）。例如：

文件	资源名称
Content/Portraits/Abigail.xnb	Portraits/Abigail
Content/Maps/spring_beach.xnb Content/Maps/spring_beach.es-ES.xnb Content/Maps/spring_beach.fr-FR.xnb	Maps/spring_beach

一个资源可能包含多个子画面或数据条目。例如：Portraits/Abigail：

因此，如果想更改阿比盖尔的肖像，则可以使用 Content Patcher 加载或编辑 Portraits/Abigail.

Load 和 Edit

可以通过两种概念上的方式来更改资源：

• Load the initial version of an asset. Each asset can only be loaded by one mod at the same time. This is mainly useful for total replacement mods (like a mod that completely changes an NPC's portraits), or to provide files that don't exist in the Content folder.
• Edit an asset after it's loaded. Any number of edits can be applied to the same asset.

For example, let's say the game needs Abigail's portraits. This is how changes are applied:

                                           ┌────────────┐
                                           │ edit asset │
                         ┌────────────┐    ├────────────┤
get Portraits/Abigail ──>│ load asset │───>│ edit asset │──> portrait asset
                         └────────────┘    ├────────────┤
                                           │ edit asset │
                                           └────────────┘

This is divided into four main action types (Load, EditData, EditImage, EditMap), which are explained in more detail in the Content Patcher readme (see below).

Get started

Intro to JSON

You'll notice a lot of files with .json at the end of the name when creating mods for Stardew Valley. That means they're formatted as JSON, which is just a way of writing text that's readable to code. If you haven't used JSON before, reading An Introduction to JSON first will be very helpful to understand what the files are doing.

Create example mod

First let's get our basic content pack up and running:

1. Install SMAPI and Content Patcher.
2. Unpack the game's Content folder so you can see what each asset contains (see Modding:Editing XNB files#Unpack game files).
3. Create a SMAPI content pack.
4. Create a content.json file in the same folder with this content:

   {
      "Format": "2.0.0",
      "Changes": [
      ]
   }
   

5. Launch the game.

If you did everything correctly so far, you should see the new mod under "Loaded X content packs" in the SMAPI console. (If not, review the above steps or ask for help.)

Content format

The content.json file you created above is what tells Content Patcher what to change. This has two main fields:

• Format: the format version. You should always use the latest version (currently 1.19.0) to enable the latest features and avoid obsolete behavior.
• Changes: the changes you want to make. Each entry is called a patch, and describes a specific action to perform: replace this file, copy this image into the file, etc. You can list any number of patches.

You can list any number of patches in the Changes field, each surrounded by { and }. See the next section for more info, but here's a quick example:

{
   "Format": "2.0.0",
   "Changes": [
      {
         "Action": "Load",
         "Target": "Animals/Dinosaur",
         "FromFile": "assets/dinosaur.png"
      },

      {
         "Action": "EditImage",
         "Target": "Maps/springobjects",
         "FromFile": "assets/fish-object.png"
      },
   ]
}

(There are other fields like ConfigSchema and DynamicTokens for more advanced usage; these are covered in the full readme.)

Next steps

You've created a Content Patcher pack!

For help making it do something, see...

• Content Patcher readme for the full reference;
• video intro to Content Patcher (unofficial);
• intro to converting XNB mods (unofficial).

Examples

(We'll have a guided tutorial here soon.)

Change horse/pet icons

For edits to replace the look of horses and/or pets (cats and dogs), you can add these to your content.json in order to also replace the little head icon in the inventory menu:

For horses:

//horse head in inventory
{
   "Action": "EditImage",
   "Target": "LooseSprites/Cursors",
   "FromFile": "yourfile.png",
   "FromArea": { insert values here }, 
   "ToArea": { "X": 192, "Y": 192, "Width": 16, "Height": 16 }
}

For dogs:

//dog head in inventory

"ToArea": { "X": 208, "Y": 208, "Width": 16, "Height": 16 }, //Dog 1

"ToArea": { "X": 224, "Y": 208, "Width": 16, "Height": 16 }, //Dog 2

"ToArea": { "X": 240, "Y": 208, "Width": 16, "Height": 16 }, //Dog 3

For cats:

//cat head in inventory

"ToArea": { "X": 160, "Y": 208, "Width": 16, "Height": 16 }, //Cat 1 

"ToArea": { "X": 176, "Y": 208, "Width": 16, "Height": 16 }, //Cat 2 

"ToArea": { "X": 192, "Y": 208, "Width": 16, "Height": 16 }, //Cat 3