字符串函数
- from_codepoint：将给定数字转换为等效的字符串字符
  - codepoint：必需的数字参数，要转换的字符编码
StyledText 函数
- styled_text：将给定字符串转换为 StyledText
  - value：必需的字符串参数，要转换为 StyledText 的字符串
- concat_styled_text 或 concat_st：将一组 StyledText 连接在一起
  - values：必需的参数，一组 StyledText
- with_atlas_sprite_font：使用指定图集精灵渲染给定的 StyledText
  - value：必需的 StyledText 参数，要作为图集精灵显示的文本
  - atlas：必需的字符串参数，要使用的图集的命名空间路径
  - sprite：必需的字符串参数，要使用的精灵的名称路径
- with_player_sprite：使用指定玩家模型渲染给定的 StyledText
  - value：必需的 StyledText 参数，要作为玩家精灵显示的文本
  - uuid：必需的字符串参数，要使用的玩家 UUID
  - hat：必需的布尔参数，是否渲染玩家的帽子层
- with_resource_font 或 with_font：使用指定字体渲染 StyledText
  - value：必需的 StyledText 参数，要渲染的文本
  - font：必需的字符串参数，要使用的字体的命名空间路径
- with_color：将指定颜色应用于整个 StyledText（除非被覆盖）
  - color：必需的 CustomColor 参数，要应用于 StyledText 的颜色
- with_bold：将粗体应用于整个 StyledText
  - isBold：必需的布尔参数，是否应用粗体
- with_italic：将斜体应用于整个 StyledText
  - isItalic：必需的布尔参数，是否应用斜体
- with_strikethrough：将删除线应用于整个 StyledText
  - isStrikethrough：必需的布尔参数，是否应用删除线
- with_obfuscated：将混淆效果应用于整个 StyledText
  - isObfuscated：必需的布尔参数，是否应用混淆
- with_shadow_color：将指定颜色应用于整个 StyledText 的阴影（除非被覆盖）
  - color：必需的 CustomColor 参数，要应用于 StyledText 阴影的颜色
  - 此效果仅在叠加层使用 Normal 文本阴影配置时可见
- with_underlined：将下划线应用于整个 StyledText
  - isUnderlined：必需的布尔参数，是否应用下划线
阴间游戏队伍函数
- hades_party_member_uuid：以字符串形式返回指定阴间游戏队伍成员的 UUID
  - index：必需的整数参数，要获取的队伍成员索引
社交函数
- player_uuid 或 uuid：以字符串形式返回你的 UUID
物品栏函数
- equipped_accessory_name：以字符串形式返回指定配件类型的名称；若未找到配件，则返回 "NONE"
  - accessory：必需的字符串参数，要检索的配件类型，例如 "Ring_1" 或 "Bracelet"

修复

叠加层在禁用时将停止渲染
修复在 1.5 倍经验加成下生物击杀数无法被检测的问题
负面效果函数现在使用玩家眼睛位置而非摄像机位置
指南中的模拟器与绝缘体现在正确标明通过战利品路线获得，而非袭击

Wynntils (fabric) v4.0.1

on 2026 Feb 19

下载

指南

将“绿宝石袋指南”重命名为“绿宝石指南”，并添加了绿宝石、绿宝石块和熔融绿宝石物品
将“符文指南”重命名为“杂项物品指南”，并添加了地牢钥匙

路径点管理界面

按住 Shift 并点击图标过滤按钮，将在排除与包含所有其他图标之间切换

函数

字符串函数
- from_codepoint：将给定数字转换为对应的字符串字符
  - codepoint：必需的数字参数，要转换的字符编码
StyledText 函数
- styled_text：将给定字符串转换为 StyledText
  - value：必需的字符串参数，要转换为 StyledText 的字符串
- concat_styled_text 或 concat_st：将一组 StyledText 连接在一起
  - values：必需的参数，一组 StyledText
- with_atlas_sprite_font：使用指定图集精灵渲染给定的 StyledText
  - value：必需的 StyledText 参数，要以图集精灵形式显示的文本
  - atlas：必需的字符串参数，要使用的图集的命名空间路径
  - sprite：必需的字符串参数，要使用的精灵的名称路径
- with_player_sprite：使用指定玩家模型渲染给定的 StyledText
  - value：必需的 StyledText 参数，要以玩家精灵形式显示的文本
  - uuid：必需的字符串参数，要使用的玩家 UUID
  - hat：必需的布尔参数，是否渲染玩家的帽子层
- with_resource_font 或 with_font：使用指定字体渲染 StyledText
  - value：必需的 StyledText 参数，要渲染的文本
  - font：必需的字符串参数，要使用的字体的命名空间路径
- with_color：将指定颜色应用于整个 StyledText（除非被覆盖）
  - color：必需的 CustomColor 参数，要应用于 StyledText 的颜色
- with_bold：对整个 StyledText 应用粗体
  - isBold：必需的布尔参数，是否应用粗体
- with_italic：对整个 StyledText 应用斜体
  - isItalic：必需的布尔参数，是否应用斜体
- with_strikethrough：对整个 StyledText 应用删除线
  - isStrikethrough：必需的布尔参数，是否应用删除线
- with_obfuscated：对整个 StyledText 应用混淆效果
  - isObfuscated：必需的布尔参数，是否应用混淆
- with_shadow_color：将指定颜色应用于整个 StyledText 的阴影（除非被覆盖）
  - color：必需的 CustomColor 参数，要应用于 StyledText 阴影的颜色
  - 此效果仅在叠加层使用 Normal 文本阴影配置时可见
- with_underlined：对整个 StyledText 应用下划线
  - isUnderlined：必需的布尔参数，是否应用下划线
阴间游戏队伍函数
- hades_party_member_uuid：返回指定阴间游戏队伍成员的 UUID（字符串形式）
  - index：必需的整数参数，要获取的队伍成员索引
社交函数
- player_uuid 或 uuid：返回你自己的 UUID（字符串形式）
物品栏函数
- equipped_accessory_name：返回指定配件类型的名称（字符串形式），若未找到配件则返回 "NONE"
  - accessory：必需的字符串参数，要检索的配件类型，例如 "Ring_1" 或 "Bracelet"

修复

叠加层在禁用时将停止渲染
修复在 1.5 倍经验加成下生物击杀数无法被检测的问题
负面效果函数现在使用玩家眼睛位置而非摄像机位置
指南中的模拟器与绝缘体现在正确标明通过战利品路线获得，而非袭击

Wynntils (fabric) v4.0.0

on 2026 Feb 14

下载

更新至 Minecraft 1.21.11

（仅限 Fabric）更新所需的 Fabric 版本至 0.18.4

（仅限 NeoForge）更新所需的 NeoForge 版本至 21.11.23-beta

按各自的功能类别分类按键绑定

所有地图界面

移除地图按钮背景中的空白空间
在右下角添加缩放按钮和滑块

自动应用资源包

如果不使用 OpenGL（例如 Vulkan），将不再生效

自动跳过过场动画

新配置 Send Notification，是否在自动跳过/投票跳过过场动画时发送通知，默认启用

炸弹铃命令

没有可用炸弹的消息现在使用聊天等级字体显示等级

聊天物品

将默认的 Share Item 键绑定更改为 F5

坐标叠加层

现在复制原版坐标
- 可以通过函数重新创建之前的叠加层样式
默认位置移动到原版坐标的显示位置
Should Display Original 配置现在默认禁用
移除彩色配置
Replace Direction 配置，用 Y 坐标替换方位方向，默认禁用
Compass Style 配置，更改叠加层末端指南针的样式，Static 总是指向前方，Animated 根据相机旋转始终指向北方，None 移除指南针，默认为 Static
Compass End 配置，指南针应位于叠加层的哪一端，head 或 tail，默认为 tail

自定义物品高亮

添加新的高亮纹理选项 Wynn，并将其设为默认

增强的主播模式

在所有配置文件中默认禁用
所有配置仅在主播模式下激活
Hide Hotbar Weapons 配置，将热键栏中的武器替换为其类型的字母（法杖 -> W，匕首 -> D 等），默认禁用
Hide Equipped Gear 配置，防止查看物品栏时渲染装备的装备，默认禁用
Hide Gear Tooltips 配置，悬停在物品栏中的装备上不会显示通常的提示框，除非按住空格键，默认禁用

扩展物品数量

新配置 Hold Ctrl to Show Level，允许禁用按住 Ctrl 查看物品等级的功能，默认启用

指南

现可以在网页物品指南中打开秘典和符咒
添加模块拓展指南
添加符文指南
即使 Wynncraft API 过期，也可以更新物品纹理

队伍地图界面

添加财库过滤按钮
添加按钮切换到主地图并保持当前位置和缩放级别
在队伍地图上按下打开地图键绑定时将保持当前位置和缩放级别

主地图界面

添加按钮切换到队伍地图并保持当前位置和缩放级别
在主地图上按下打开队伍地图键绑定时将保持当前位置和缩放级别

小地图与领土叠加层

默认位置略微上移
更改小地图的 Hide in Unmapped Areas 配置默认值，从 minimap 和 coordinates 改为仅 minimap
临时移除圆形地图遮罩类型
- 将尽快重新实现

叠加层

在叠加层管理屏幕上新增一个按钮来自定义渲染顺序
自定义所有叠加层的分层
自定义围绕原版 GUI 元素的分层

私人存储工具

银行页面名称和跳跃按钮现在使用 Wynncraft 语言字体

显示昵称

新配置 Keep Own Nickname，不会显示包含你名字的消息中的昵称，默认禁用

路径点管理界面

重新设计图标过滤系统，不再使用单独的屏幕
屏幕不再根据不同的 GUI 缩放比例调整到固定大小
添加一个新的路径点按钮进入路径点创建界面
添加平滑滚动

函数

战斗函数
- debuffs_in_radius_value 返回给定半径内指定负面效果的总值
  - radius 必需的双精度参数，检查负面效果的半径
  - debuffName 必需的字符串参数，要获取值的负面效果的名称
- targeted_mob_debuff_value 返回目标生物的指定负面效果的值
  - range 必需的双精度参数，检查目标生物的范围
  - horizontalDegrees 必需的双精度参数，水平视野角度
  - verticalDegrees 必需的双精度参数，垂直视野角度
  - debuffName 必需的字符串参数，要获取值的负面效果的名称

函数可用的负面效果类型包括：流血、失明、点燃、困惑、辐射、混乱、点燃、冰冻、被标记、中毒、挑衅、抗性、缓慢、戏法、虚弱、鞭打和风舞

修复

修复各种渲染问题
修复 NeoForge 上物品截图偏移的问题
修复与 VulkanMod 的崩溃问题
修复自定义玩家列表叠加层中条目提前被截断的问题
Wynntils 披风现在会在隐藏胸甲的情况下正确渲染
共享制作的物品上的负属性不再衰减
使用 Wayland 时尝试将物品截图复制到剪贴板时将优雅地处理错误

Wynntils (neoforge) v4.0.0

on 2026 Feb 14

下载

更新至Minecraft 1.21.11

（仅限Fabric）更新所需Fabric版本至0.18.4

（仅限NeoForge）更新所需NeoForge版本至21.11.23-beta

按各自功能类别分类按键绑定

所有地图界面

移除地图按钮背景中的空白空间
在右下角添加缩放按钮和滑块

自动应用资源包

如果不使用OpenGL（例如Vulkan），将不再生效

自动跳过过场动画

新配置“发送通知”，当过场动画被自动跳过或投票跳过时是否发送通知，默认启用

炸弹钟命令

无炸弹可用的消息现在使用聊天等级字体显示等级

聊天物品

更改默认的分享物品按键绑定为F5

坐标叠加

现在复制原版坐标
- 之前的叠加样式可以通过函数重新创建
默认位置移动到原版坐标的显示位置
“显示原始”配置现在默认禁用
移除颜色配置
“替换方向”配置，用Y坐标替换基本方向，默认禁用
“指南针样式”配置，更改叠加末端指南针的外观，静态始终指向前方，动态随相机旋转始终指向北方，无则移除指南针，默认静态
“指南针末端”配置，指南针应在叠加的哪一端，头部或尾部，默认尾部

自定义物品高亮

添加新的高亮纹理选项Wynn，并将其设为默认

增强的主播模式

在所有配置文件中默认禁用
所有配置仅在主播模式下激活
“隐藏快捷栏武器”配置，用字母代替快捷栏中的武器类型（魔杖 -> W，匕首 -> D等），默认禁用
“隐藏装备”配置，在查看物品栏时不渲染已装备的装备，默认禁用
“隐藏装备提示”配置，悬停在物品栏中的装备上时不会显示通常的提示，除非按住空格键，默认禁用

扩展物品计数

新配置“按住Ctrl显示等级”，允许禁用按住Ctrl时显示物品等级的功能，默认启用

指南

现在可以在网页物品指南中打开卷轴和符文
添加了增益指南
添加了符文指南
即使Wynncraft API过期，也可以更新物品纹理

公会地图界面

添加金库过滤按钮
添加切换到主地图并保持当前位置和缩放级别的按钮
在公会地图上按下打开地图按键绑定时，将保持当前位置和缩放级别

主地图界面

添加切换到公会地图并保持当前位置和缩放级别的按钮
在主地图上按下打开公会地图按键绑定时，将保持当前位置和缩放级别

小地图和领土叠加

将默认位置稍微向上移动
将小地图的“在未标记区域隐藏”配置的默认值从“小地图和坐标”改为“仅小地图”
暂时移除圆形地图遮罩类型
- 将尽快重新实现

叠加

在叠加管理屏幕上新增一个自定义渲染顺序的按钮
自定义所有叠加的层叠顺序
围绕原版GUI元素自定义层叠

个人存储工具

银行页面名称和跳转按钮现在使用Wynncraft语言字体

显示昵称

新配置“保留自己的昵称”，不会显示包含你名字的消息中的昵称，默认禁用

路标管理界面

重构图标过滤系统，不再使用单独的屏幕
屏幕不再根据不同的GUI比例缩放到固定大小
添加一个新的路标按钮，进入路标创建界面
添加平滑滚动

函数

战斗函数
- debuffs_in_radius_value 返回给定半径内指定负面效果的总值
  - radius 必需的双精度参数，检查负面效果的半径
  - debuffName 必需的字符串参数，要获取值的负面效果名称
- targeted_mob_debuff_value 返回目标生物的指定负面效果的值
  - range 必需的双精度参数，检查目标生物的范围
  - horizontalDegrees 必需的双精度参数，水平视野角度以检查目标生物
  - verticalDegrees 必需的双精度参数，垂直视野角度以检查目标生物
  - debuffName 必需的字符串参数，要获取值的负面效果名称

函数可用的负面效果类型包括：流血、失明、点燃、困惑、辐射、混乱、明燃、冻伤、被标记、中毒、挑衅、抵抗度、缓慢、戏法、虚弱、鞭打和风舞

修复

修复各种渲染问题
修复NeoForge上的物品截图偏移中心的问题
修复与VulkanMod的崩溃问题
修复自定义玩家列表叠加中的条目比预期提前截断的问题
Wynntils披风现在会在胸甲被Wynntils功能或隐藏闪光隐藏时正确渲染
共享制作的物品上的负属性不再衰减
使用Wayland时尝试将物品截图复制到剪贴板时，现在可以优雅地处理错误

Wynntils (neoforge) v3.4.5

on 2026 Feb 14

下载

下载屏幕

添加了下载源选项，默认为Wynntils CDN或GitHub，但也可以提供自定义源。默认使用Wynntils CDN
添加了可调整的超时时间，用于设置下载在超时前应运行的时间
添加了重新加载和清除缓存按钮

功能

字体功能
- to_background_text 添加了3种新的边缘样式："BOX"、"FLAG" 和 "RIBBON"

Wynntils (fabric) v3.4.5

on 2026 Feb 14

下载

下载屏幕

添加了下载源选项，默认为Wynntils CDN或GitHub，但也可以提供自定义源。默认使用Wynntils CDN
添加了可调节的超时时间，用于设置下载在超时前应运行的时间
添加了重新加载和清除缓存按钮

功能

字体功能
- to_background_text 添加了3种新的边缘样式："BOX"、"FLAG" 和 "RIBBON"