模组:饰品

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

概览

饰品是可以放入玩家的饰品栏以实现特定效果的物品。

饰品的物品类型为 (TR) （在 C# 代码中，也写作 ItemRegistry.type_trinket），其数据存储在 Data/Trinkets，其原版贴图存储在 TileSheets\Objects_2，其代码存储在 StardewValley.Objects.Trinkets.Trinket。

数据格式

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

键为非限定性物品ID和内部名称。
值为包含如下字段的数据模型。

字段含义

Id

此物品的唯一字符串ID。应当与键名保持一致。

下面的内容或特性计划在即将到来的 1.6.15 版本实装，描述的内容可能会和正式发布的版本有差异。
此字段在 1.6.15 版本中被移除。

DisplayName
Description 用于显示此物品名称和描述的模板字符串。

Texture 此物品贴图所在贴图集的素材名称。

SheetIndex 此物品在 Texture 中的贴图集索引，其中 0 为左上角。

TrinketEffectClass

C# 的 TrinketEffect 子类，用于实现饰品行为。可以安心使用模组类，因为不会写入到存档文件。

此字段应当为形如 namespace.class, assembly 的完整程序集限定名。例如：StardewValley.Objects.Trinkets.CompanionTrinketEffect, StardewValley。

DropsNaturally （可选）此物品是否可以随机生成（例如，在矿井宝箱中）。默认为 true。

CanBeReforged （可选）玩家是否可以用铁砧重置饰品状态，假设 TrinketEffectClass 实现了 GenerateRandomStats 方法。默认为 true。

CustomFields （可选）此物品的自定义字段。

ModData

（可选）添加到此饰品的模组数据字段，用于创建饰品实例。默认为 none。

例如：

"ModData": {
    "Example.ModId_FieldName": "some custom data"
}

另请参阅

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

Modding:Trinkets