Wynntils

主要 ID 范围可视化器

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

Mythic Blocker（已重命名）

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

Mythic Found（已重命名）

• 功能更名为 Valuable Found（珍贵物品发现）
• 新配置项：绿宝石袋音效，发现高等级绿宝石袋时播放的声音，默认为 None（无）
  • 可选项：None（无）、Classic（经典）、Modern（现代）
• 新配置项：显示绿宝石袋干旱提示信息，发现高等级绿宝石袋时是否发送干旱 streak 提示，默认启用
• 新配置项：绿宝石袋最低等级，将绿宝石袋视为高价值的最低等级，默认为 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 返回指定炸弹持续时间的浮点数
• 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 队伍函数（Hades Party Functions）
所有函数共享以下参数：

• index 必需整数参数，Hades 队伍成员的索引

函数列表：

• hades_party_member_health 返回指定 Hades 队员的生命值（CappedValue）
• hades_party_member_mana 返回指定 Hades 队员的法力值（CappedValue）
• hades_party_member_location 返回指定 Hades 队员的位置（Location）
• hades_party_member_name 返回指定 Hades 队员名称的字符串

背包相关函数（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 按指定格式返回时间字符串（如 HH:mm）
  • time 必需 Time 参数
  • format 必需字符串参数，时间格式

战争函数（War Functions）

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

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

修复内容（Fixes）

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