Wynntils

命令扩展

• 为 /emote 命令添加了 explode 和 faint 参数

容器滚动与搜索高亮

• 板条箱预览容器现在支持滚动和搜索功能

指南与物品猜测

• 更新了装备和材料的获取方式，几乎所有物品现在都会显示其获取方法
• 优化了物品猜测过滤机制，排除更多不可能出现的物品
• 此信息结合了 API 与 Wiki 数据，可能不完全准确，如发现错误请报告以便修复

哈迪斯（Hades）

• “与公会共享信息”配置项现已正常运作

信息框（Info Boxes）

• 新增配置项“颜色模板（Color Template）”，用于设定文本默认颜色，内容函数可覆盖此设置

物品统计信息

• 新增配置项“物品重量来源（Item Weights）”，用于设定显示物品重量时的数据源，选项包括：无（None）、Wynnpool、Nori 或 全部（All），默认为“无”
• 自定义重量数据源将在后续版本中支持

主属性范围可视化（Major ID Range Visualizer）

• 功能已重命名为“范围可视化（Range Visualizer）”
• 新增配置项“显示博弈范围（Show gambit ranges）”，控制是否在选择远见或近视博弈时渲染其对应范围
• 新增配置项“显示主属性范围（Show major ID ranges）”，控制是否渲染你或其他玩家的主属性影响范围
• 守护者（Guardian）范围提升至12
• 利他主义（Altruism）范围提升至16
• 若带有影响附近玩家的主属性装备已被共享，则其范围将被渲染

地图与小地图

• 新增配置项“渲染远程公会玩家（Render Remote Guild Player）”，控制是否渲染连接到 Hades 并处于当前世界中的公会成员

名称标签渲染与玩家查看器

• 现可通过 Hades 查看其他玩家的装备
  • 仅对互为好友、队伍成员及同样连接至 Hades 且运行兼容版本的公会成员共享
• 支持手持物品、护甲和饰品
• 支持普通、精制（crafted）和闪亮（shiny）物品
• 所有共享功能默认关闭，可通过“编辑共享装备”按钮（查看他人装备时可见）或执行 /wynntils gearsharing 命令进行设置
  • 共享选项包含按装备类型开关、是否共享精制装备、是否共享精制物品名称
• 名称标签渲染新增配置项“显示装备百分比（Show Gear Percentage）”，控制是否在装备名称旁显示整体物品占比，默认启用

队伍成员叠加界面（Party Members Overlay）

• 新增配置项“显示头部图标（Show Heads）”，控制是否显示队伍成员头像，默认启用

未识别物品图标

• 更新了 Wynn 风格图标的纹理
• 新增纹理选项“经典（Legacy）”，即此前 Wynn 图标样式

贵重物发现提示（Valuable Found）

• 新增配置项“腐化宝箱发现音效（Corrupted Cache Found Sound）”，在获得腐化宝箱时播放的音效，默认为“Cache”
  • 可选音效：现代（Modern）、经典（Classic）、Cache 或 无（None）
• 新增配置项“显示宝箱空手消息（Show Cache Dry Streak Message）”，控制是否在获得腐化宝箱时发送提示消息，默认启用
• “Cache”音效选项现已可用于其他音效配置：跑图（lootrun）、宝箱（loot chest）、化身（aspect）、古籍（tome）和绿宝石袋（emerald pouch）

贵重物品保护（Valuables Protection）

• 现在支持物品标识符附魔界面

Wynncraft 按钮

• 新增配置项“断开后返回标题画面（Return to title screen after disconnect）”，控制通过该按钮进入服务器后断开连接时是否返回主菜单而非服务器列表，默认启用

功能函数（Functions）

• 世界事件相关函数
  • annihilation_dry_count、dry_annis 或 dry_anni_count：返回整数，表示未获得腐化宝箱的情况下完成的歼灭（Annihilation）世界事件次数
  • current_world_event：返回字符串，表示你当前所在范围内的世界事件名称
  • current_world_event_start_time：返回时间值，表示你当前所在范围内的世界事件开始时间
  • world_event_start_time：返回时间值，表示指定世界事件的开始时间
    • worldEventName：必需字符串参数，指定要查询的世界事件名称（区分大小写）
    • 当前这些时间数据来源于聊天记录或接近世界事件时的检测

统计数据（Statistics）

• 已完成歼灭事件（Annihilations completed）：已完成的歼灭世界事件数量
• 失败歼灭事件（Annihilations failed）：失败的歼灭世界事件数量
• 获得腐化宝箱（Corrupted Caches Found）：已获得的腐化宝箱数量

修复（Fixes）

• 修复了自定义加载界面的多个问题，使其更加流畅
• 修复了聊天标签导致角色选择界面在首次加入前无法显示聊天的问题
• 物品锁定图标不再在组队匹配成功界面中渲染

命令扩展

• 为 /emote 命令添加了 explode 和 faint 参数

容器滚动与搜索高亮

• 板条箱预览容器现在支持滚动和搜索

指南与物品猜测

• 更新了装备和材料的获取方式，几乎所有物品现在都会显示其获取方法
• 优化了物品猜测过滤机制，排除更多不可能出现的物品
• 此信息结合了 API 与 Wiki 数据，可能不完全准确，请报告任何错误以便我们修复

哈迪斯（Hades）

• “与公会共享信息”配置现已生效

信息框

• 新增配置项“颜色模板”，用于设置文本默认颜色，除非内容函数另有指定

物品统计信息

• 新增配置项“物品重量来源”，用于选择显示物品重量时所使用的数据源，选项为：无、Wynnpool、Nori 或 全部，默认为“无”
• 自定义重量来源将在未来版本中支持

主属性范围可视化

• 功能重命名为“范围可视化”
• 新增配置项“显示博弈范围”，控制是否在选择了远见或近视的博弈后显示其对应范围
• 新增配置项“显示主属性范围”，控制是否渲染你或其他玩家主属性的影响范围
• 守护者（Guardian）范围提升至12
• 利他主义（Altruism）范围提升至16
• 若带有影响附近玩家的主属性装备已被共享，则其范围将被渲染

地图与小地图

• 新增配置项“渲染远程公会玩家”，控制是否显示已连接至 Hades 并处于当前世界的公会成员

名字标签渲染与玩家查看器

• 现在可通过 Hades 查看玩家装备
  • 仅对互为好友、队伍成员以及同样连接至 Hades 并运行兼容版本的公会成员共享
• 支持手持物品、护甲和饰品
• 支持普通、精制及闪光物品
• 所有共享功能默认关闭，可通过“编辑共享装备”按钮（查看他人装备时可见）或执行 /wynntils gearsharing 命令进行设置
  • 共享选项包括按装备类型开关、是否共享精制装备、是否共享精制物品名称
• 名字标签新增配置项“显示装备百分比”，控制是否在装备名称旁显示整体物品占比，默认启用

队伍成员覆盖层

• 新增配置项“显示头像”，控制是否显示队伍成员的头像，默认启用

未鉴定物品图标

• 更新了 Wynn 风格图标的纹理
• 新增纹理选项“Legacy”，即本次更改前的 Wynn 图标样式

贵重物品发现提示

• 新增配置项“腐化宝箱发现音效”，在获得腐化宝箱时播放的声音，默认为 Cache
  • 可选音效：Modern、Classic、Cache 或 None
• 新增配置项“显示宝箱空手提示消息”，控制获得腐化宝箱时是否发送提示消息，默认启用
• Cache 音效选项现已可用于其他声音配置：拾取跑（lootrun）、宝箱、化身（aspect）、古籍（tome）和绿宝石袋（emerald pouch）

贵重物品保护

• 现在支持物品标识符附魔界面

Wynncraft 按钮

• 新增配置项“断开后返回主菜单”，控制通过该按钮进入服务器后断开连接时是否返回标题画面而非服务器列表，默认启用

功能函数

• 世界事件相关函数
  • annihilation_dry_count、dry_annis 或 dry_anni_count：返回未获得腐化宝箱的情况下完成的湮灭（Annihilation）世界事件次数（整数）
  • current_world_event：返回当前所在世界事件区域内的事件名称（字符串）
  • current_world_event_start_time：返回当前所在世界事件区域内的事件开始时间（时间类型）
  • world_event_start_time：返回指定世界事件的开始时间（时间类型）
    • worldEventName：必需字符串参数，指定要查询开始时间的世界事件名称，区分大小写
    • 当前这些时间数据来源于聊天记录或接近世界事件时的信息

统计数据

• 已完成湮灭：已完成的湮灭世界事件数量
• 失败湮灭：失败的湮灭世界事件数量
• 腐化宝箱发现数：已找到的腐化宝箱数量

修复

• 修复了自定义加载界面的多个问题，使其更加流畅
• 修复了聊天标签导致角色选择界面在首次加入前无法显示聊天的问题
• 物品锁定图标不再在组队匹配成功界面上渲染

贵重物品保护

• 新增配置项 Require Ctrl to Sell，用于设置是否需要按住 Ctrl 键才能向铁匠出售贵重物品，默认关闭

修复

• 修复了交易市场中价格匹配按钮的压价问题
• 修复了 status_effect_modifier 函数在处理无修饰器的状态效果时崩溃的问题

修复

• 修复首次启动时崩溃以及部分数据无法保存的问题

自定义物品高亮

• 工匠袋现在会被高亮显示

物品文本叠加

• 新增配置项“工匠袋突袭类型缩写”，用于控制是否在工匠袋上显示其突袭类型的缩写
• 新增配置项“工匠袋文本阴影”，用于设置文本显示的阴影样式

个人存储工具

• 新增配置项“已选快速跳转文本颜色”，用于设置当前所在页面的文本颜色，默认为绿色 (#00ff00)
• 新增配置项“锁定快速跳转文本颜色”，用于设置尚未解锁/访问页面的文本颜色，默认为灰色 (#636363)

法术施放信息叠加

• 新增叠加层“法术输入叠加”，将法术输入以叠加形式渲染显示
  • 输入样式配置：法术输入应以何种样式显示，默认为“Original”（原始）
    • 共4个选项：“Original”在等级11前使用完整图标；“Full”始终使用完整图标；“Small”始终使用小图标；“Legacy”使用2.1版本之前的样式
  • 显示原始输入配置：是否渲染默认的法术输入提示，默认关闭

主播模式叠加层

• 默认处于关闭状态
• 主播模式叠加层：在启用主播模式时显示特定文本
• 显示原始进度条配置：是否显示默认的主播模式首领血条，默认关闭

Wynntils 命令

• 添加 map 参数，用于打开主地图
• 添加 guildmap 参数，用于打开公会地图

修复

• 修复好友列表解析不正确的问题
• 修复队伍队长身份未能始终正确识别的问题

自定义物品高亮

• 现在会高亮显示制造者背包

物品文本覆盖

• 新增配置项“制造者背包突袭类型缩写”，用于控制是否在制造者背包上显示其突袭类型的缩写
• 新增配置项“制造者背包文本阴影”，用于设置文本显示的阴影类型

个人存储工具

• 新增配置项“已选快速跳转文本颜色”，用于设置当前所在页面的文本颜色，默认为绿色 (#00ff00)
• 新增配置项“锁定快速跳转文本颜色”，用于设置尚未解锁/访问页面的文本颜色，默认为灰色 (#636363)

法术施放消息覆盖

• 新增覆盖层“法术输入覆盖层”，将法术输入以覆盖层形式渲染
  • 输入样式配置：法术输入应以何种样式显示，默认为“原始”(Original)
    • 共4个选项：“原始”在等级11前使用完整图标，“完整”始终使用完整图标，“小型”始终使用小图标，“旧版”使用2.1版本前的样式
  • 显示原始输入配置：是否渲染默认的法术输入提示，默认关闭

主播覆盖层

• 默认禁用
• 主播模式覆盖层：在启用主播模式时显示文本
• 显示原始进度条配置：是否显示默认的主播模式Boss进度条，默认关闭

Wynntils 命令

• 添加 map 参数，用于打开主地图
• 添加 guildmap 参数，用于打开公会地图

修复

• 修复好友列表无法正确解析的问题
• 修复队伍队长身份有时无法正确识别的问题

修复

• 修复首次启动时崩溃以及部分数据无法保存的问题

修复

• 修复在检查不存在的索引时 personal_objective_goal 和 personal_objective_score 导致崩溃的问题
• 修复启用分组炸弹（Group Bombs）时，炸弹铃覆盖界面的“最大炸弹数”配置仍应用于所有炸弹的问题

修复

• 修复在检查不存在的索引时 personal_objective_goal 和 personal_objective_score 导致崩溃的问题
• 修复启用分组炸弹时，炸弹铃铛叠加层的最大炸弹数配置仍应用于所有炸弹的问题

贵重物品保护

• 新增配置项“Require Ctrl to Sell”，用于设置是否需要按住 Ctrl 键才能向铁匠出售贵重物品，默认关闭

修复

• 修复了交易市场中价格匹配按钮的压价问题
• 修复了 status_effect_modifier 函数在处理无修饰器的状态效果时崩溃的问题

主要 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 前添加空格

主要 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 前添加空格

修复

• 修复了各种覆盖物在渲染预览时崩溃的问题
• 修复了物品截图具有不正确颜色的问题

修复

• 修复了各种覆盖层在渲染预览时崩溃的问题
• 修复了物品截图具有不正确颜色的问题

自动攻击

• 重新设计，希望能解决问题
• 目前仍默认为禁用状态

聊天物品

• 还原修复，以使聊天物品在使用某些模组和/或客户端时不显示石头

战利品运行覆盖物

• 新的覆盖物“战利品运行试炼”，显示当前战利品运行的所选试炼
• 略微调整了任务覆盖物的默认垂直位置

命名牌渲染，温特尔斯化妆品

• 排行榜徽章、温特尔斯披风、标记和角色现在将显示在幽灵上
  • 对于与温特尔斯相关的信息/化妆品，幽灵可能不会立即显示该信息/化妆品

覆盖物

• 所有覆盖物现在都有一个“启用模板”选项，可用于自定义使用函数时应何时渲染它们
  • 如果未提供有效的模板，当您在世界中且未骑乘显示实体时（用于您看到自己玩家的情况），覆盖物将渲染。某些覆盖物会覆盖此设置并使用其他条件，如自定义玩家列表或战利品运行覆盖物

函数

• 字体函数
  • to_fancy_text 和 to_background_text，如果给定字符在字体中不可用，则将使用普通字体渲染
• 战利品运行函数
  • lootrun_trial 返回给定索引处的战利品运行试炼名称，或如果尚未选择则为“未知”
    • index 必需的数字参数，要获取的试炼索引（从索引 0 开始）

修复

• 再次收集战利品箱位置
• 现在使用左键打开战利品箱将可以获取位置
• 在使用药丸样式的右侧边缘时，为 to_background_text 函数添加了缺失的负空间
• 修复银行快速跳转在某些条件下无法跳转的问题
• 如果有牺牲选项，现在将处理战利品运行重新投掷
• 修复了聊天物品被锁定为特定显示类型的问题
• 可能修复了哈迪斯连接失败导致游戏挂起的问题

自动攻击

• 进行了重新设计，希望能解决问题
• 目前仍默认为禁用状态

聊天物品

• 恢复了修复，以使聊天物品在使用某些模组和/或客户端时不显示石头

战利品运行叠加层

• 新的叠加层战利品运行试炼，显示当前战利品运行的所选试炼
• 略微调整了任务叠加层的默认垂直位置

名称标签渲染，温特尔斯化妆品

• 排行榜徽章、温特尔斯披风、标记和角色现在将显示在幽灵上
  • 对于与温特尔斯相关的信息/化妆品，幽灵可能不会立即显示该信息/化妆品

叠加层

• 所有叠加层现在都有一个“启用模板”选项，可使用函数自定义它们应在何时渲染
  • 如果未提供有效的模板，当您在世界中且未骑乘显示实体时（用于您看到自己玩家的情况），叠加层将渲染。某些叠加层会覆盖此设置并使用其他条件，如自定义玩家列表或战利品运行叠加层

函数

• 字体函数
  • to_fancy_text 和 to_background_text，如果给定字符在字体中不可用，则将使用普通字体进行渲染
• 战利品运行函数
  • lootrun_trial 返回给定索引处的战利品运行试炼名称，如果尚未选择则为“未知”
    • index 必需的数字参数，要获取的试炼的索引（从索引 0 开始）

修复

• 再次收集战利品箱位置
• 现在使用左键打开战利品箱将可用于获取位置
• 在使用药丸样式的右边缘时，为 to_background_text 函数添加了缺失的负空间
• 修复了银行快速跳转在某些条件下不跳转的问题
• 如果有牺牲选项，战利品运行重掷现在将得到处理
• 修复了聊天物品被锁定为特定显示类型的问题
• 可能修复了哈迪斯连接失败导致游戏挂起的问题

批量购买

• 按住 shift 键悬停在可批量购买的物品上时，物品名称现在将显示将购买的数量

命令扩展

• 向 /emotes 和 /emote 添加了参数
  • 目前这将列出所有表情，在未来的版本中，它将仅显示可用的表情
• 删除了 /scrap

容器滚动

• 存储页面现在可滚动

容器搜索高亮

• 在化妆品菜单配置中添加了搜索栏，涵盖所有化妆品类型，默认启用
• 在头盔化妆品菜单配置中删除了搜索栏
• 在宠物菜单配置中删除了搜索栏
• 在玩家效果菜单配置中删除了搜索栏
• 在武器化妆品菜单配置中删除了搜索栏
• 在废品菜单配置中删除了搜索栏

耐久性覆盖

• 新的渲染模式百分比，将在物品下方以百分比形式渲染耐久性

隐藏损坏标签

• 将功能重命名为隐藏标签
• 隐藏损坏标签现在是一个配置，默认仍为禁用
  • 如果您之前启用了该功能，它将延续到此配置中
• 新的配置隐藏击杀标签，在击杀怪物时将隐藏标签，默认禁用

隐藏不相关的工具提示信息

• 删除了隐藏附加工具提示信息配置，此配置之前隐藏的信息不再显示

骑马

• 新的配置召唤尝试次数，在停止之前应尝试骑马的次数，默认 8

个人存储实用程序

• 为杂项桶和书架页面 11 和 12 添加了支持
• 尚未访问/解锁的页面现在有红色文本
• 更改了快速跳转按钮工具提示

设置屏幕

• 悬停在左侧页面上的功能上时，现在将在右侧页面上显示其配置，直到选择了一个功能
  • 这些只是视觉效果，要实际编辑它们，仍需要在左侧页面上单击它们
• 通过 esc 关闭已与设置交互的屏幕时，现在将提示保存更改
  • 通过指定的保存/丢弃更改按钮关闭屏幕时，不会给出此提示

修复

• 化妆品页面现在又可以滚动了
• 废品菜单现在又可以滚动了
• 使用某些模组和/或客户端时，聊天物品不应再显示为石头
• capped_inventory_slots 和 inventory_free 函数现在考虑了删除灵魂点所带来的额外插槽
• 修复如果骑马失败则无法换回原始物品的骑马问题

批量购买

• 按住 shift 键悬停在可批量购买的物品上时，物品名称现在将显示将购买的数量

命令扩展

• 向 /emotes 和 /emote 添加了参数
  • 目前这将列出所有表情，在未来的版本中，它将只显示可用的表情
• 移除了 /scrap

容器滚动

• 存储页面现在可滚动

容器搜索高亮

• 在化妆品菜单配置中添加了搜索栏，涵盖所有化妆品类型，默认启用
• 从头盔化妆品菜单配置中移除了搜索栏
• 从宠物菜单配置中移除了搜索栏
• 从玩家效果菜单配置中移除了搜索栏
• 从武器化妆品菜单配置中移除了搜索栏
• 从废品菜单配置中移除了搜索栏

耐久性叠加

• 新的渲染模式百分比，将在物品下方以百分比形式渲染耐久性

隐藏损坏标签

• 将功能重命名为隐藏标签
• 隐藏损坏标签现在是一个配置，默认仍为禁用
  • 如果您之前启用了该功能，它将延续到此配置中
• 新的配置隐藏击杀标签，将在杀死怪物时隐藏标签，默认禁用

隐藏不相关的工具提示信息

• 移除了隐藏额外工具提示信息配置，此配置之前隐藏的信息不再显示

骑马

• 新的配置召唤尝试次数，在停止之前应尝试骑马的次数，默认 8

个人存储实用程序

• 为杂项桶和书架页面 11 和 12 添加了支持
• 尚未访问/解锁的页面现在显示红色文本
• 更改了快速跳转按钮工具提示

设置屏幕

• 悬停在左侧页面上的功能上时，现在将在右侧页面上显示其配置，直到选择了一个功能
  • 这些只是视觉效果，要实际编辑它们，仍需要在左侧页面上单击它们
• 通过 esc 关闭已与设置交互的屏幕时，现在将提示保存更改
  • 通过指定的保存/丢弃更改按钮关闭屏幕时，不会给出此提示

修复

• 化妆品页面现在又可以滚动了
• 废品菜单现在又可以滚动了
• 使用某些模组和/或客户端时，聊天物品不应再显示为石头
• capped_inventory_slots 和 inventory_free 函数现在考虑了从灵魂点中移除的额外插槽
• 修复了骑马时如果未能骑上马则无法换回原始物品的问题

自定义内容书、自定义公会日志和自定义领地管理屏幕

• 如果当前没有聚焦文本输入，按下库存键（E）现在将关闭这些屏幕

神话发现

• 战利品抽奖现在处理重新抽奖

修复

• 萨满图腾叠加文本颜色配置现在将正确更新
• 修复战利品抽奖未递增

自定义内容书、自定义公会日志和自定义领地管理屏幕

• 如果当前没有文本输入获得焦点，按下物品栏键（E）现在将关闭这些屏幕

神话发现

• 战利品抽取现在处理重新抽取

修复

• 萨满图腾叠加文本颜色配置现在将正确更新
• 修复战利品抽取不递增