Wynntils

主要 ID 范围可视化

• 新配置项：第一人称渲染，是否在第一人称视角下渲染你自己的主要 ID 范围，默认启用

神话物品拦截器（Mythic Blocker）

• 功能重命名为“宝箱拦截器”（Chest Blocker）
• 新配置项：绿宝石袋最低等级，用于阻止宝箱关闭的绿宝石袋最低等级，默认为 Eight（八级）
  • 可选选项：None（无）、Seven（七级）、Eight（八级）、Nine（九级）、Ten（十级）

神话发现提示（Mythic Found）

• 功能重命名为“贵重物品发现”（Valuable Found）
• 新配置项：绿宝石袋音效，在发现高等级绿宝石袋时播放的音效，默认为 None（无）
  • 可选选项：None（无）、Classic（经典）、Modern（现代）
• 新配置项：显示绿宝石袋未命中提示，当发现高等级绿宝石袋时是否发送未命中连击提示，默认启用
• 新配置项：绿宝石袋最低等级，将绿宝石袋视为高价值物品的最低等级，默认为 Eight（八级）
  • 可选选项：None（无）、Seven（七级）、Eight（八级）、Nine（九级）、Ten（十级）

功能函数（Functions）

• 新增函数值类型：Time（时间）

活动相关函数（Activity Functions）

• activity_name 返回当前追踪活动名称的字符串
• activity_task 返回当前追踪活动当前任务的字符串
  • formatted 可选布尔参数，是否格式化文本，默认为 true
• activity_type 返回当前追踪活动类型的字符串
• is_tracking_activity 返回是否正在追踪某个活动的布尔值
• activity_color 返回与当前追踪活动类型关联的自定义颜色（CustomColor）

炸弹相关函数（Bomb Functions）

• 所有函数共享以下参数：
  • index 必需整数参数，表示活跃炸弹列表中的索引
  • group 必需布尔参数，是否对炸弹列表进行分组
  • sortOrder 必需字符串参数，排序方式：NEWEST（最新）或 OLDEST（最旧）
• bomb_formatted_string 返回指定炸弹的格式化字符串
• bomb_type 返回指定炸弹类型的字符串
• bomb_world 返回指定炸弹所在世界的字符串
• bomb_start_time 返回指定炸弹开始时间的时间值（Time）
• bomb_length 返回指定炸弹持续时间的浮点数（Float）
• bomb_end_time 返回指定炸弹结束时间的时间值（Time）
• bomb_owner 返回投掷该炸弹玩家的字符串

角色相关函数（Character Functions）

• equipped_aspect 返回指定槽位中已装备的命印（aspect）的命名值（NamedValue）
  • index 必需数字参数，要获取的已装备命印索引（从 0 开始）
• is_aspect_equipped 返回查询的命印是否已装备的布尔值
  • aspectName 必需字符串参数，要搜索的命印名称
• aspect_tier 返回查询命印等级的数字
  • aspectName 必需字符串参数，要搜索的命印名称
• is_riding_horse 返回是否正在骑乘马匹的布尔值
• has_no_gui 返回是否隐藏了默认游戏 HUD 的布尔值
• hummingbirds_state 返回蜂鸟是否正在攻击的布尔值
• ophanim_healing_percent 返回过去 10 秒内通过炽天使（Ophanim）恢复的最大生命值百分比（整数）
• guild_objective_score 返回当前公会目标进度的限制值（CappedValue）
• guild_objective_goal 返回当前公会目标任务的字符串
• personal_objective_score 返回指定个人目标进度的限制值（CappedValue）
  • index 可选整数参数，目标索引，默认为 0
• personal_objective_goal 返回指定个人目标任务的字符串
  • index 可选整数参数，目标索引，默认为 0

战斗相关函数（Combat Functions）

• last_damage_dealt 或 last_dam 返回上次造成伤害的时间（Time）
• last_kill 返回上次击杀的时间（Time）
  • includeShared 可选布尔参数，是否包含共享击杀，默认为 false

条件判断函数（Conditional Functions）

• if 根据给定条件返回对应值，支持所有函数类型
  • condition 必需布尔参数，决定返回哪个值的条件
  • ifTrue 必需参数，条件为真时返回的值
  • ifFalse 必需参数，条件为假时返回的值

环境相关函数（Environment Functions）

• now 返回当前时间作为 Time 值
• wynntils_version 返回当前 Wynntils 版本的字符串
• minecraft_version 返回当前 Minecraft 版本的字符串
• wynncraft_version 返回当前 Wynncraft 版本的字符串

公会相关函数（Guild Functions）

• is_guild_member 返回指定玩家是否在你公会中的布尔值
  • player 必需字符串参数，要检查的玩家名称

哈迪斯队伍函数（Hades Party Functions）

• 所有函数共享以下参数：
  • index 必需整数参数，哈迪斯队伍成员的索引
• hades_party_member_health 返回指定哈迪斯队伍成员生命值的限制值（CappedValue）
• hades_party_member_mana 返回指定哈迪斯队伍成员法力值的限制值（CappedValue）
• hades_party_member_location 返回指定哈迪斯队伍成员的位置（Location）
• hades_party_member_name 返回指定哈迪斯队伍成员名称的字符串

背包相关函数（Inventory Functions）

• inventory_ingredients 返回背包中匹配指定名称的材料数量（整数）
  • name 必需字符串参数，要搜索的材料名称
• ingredient_pouch_ingredients 返回材料袋中匹配指定名称的材料数量（整数）
  • name 必需字符串参数，要搜索的材料名称
• material_count 返回背包中符合指定条件的材料数量（整数）
  • name 必需字符串参数，要搜索的材料名称
  • tier 必需整数参数，要搜索的材料等级
  • exact 必需布尔参数，是否仅搜索精确等级，否则包括更高等级

寻宝跑图函数（Lootrun Functions）

• chests_opened_this_session 或 session_chests 返回当前会话中打开的符合条件的宝箱数量（整数）
  • tier 可选整数参数，要统计的宝箱等级，默认为 1
  • exact 可选布尔参数，是否仅统计精确等级，默认为 false

职业相关函数（Profession Functions）

• last_harvest_xp_gain 返回上次采集获得的经验值（浮点数）
• last_profession_xp_gain 返回上次获得经验的职业名称（字符串）

突袭副本函数（Raid Functions）

• current_raid_start 或 raid_start 返回当前突袭开始的时间（Time）
• current_raid_room_start 返回当前房间开始的时间（Time）
• raid_room_start 返回指定房间开始的时间（Time）
  • roomNumber 必需整数参数，要获取开始时间的房间编号
• raids_run_since 返回过去指定天数内完成的突袭次数（整数）
  • sinceDays 可选整数参数，统计天数，默认为 7
• specific_raid_runs_since 返回过去指定天数内完成的特定突袭次数（整数）
  • raidName 必需字符串参数，突袭名称或缩写
  • sinceDays 必需整数参数，统计天数

社交相关函数（Social Functions）

• is_friend 返回指定玩家是否在你好友列表中的布尔值
  • player 必需字符串参数，要检查的玩家名称
• is_party_member 返回指定玩家是否在你当前队伍中的布尔值
  • player 必需字符串参数，要检查的玩家名称
• wynntils_role 返回你的 Wynntils 角色名称（字符串）
• player_name 返回你的 Minecraft 用户名（字符串）

统计相关函数（Statistics Functions）

• statistics_first_modified_time 返回指定统计数据首次被修改的时间（Time）
  • 参数与其它统计函数相同
• statistics_last_modified_time 返回指定统计数据最后一次被修改的时间（Time）
  • 参数与其它统计函数相同

状态效果函数（Status Effect Functions）

• status_effect_prefix 返回查询状态效果前缀的字符串
  • query 必需字符串参数，要查询的状态效果名称

字符串函数（String Functions）

• to_roman_numerals 返回将指定数字转换为罗马数字的字符串
  • number 必需整数参数，要转换的数字

时间函数（Time Functions）

• timestamp 将给定时间（Time）转换为长整型（Long）
  • time 必需 Time 参数，要转换的时间
• time 将给定时间戳转换为 Time 类型
  • timestamp 必需数字参数，要转换的时间戳
• time_string 或 time_str 将给定时间转换为相对时间字符串（如“5 秒前”或“2 分钟后”）
  • time 必需 Time 参数，要转换的时间
• absolute_time 将给定时间以 yyyy-MM-dd HH:mm 格式转换为字符串
  • time 必需 Time 参数，要转换的时间
• seconds_between 返回两个时间之间相差的秒数（Long）
  • first 必需 Time 参数，第一个时间
  • second 必需 Time 参数，第二个时间
• seconds_since 返回从给定时间至今的秒数（Long）
  • time 必需 Time 参数，起始时间
• time_offset 或 offset 返回带有指定偏移量的新时间（Time）
  • time 必需 Time 参数，原始时间
  • offset 必需数字参数，以秒为单位的偏移量
• format_time_advanced 或 format_date_advanced 按指定格式返回时间字符串
  • time 必需 Time 参数，要格式化的时间
  • format 必需字符串参数，格式模板（如 HH:mm）

战争相关函数（War Functions）

• war_start 返回当前战争开始的时间（Time）
• estimated_war_end 返回当前战争预计结束的时间（Time）

注意：要使命印（aspect）相关函数正常工作，必须先打开命印菜单查看当前已装备和拥有的命印。未来我们将添加自动检测提示。

修复内容（Fixes）

• 修复自定义内容书中未显示世界事件的问题
• 修复自定义内容书下方区域未显示追踪内容详情的问题
• 进一步优化自动攻击功能，本次更新后，在“光之枢纽”中被寄生体控制时将不再激活自动攻击
• 非奖励宝箱内的神话物品现在不会触发未命中计数变化
• “救世主的牺牲”范围将重新正确渲染
• 修复上次采集相关函数的问题
• 希望彻底解决非配置数据损坏问题
  • 包括不通过配置书直接编辑的数据，例如银行页名称、技能点配置等
• 使用自定义字体的状态效果图标现在能在状态效果叠加层中正确渲染
• 在输入原始绿宝石数量进行交易市场价格换算时，不再需要在 -t 前添加空格