模组:Content Patcher

← 目录

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

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

快速开始

此页面是对创建 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|加载 Asset的初始版本。 每个Asset只能同时被一个模组加载。 这主要用于完全替换模组（例如完全改变 NPC 肖像的模组），或提供 Content 文件夹中不存在的文件。
• Edit|编辑 加载后的Asset。 可以对同一资产应用任意数量的编辑。

例如，假设游戏需要阿比盖尔的肖像。 这是应用更改的方式：

                                           ┌────────────┐
                                           │ 编辑Asset │
                         ┌────────────┐    ├────────────┤
获得肖像/阿比盖尔 ──>│ 载入Aeest  │───>│编辑Asset │──> 肖像Aeest
                         └────────────┘    ├────────────┤
                                           │ 编辑Asset │
                                           └────────────┘

这分为四种主要操作类型（Load、EditData、EditImage、EditMap），在 内容修补程序自述文件中的更多详细信息（见下文）。

开始

了解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.json 文件告诉 Content Patcher 要更改什么。 这有两个主要领域：

• Format：格式版本。 您应该始终使用最新版本（当前为 1.19.0）来启用最新功能并避免过时行为。
• Changes：您要进行的更改。 每个条目称为“补丁”，并描述要执行的特定操作：替换此文件、将此图像复制到文件中等。您可以列出任意数量的补丁。

您可以在 Changes 字段中列出任意数量的补丁，每个补丁都由 { 和 } 包围。 有关更多信息，请参阅下一节，但这里有一个快速示例：

{
   "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