模组:上衣

← 物品

此页面解释了游戏如何存储和解析“上衣”类型的物品数据。对于物品数据的概述，请参阅模组:物品数据。

概览

上衣是可以被放进玩家的上衣栏的物品。可以改变玩家贴图。

上衣的物品类型为 (S) （在 C# 代码中，也写作 ItemRegistry.type_shirt），其数据存储在 Data/Shirts，其贴图默认存储在 Characters/Farmer/shirts，其代码存储在 StardewValley.Objects.Clothing。

数据格式

数据素材 Data/Shirts 包含一个“字符串 → 数据模型”查询，其中：

• 键为非限定性物品ID。
• 值为包含如下字段的数据模型。

基本数据

字段	含义
Name	（可选） 物品的内部名称。默认为Shirt。
DisplayName Description	（可选） 用于游戏内名称和描述的模板字符串。默认为通用上衣文本（Shirt和A wearable shirt）。
Price	（可选） 玩家购买的价格。默认为50。

外观

字段	含义
Texture	包含此上衣贴图的贴图集素材名称。默认为Characters/Farmer/shirts。 上衣贴图集的宽度必须恰好为 256 像素，分成左右两半：左半边用于存放上衣贴图，右半边用于存放染色遮罩层。如有需要，余下空间可以留白。贴图集的行数不做要求。 贴图 染色遮罩层 /-----------\ /-----------\ ┌────────────────────────────────┐ │ ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐ │ │ │ 0 ││ 1 ││ 2 ││ a ││ b ││ c │ │ │ └───┘└───┘└───┘└───┘└───┘└───┘ │ │ ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐ │ │ │ 3 ││ 4 ││ 5 ││ d ││ e ││ f │ │ │ └───┘└───┘└───┘└───┘└───┘└───┘ │ └────────────────────────────────┘
SpriteIndex	贴图集Texture中的贴图索引，0代表左上角。
DefaultColor	（可选） 玩家没有染色时，上衣的颜色（若有）。参见颜色格式。默认为none。
CanBeDyed	（可选） 玩家是否可染色该上衣。默认为false。
IsPrismatic	（可选） 是否为五彩上衣，即不断地变化颜色。若设置，将覆盖DefaultColor和CanBeDyed字段。默认为false。
HasSleeves	（可选） 是否绘制上衣袖子。默认为true。

其他

字段	含义
CanChooseDuringCharacterCustomization	（可选） 是否可以在自定义玩家角色页面上选择此上衣（即创建角色时的界面）。默认为false。
CustomFields	此条目的自定义数据字段。

另请参阅

• 模组:物品数据提供了物品数据的概述性参考

Modding:Shirts