自定义令牌

自定义令牌

自定义令牌是一个模组，它为游戏提供了一些额外的令牌功能。 内容修补程序拓展可实现的范围。

自定义令牌注册了以下令牌：

位置令牌：

• 当前玩家所在的矿层等级
• 火山底层，玩家当前所在的火山底层
• DeepestMineLevel，即玩家所达到的最深矿井层级，这包括骷髅洞穴的层数。
• DeepestVolcanoFloor，玩家到达的最深火山底部
• DeepestNormalMineLevel，玩家达到的最深普通矿井层数
• 最深骷髅矿洞层数，达到的最深骷髅矿洞层数
  

婚姻信物：

• 玩家周年纪念日，拆分为两个代币：AnniversaryDay（周年纪念日）和AnniversarySeason（周年纪念季）。
• YearsMarried，已婚总年数
• DaysMarried，已婚总天数
  

任务代币：

• QuestIDsCompleted，一个记录玩家已完成任务ID的列表
• 任务完成数，即已完成的任务总数
• SOIDsCompleted，一份玩家已完成的特殊订单列表，其中包括齐先生的挑战。
• 已完成，不同特殊订单完成总数
  

死亡与疲劳标记：

• 死亡次数，玩家死亡的总次数
• 死亡计数婚后版，作为死亡计数的扩展功能，专门追踪玩家在结婚后的死亡次数。
• DeathCountPK（在PlayerKilled事件中提供比DeathCount令牌更准确的数值）
• DeathCountMarriedPK，作为DeathCountPK的扩展，用于追踪玩家在结婚后的死亡次数。
• PassOutCount，指玩家昏倒的次数。
  

高级代币：

• 孩子，包含有关玩家子女的信息，需要输入参数才能正常工作。
  

查看 自述文件 在GitHub上获取有关令牌的更多信息

版本1.6.0：
- 已更新至1.6版本兼容
版本 1.5.1：
- 此版本为普通矿井、骷髅洞穴和火山的最深层级新增了若干位置标记。

使用自定义令牌：

- 必须安装 SMAPI 4.0 或更高版本。
- 确保自定义令牌在您的内容包中列为依赖项
- 使用的令牌必须以模组的唯一ID为前缀，例如：TheMightyAmondee.CustomTokens/MineLevel
- 许多代币需要更新频率设置为“位置变更时”、“时间变更时”或两者兼有，才能正常工作。

[/列表]子代币：

此令牌恰好需要3个输入参数，且不区分大小写。

第一个参数“player”指定玩家类型。该参数必须为“host”（主机玩家）或“local”（当前玩家，可能为农场助手）中的一种。例如：player=host

第二个参数 childindex 用于指定获取哪个子项的值，它必须是数字，从0开始计数。0代表玩家最年长的孩子，1代表第二年长的孩子，以此类推。例如 childindex=1。

第三个参数指定了你想要获取的值的名称。这可以是生日日期、生日季节、年龄天数、深色皮肤或帽子。

- birthdayday和birthdayseason分别获取孩子出生的月份日期和季节。
- daysold 给出孩子当前的年龄（以天为单位）
- darkskinned 如果孩子使用深色皮肤精灵，则为 true，否则为 false
- 帽子名称显示孩子当前佩戴的帽子名称。注意：对于所有三种颜色的派对帽，此处始终显示为“派对帽”。

如果未找到合适的值，该令牌将等于"null"。

完整令牌的输入参数示例： TheMightyAmondee.CustomTokens/子代：玩家=主机|子索引=0|生日日
 
此令牌返回宿主玩家第一个孩子出生的月份中的日期。

如果需要，GitHub上的README文件对此令牌有更详细的说明。

将旧版或当前存档更新至最新版本（适用于1.3.1及以下版本）：

旧版或当前的存档文件需要进行一些额外的设置。虽然这并非绝对必要，仅在使用相关令牌时才需要操作，但若不进行设置可能会导致令牌数值错误。

在游戏存档开始后，将为每个存档生成一个独立的JSON文件，以便模组能够追踪游戏本身未记录的数据。该文件位于模组文件夹内的"data"目录中。由于初始值默认为0（可能不适用于较早的存档），用户可根据需要调整数值。请注意：修改数值时，请务必将旧追踪器的数值同步更新至当前追踪器的数值。

尽管该模组能够判断大多数任务是否已完成，但对于旧存档文件中先前已完成的部分任务，仍需手动将其任务ID添加至存档JSON文件的"AdditionalQuestsCompleted"项中。自定义任务ID也可在此处添加。

 根据先前已完成的任务情况，该字段应显示为类似以下格式："AdditionalQuestsCompleted": [6,16,128,130] 

[列表]
• 如果您已完成“入门指南”，请添加6
• 若你已进入冒险者公会，则增加16点。
• 如果你已完成秘密纸条25（阿比盖尔），则加128
• 如果你已完成秘密纸条25（卡罗琳），请添加129
• 如果你已经读完《海盗之妻》，请添加130
  

配置：
- 启用“允许调试”功能将添加一个调试命令，以便在SMAPI控制台中查看令牌的数值。启用后，在控制台输入“tracker”将显示令牌值的列表。
- 当离婚时，ResetDeathCountMarriedWhenDivorced 将导致 DeathCountMarried 令牌重置为 0，默认值为 true。


源代码