维护提醒

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

全站通知：

模组:果树数据

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

←目录

此页面解释该游戏是如何存储和解析果树数据。

原始数据

果树数据存储在Content\Data\FruitTrees.xnb中, 编辑文件时需进行解包。

以下是1.6.8版本的果树原始数据：

数据格式

Data/FruitTrees 由以下字符串组成：

字段 说明
DisplayName 用于显示树名的模板字符串。不可包含“tree”字样（比如樱桃树的DisplayName为“Cherry”）。此名称可用于某些UI信息，例如“您的DisplayName树昨晚无法生长。”
Seasons 果树结果的季节。应为季节名称的数组（季节名：spring，summer，fall或winter）。
Fruit 当果树处于当季时，水果物品将每天添加到对应的果树上。

该字段为包含如下字段的数据模型所组成的列表：

字段 效果
公共字段 参见物品生成字段以获取果树物品支持的通用物品字段。

说明：

  • 若设为返回多个物品的物品查询，则会在其中随机选取一个物品。
  • 在无季节地点，例如温室或姜岛，季节条件将被自动忽略。
Season （可选） 若设置此字段，则该数据模型仅在树所在地点处于指定季节时适用。在无季节地点，例如温室或姜岛，季节条件将被自动忽略。
Chance （可选） 选择此数据模型的概率，为0（不可能）至 1（必然）之间的值。默认为1（100%概率）。
Texture 游戏的Content文件夹中储存的贴图对应的素材名称。如需要，可使用\（在JSON中需使用\\）来分隔名称区段。例如，原版果树贴图素材名称为TileSheets\fruitTrees。
TextureSpriteRow 果树在Texture给出的贴图集中的行索引（例如，0代表第一，1代表第二，以此类推）。
PlantableLocationRules （可选） 决定可以种植该果树的地点（若可用）。会使用第一个匹配的规则。可重写地点检查（例如作物只能种在农场中），但不可重写内建的要求，例如作物需要土壤。

该字段为包含以下字段的数据模型所组成的列表：

字段 效果
Id 当前列表中该规则所对应地点的唯一字符串ID。
Result 若当前列表中该规则被选中，则该字段指示树苗是否可以种植在当前地点。可能的取值为：
  • Default：如果正常情况下当前地点允许种植树苗，则可以种植。该取值能够停止检查后续规则。若不可种植，会显示自定义的DeniedMessage.
  • Allow：强制允许树苗种在当前地点，无论正常情况下当前地点是否允许种植。
  • Deny: 强制禁止树苗种在当前地点，无论正常情况下当前地点是否允许种植。
Condition （可选） 指示该规则是否可用的游戏状态查询。默认为true。
PlantedIn （可选） 当前规则适用的种植环境。可能的取值为Ground（直接种在地上）、GardenPot（种在花盆里）或Any。默认为Any。

注意：虽然上述可能的取值中列出了花盆选项，但实际上不可将树苗种在花盆中。

DeniedMessage （可选） 一个模板字符串。若此规则禁止种植树苗，则显示此信息。亦可取值为null显示默认信息。当Result为Default也适用。
CustomFields 该规则的自定义字段。

例如，如下内容包添加了一个自定义果树，包括自定义树苗和水果： 

{
    "Format": "2.7.0",
    "Changes": [
        // add fruit + sapling items
        // note: sapling must have an edibility under 0 (usually -300) to be plantable
        {
            "Action": "EditData",
            "Target": "Data/Objects",
            "Entries": {
                "{{ModId}}_Pufferfruit": {
                    "Name": "{{ModId}}_Pufferfruit", // best practice to match the ID, since it's sometimes used as an alternate ID
                    "DisplayName": "Pufferfruit",
                    "Description": "An example fruit item.",
                    "Type": "Basic",
                    "Category": -6,
                    "Price": 1200,

                    "Texture": "Mods/{{ModId}}/Objects",
                    "SpriteIndex": 0
                },
                "{{ModId}}_Puffersapling": {
                    "Name": "{{ModId}}_Puffersapling",
                    "DisplayName": "Puffersapling",
                    "Description": "An example tree sapling.",
                    "Type": "Basic",
                    "Category": -74,
                    "Price": 1200,

                    "Texture": "Mods/{{ModId}}/Objects",
                    "SpriteIndex": 1
                }
            }
        },

        // add fruit tree
        {
            "Action": "EditData",
            "Target": "Data/FruitTrees",
            "Entries": {
                "{{ModId}}_Puffersapling": {
                    "DisplayName": "Pufferfruit",
                    "Seasons": [ "spring" ],
                    "Fruit": [
                        {
                            "Id": "E{{ModId}}_Pufferfruit",
                            "ItemId": "{{ModId}}_Pufferfruit"
                        }
                    ],
                    "Texture": "Mods/{{ModId}}/FruitTrees",
                    "TextureSpriteRow": 0
                }
            }
        },

        // add images
        {
            "Action": "Load",
            "Target": "Mods/{{ModId}}/FruitTrees, Mods/{{ModId}}/Objects",
            "FromFile": "assets/{{TargetWithoutPath}}.png" // assets/FruitTrees.png, assets/Objects.png
        },
    ]
}

然后，果树就可以通过树苗种植，树苗可以按正常方式（例如通过商店）给予玩家。

水果物品

对于C# 模组，fruitsOnTree 字段(果树上水果的数量) 被替换为fruit (水果的列表).

生成果树

自定义果树可以用如下方法添加到游戏：

  • 当地点被创建时就在地块上直接生成。这通过如下地块属性实现：SpawnTree: fruit <tree ID> [growth stage on location created] [growth stage on day-update regrowth]。 必须添加在Paths层，且应在paths地块表中索引为34。
  • 也可按常规方式给予玩家树苗（例如通过商店或邮件）。

取自“https://wiki.biligame.com/stardewvalley/index.php?title=模组:果树数据&oldid=107709”