维护提醒

BWIKI 全站将于 9 月 3 日（全天）进行维护，期间无法编辑任何页面或发布新的评论。

全站通知：

模组:Content Patcher 制作指南/修改图像

来自星露谷物语维基
跳到导航 跳到搜索

← 模组:目录

制作 Content Patcher 模组 SMAPI mascot.png

带有 "Action": "EditImage" 的补丁可以更改游戏已加载的图像的一部分。多个内容包可以编辑同一素材。您可以使用补丁向下延伸图像（Content Patcher 会自动扩大图像以适应新图像）。

用法

格式

一个 EditImage 补丁由 Changes（请参阅下文示例）下的一个模型组成，包含以下字段。

必填字段：
字段 用途
Action 要进行的更改类型。此操作类型设置为 EditImage。
Target 要修改的目标游戏素材名称（或多个由逗号分隔的素材名），例如 Portraits/Abigail。该字段支持令牌，不区分大小写。
FromFile 内容包文件夹中用于修补到目标中的文件的相对路径（例如 assets/dinosaur.png），或多个逗号分隔的路径。这可以是 .png 或 .xnb 文件。该字段支持令牌，不区分大小写。
可选字段：
字段 用途
FromArea
ToArea
PatchMode
When （可选）仅在给定的条件匹配时应用这个内容补丁。
LogName （可选）在日志中显示的补丁名称。这有助于查找错误。如果省略，则默认为类似 EditImage Animals/Dinosaur 的名字。
Update （可选）补丁字段的更新频率。请参阅补丁更新频率。
LocalTokens （可选）一组仅在此补丁中生效的局部令牌。
进阶字段：
字段 用途
Priority （可选）当多个补丁编辑同一数据素材时，此字段控制它们应用的顺序。可用的值有 Early（更早），Default（默认），还有 Late（更晚）。默认值为 Default。

补丁（包括所有模组）按以下顺序生效：

  1. 优先级从早到晚；
  2. 按照模组加载顺序（基于依赖关系等因素）；
  3. 按照补丁在 content.json 中列出的顺序。

如果需要更具体的顺序，可以使用简单的偏移量，如 "Default + 2" 或者 "Late - 10"。默认值为 -1000（Early），0（Default）和 1000（Late）。

此字段不支持令牌，不区分大小写。

警告

优先级会让您的更改难以排除故障。推荐做法：

  • 如果可以的话，只使用上述无偏移的优先级（例如外观覆盖设为 Late）
  • 不需要为您自己的补丁设置优先级，因为您可以自己在 content.json 排列好补丁应用的顺序。

TargetLocale （可选）素材名称中要匹配的地区代码，例如设置 "TargetLocale": "fr-FR" 将会只编辑法语的素材（例如 Data/Achievements.fr-FR）。可以为空，只有只编辑没有地域区分的基本素材。

如果省略，则将应用于所有素材，不论其是否存在本地化。

示例

这个示例改变某一物品的图标： 

{
    "Format": "2.7.0",
    "Changes": [
        {
            "Action": "EditImage",
            "Target": "Maps/springobjects",
            "FromFile": "assets/fish-object.png",
            "FromArea": { "X": 0, "Y": 0, "Width": 16, "Height": 16 }, // 可选，默认整个图片
            "ToArea": { "X": 256, "Y": 96, "Width": 16, "Height": 16 } // 可选，默认与 FromArea 大小相同
        },
    ]
}

参见

取自“https://wiki.biligame.com/stardewvalley/index.php?title=模组:Content_Patcher_制作指南/修改图像&oldid=122914”