这是一次直接移植到 26.1 的版本

API 重命名

为适配未来非混淆版本的游戏，owo-lib 现已基于 Mojang 官方映射进行开发，相关 API 元素也已相应重命名。除了一些直接的适配（例如 World → Level），owo-ui 的核心类（此前名为 Component）也必须重命名为 UIComponent，以避免与 net.minecraft.network.chat.Component 发生命名冲突。相关类亦随之调整，例如 ParentComponent → ParentUIComponent、Containers → UIContainers。

语言扩展功能

除富文本翻译外，owo-lib 现在还支持嵌套式语言文件，可大幅减少语言键的重复定义。此外，为降低冲突风险，owo 的所有语言扩展功能现均为按需启用（opt-in）。请参阅文档中对应章节。

JSON5 支持

当 owo-lib 配置为实时读取并转换 JSON 文件时，数据包或资源包中的绝大多数 JSON 文件均可改用 JSON5 格式。详情请参阅文档说明。

braid UI 框架

由于突发技术原因（本人不愿将整个库重新映射两次），本版本包含即将推出的 braid UI 框架的早期预 Alpha 版本。该版本虽已通过较充分测试、功能层面也具备一定成熟度，但我们不认为其已达到发布标准，且对 API 稳定性不作任何保证。

若您仍希望尝试或随意探索该框架，请查阅入门指南。我们非常期待收到您的早期反馈！

修复并发问题导致使用 owo 网络的模组丢失数据包

修复：

• 修复 setTooltipForNextFrameInternal 缺少 AT 条目导致提示框丢失的问题

新增内容

• owo-ui 组件现在可以使用新的 inspectorDescriptor getter 来自定义在检查器激活时显示在其下方的文本
• ReadView 和 WriteView 新增了使用键控 Endecs 获取/设置其中值的方法

修复

• ModDataLoader 现在在使用分离源码的开发环境中可正常工作
• DropdownComponent 上的 surface setter 现在能正确返回下拉菜单

新增内容

• owo-ui 组件现在可以使用新的 inspectorDescriptor getter 来自定义在检查器激活时显示在组件下方的文本
• ReadView 和 WriteView 新增了使用键控 Endecs 获取/设置其中值的方法

修复内容

• ModDataLoader 现在在使用分离源码的开发环境中可正常工作
• DropdownComponent 上的 surface setter 现在能正确返回下拉菜单

修复

• 修复了点击带有空样式文本的标签时会导致崩溃的问题
• 修复了在具有复杂变换的绘制上下文中进行裁剪时错误截断内容的问题

变更内容

• 已移植到 1.21.9：在我们的有限测试中，大多数功能似乎运行良好，但无法保证完整的依赖库覆盖。如遇到任何问题，请及时报告
• 移除了 owo-ui 组件的 zIndex 属性——该属性自 1.21.6 起已失效

尝试解决客户端加载类和方法时导致崩溃的问题

变更内容

• 已移植至 1.21.9：在我们有限的测试中，大多数功能似乎运行良好，但无法保证完整的依赖库覆盖。如遇到任何问题，请及时报告
• 移除了 owo-ui 组件的 zIndex 属性——该属性自 1.21.6 起已失效

为 DataComponentMap 的简单映射添加 AT 条目以解决崩溃问题

修复由于未重新映射而导致的在目标处与 MergedComponentMapMixin 相关的问题

更改

• (破坏性) 将 OwoItemGroup.getBackgroundTexture 重命名为 getOwoBackgroundTexture，以避免在使用 Mojang 映射的环境中进行开发时出现命名冲突。

修复

• DerivedComponentMap 应与其他手动检查组件相等性的模组更好地配合使用。
• owo-ui 模糊不再偶尔闪烁。
• owo-ui 裁剪不再错误地停止渲染部分位于屏幕外的元素。这在滚动容器中最为明显，例如 owo 配置中使用的那个。

此版本主要是移植到 1.21.6/7。由于围绕 GUI 渲染的大量原生重构，这是一个比通常更大的更新，我们预计会有一些错误和移植错误 - 请报告您发现的任何问题！

更改

• OwoBlurRenderer已根据原生 GUI 渲染更改替换为 BlurQuadElementRenderState

已删除

• (Block|Entity|Item)RegistryContainer
• OwoItemSettings，已被 Item.Settings 上的接口注入替换
• DraggableContainer.alwaysOnTop
• CodecUtils.ofEndec，已被 toCodec 替换
• ConfigScreen.(registerProvider|getProvider|forEachProvider)，已被 ConfigScreenProviders 替换

修复：

• 使用 owo 模糊渲染器时出现闪烁的问题
• 导致非渲染 gui 元素的不正确裁剪行为，特别是在 owo 配置中的滚动容器中。
• DerivedComponentMap 相等性的正确修复
• 修复在 NBT 中读取和写入 Optional 时可能因使用 IdentityHolder 而丢失引用的问题

Neoforge

由于删除了 @OnlyIn 而导致的类持久化方式的更改可能会导致问题，但大部分已得到处理。

尝试修复与 DerivedComponentMap 相等性的问题，该问题解决了与其他模组（如 Pastel）的问题

更新尝试移除对 FFAPI 的依赖以解决问题，修复缺失的 owo 物品组，并从上游 1.21.1 拉取，以及修复可选序列化问题的问题

更新尝试移除对 FFAPI 的依赖以解决问题，修复缺失的 owo 项目组，并从上游 1.21.1 拉取

此版本主要是移植到 1.21.6/7。由于围绕 GUI 渲染的大规模原生重构，这是一个比通常更大的更新，我们预计会有一些错误和移植错误 - 请报告您发现的任何问题！

更改

• OwoBlurRenderer 已根据原生 GUI 渲染更改替换为 BlurQuadElementRenderState

移除

• (Block|Entity|Item)RegistryContainer
• OwoItemSettings，由 Item.Settings 上的接口注入替换
• DraggableContainer.alwaysOnTop
• CodecUtils.ofEndec，由 toCodec 替换
• ConfigScreen.(registerProvider|getProvider|forEachProvider)，由 ConfigScreenProviders 替换

Neoforge的owolib 0.12.21初始移植版本

修复内容

• 模糊管线现在使用自定义顶点光影以避免随机雾代码依赖
• Owo模糊渲染器现在在其渲染过程中使用深度缓冲来修复某些驱动程序上的模糊渲染问题
• owo不再意外覆盖原版的gui_textured渲染管线