Fzzy Config

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为已弃用且计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了对 PopupController 的已弃用重写
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增了 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增了 uk_ua 翻译

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增了三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗的大小调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了可翻译对象的对象（例如 ValidatedAny ）进行翻译提取
• 提高了配置数据包的大小限制，避免因序列化大型配置而出现问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建器方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的麻烦。后续版本将持续加入与 CustomWidget 相关的更新。
• 新增基于上述接口的 CustomTextWidget 。
• 为 NetworkApi 添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增乌克兰语（uk_ua）翻译

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，使得在延迟注册的加载器中可以正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了可翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 增加配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅在错误上下文包含头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被 Translatable.ResultProvider 替代。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移时的麻烦。后续版本将持续加入与 CustomWidget 相关的更新。
• 新增基于上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步至客户端。
• 新增乌克兰语（uk_ua）翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内部包装的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复

• 验证集合（Validated Collections）现在会在序列化时惰性解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包裹翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 增加了配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅在错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的困难。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 增加了配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步引入。
• 新增基于上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译（乌克兰语）

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册物品、方块等映射注册对象的加载器中正确实现。
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault 设置
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 增加了配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来移植的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的对象（例如 ValidatedAny ）进行翻译提取
• 增加配置数据包的大小限制，避免序列化大型配置时出现问题
• （1.21.9）修复了按键绑定显示为“Button 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为已弃用且计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 移除了 ActiveButtonWidget
  • 移除了 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 从 internal 子包中移出
  • 移除了 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增了 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来移植的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增了使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增了 uk_ua 翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增了三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗的大小调整

修复

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的对象（例如 ValidatedAny ）进行翻译
• 增加了配置数据包的大小限制，避免因序列化大型配置而导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal 访问级别
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent 。

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的困难。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译（乌克兰语）

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault 设置
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的对象（例如 ValidatedAny ）进行翻译提取
• 增加配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“Button 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为已弃用且计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来移植的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望的尺寸参与弹窗的大小调整

修复

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的对象（例如 ValidatedAny ）进行处理
• 增加配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的麻烦。后续版本将持续加入与 CustomWidget 相关的更新。
• 新增基于上述接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增乌克兰语（uk_ua）翻译

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册物品、方块等映射注册对象的加载器中正确实现。
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault 设置
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了可翻译对象的外层对象（例如 ValidatedAny ）进行处理
• 提高了配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时报错

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方式
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的困难。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增使用上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译

变更

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小的调整

修复

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 增加配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建方式用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal 访问级别
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur 已移除
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移时的工作量。后续版本将持续加入与 CustomWidget 相关的更新。
• 新增基于上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增乌克兰语（uk_ua）翻译

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内嵌的 LayoutWidget 现在会根据其期望尺寸参与弹窗的大小调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册物品、方块等映射注册对象的加载器中正确实现。
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault 设置
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了可翻译对象的外层对象（例如 ValidatedAny ）进行翻译提取
• 提高了配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“Button 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文仅有头部信息时才报告错误

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 移除了所有标记为 @Deprecated 并计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须重写
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> 及其构建器现为添加自定义按钮的唯一非重写方法
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• 新增 CustomWidget 接口。该接口将用于抽象化所有 FC 小部件，使其不再直接与 Element 、 Widget 等交互，以减少未来版本迁移的麻烦。与 CustomWidget 相关的更新将在后续版本中逐步推出。
• 新增基于上述 CustomWidget 接口的 CustomTextWidget 。
• 在 NetworkApi 中添加了 syncConfig 方法，用于手动将服务器端配置同步到客户端。
• 新增 uk_ua 翻译支持

变更内容

• CustomMultilineTextWidget 现在支持右对齐方法
• Relevant 新增三个用于修饰键检查的方法： needsCtrl 、 needsShift 、 needsAlt
• PopupWidget 内部包装的 LayoutWidget 现在会根据其期望尺寸参与弹窗大小调整

修复内容

• 验证集合（Validated Collections）现在在序列化时延迟解析其内容，从而允许在延迟注册的加载器中正确实现映射的注册对象（如物品、方块等）
• ConfigGroup 现在能正确处理嵌套的 collapsedByDefault 属性
• ConfigApi.buildTranslations 现在可以“穿透”可能包装了翻译对象的对象（例如 ValidatedAny ）进行翻译提取
• 增加配置数据包的大小限制，避免因序列化大型配置导致的问题
• （1.21.9）修复了按键绑定显示为“按钮 70”等问题
• ValidationResult.reportTo 不再仅当错误上下文包含头部信息时才报告错误

注意：当 Kotlin For Forge 更新至 1.21.9 后，Neoforge 版本将会发布

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已被移除
• 移除了所有标记为“已弃用”且计划在 0.7.0 中删除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须作为强制重写项
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建器方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类改为 internal 访问级别
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响了 EntrySearcher 和 Searcher.SearchContent

新增功能

• ValidatedColor 新增了预设功能。这些预设将在主颜色弹窗的右侧以“子面板”形式显示。
  • 提供了基于 Minecraft 颜色枚举的预定义预设，也可通过 ValidatedColor#withColorPresets 自定义预设
• 新增 ValidatedNumber#setFormat 扩展函数，允许为数值设置自定义的 DecimalFormat
• PopupWidget 现在可以拥有“子级”布局，作为子面板显示在主弹窗的右侧或下方。
  • 在构建器中使用一对 pushChildLayout 和 popChildLayout 创建子布局。
  • 该子布局可具有完全独立的间距、内边距等样式设置。
  • 添加到此子布局的所有元素将与主弹窗一同支持导航操作。

变更

• 标记为 SaveType.SEPARATE 的配置现在可以在世界外打开（只要其条目支持），不再进行权限检查，因为客户端版本会被单独处理
• 弃用了 LayoutWidget 的构造函数，转而推荐使用构建器模式。请尽快迁移任何自定义的 LayoutWidget 实现；计划在 0.8.0 版本中彻底移除

修复

• (1.21.6+) “更改”组件现在能正确显示更改数量
• (1.21.6+) 弹窗再次正确模糊底层屏幕内容
• 修复了 ValidatedCondition 未将其控件大小变化传递给代理控件的问题

依赖已临时更改为 KotlinLangForge。如果 KFF 得到更新，我计划切换回去。或者也许我会自己打包 Kotlin 库，我已经受够了 Forge 的 Kotlin 库。

0.7.x 版本中的破坏性变更

• ValidatedEnumMap 已移除
• 删除了所有标记为“已弃用”并计划在 0.7.0 移除的方法和属性
  • SmallSpriteDecoration#<init>
  • SpriteDecorated#textureSet 和 textures 现在必须作为强制重写项
  • SpriteDecoration#<init>
  • CustomButtonWidget#<init> ，现在仅保留非重写的构建器方法用于添加自定义按钮
  • 已移除 ActiveButtonWidget
  • 已移除 TextlessActionWidget
  • DynamicListWidget.EntryPos 及其实现类被设为 internal
  • PopupWidget 的位置元素； LayoutWidget 不再继承自 PopupWidget 的变体
  • 从 PopupParentElement 中移除了已弃用的 PopupController 重写方法
  • SuggestionWindowListener 和 SuggestionWindowProvider 已从 internal 子包中移出
  • 已移除 ImmutableRelPos
  • RenderUtil#renderBlur
• 在整个 FzzyConfig 中， Translatable.Result 已被替换为 Translatable.ResultProvider 。这也影响到了 EntrySearcher 和 Searcher.SearchContent

新增功能

• ValidatedColor 新增了预设功能。这些预设将在主颜色弹窗右侧以“子面板”的形式显示。
  • 提供了基于 MC 颜色枚举的预定义预设，也可通过 ValidatedColor#withColorPresets 自定义预设
• 新增 ValidatedNumber#setFormat 扩展函数，允许为数字设置项定义自定义的 DecimalFormat
• PopupWidgets 现在可以拥有“子”布局，作为子面板显示在主弹窗的右侧或下方。
  • 使用构建器中的 pushChildLayout 和 popChildLayout 成对调用来创建子布局。
  • 该子布局可具有完全不同的间距、内边距等样式设置。
  • 添加到此子布局的所有元素将与主弹窗一同支持导航操作。

变更

• 标记为 SaveType.SEPARATE 的配置现在可以在世界外打开（只要其条目支持），且无需进行权限检查，因为客户端版本将被独立处理
• 已弃用 LayoutWidget 的构造函数，推荐改用构建器模式。请尽快迁移任何自定义的 LayoutWidget 实现；计划在 0.8.0 版本中移除

修复

• (1.21.6+) “更改”组件现在能正确显示更改数量
• (1.21.6+) 弹窗再次正确模糊底层屏幕内容
• 修复了 ValidatedCondition 未将其委托控件的尺寸变化传递给子控件的问题

关于 0.6.x 中重大变更的提醒

• ValidatedEntityAttribute 已被移除
• Custom[Widgets] 已从内部 widget 包移动到 custom 包中
• 多个 widget 和其他类已被删除
• PopupWidget 有许多已弃用的功能，尽管我已尽最大努力，但可能至少有一个重大变更。这些弃用功能计划在 0.7.0 中移除
• 自 0.6.3 起， ActiveButtonWidget 已不再使用并被弃用，标记为将在 0.7.0 中移除
• 自 0.6.3 起， TextlessActionWidget 已不再使用并被弃用，标记为将在 0.7.0 中移除
• 可能还有更多变更，我没有做详细的记录

自 0.6.0 起，1.20.4 和 1.20.6 将不再接收主动更新。

新增内容

• 更新支持 1.21.5
• 搜索现在会传播到子菜单和其他“子项”结果中，即使这些子项本身无效但包含有效的子条目，也会显示虚线轮廓，并且工具提示将列出有效的子条目
  • 搜索现在可以自动传递到子菜单。默认情况下，按住 Alt 并点击将传递搜索
  • 主搜索栏现在有一些按钮！一个菜单按钮用于打开新的搜索配置菜单，还有一个清除按钮可以快速清空搜索栏。
• 在 Config 中新增了 SaveType 方法
  • OVERWRITE - 当从服务器接收同步时，客户端配置将被覆盖。这是默认行为和之前的行为
  • SEPARATE - 当从服务器更新配置时，客户端配置将不会本地保存。对于在同步前修改游戏状态的操作，不能包含在这些配置类型中（ Action.RESTART 和 Action.RELOG ），因为如果它们无法覆盖本地文件，则无法正确同步这些游戏状态。
• 新增 Translatable.ResultProvider 超类，用于更细致和高效的翻译结果存储。目前在 0.7.0 之前为半集成状态。
  • 基于作用域的 Result 可以使用新的 Translatable.createScopedResult 进行缓存
• 新增了用于始终返回相同值的 Supplier、Function 和 Predicate 的新函数工具

变更内容

• Translatable.Result 现在直接实现 Searcher.SearchContent ，并已弃用，推荐使用新的 ResultProvider
  • 在 0.7.0 中，所有 Result 构造函数将改为内部使用，推荐使用 Translatable.createResult / Translatable.createScopedResult
• ConfigEntry 现在可以使用 ContentBuilder.searchResult 方法处理搜索。当父列表被搜索时，会显示有效的“子项”搜索结果
• ValidatedAny 现在拥有自己的搜索栏
• ConfigScreenManager 会将 Config 和条目 Content 的其他上下文传递给条目创建者

修复内容

• 修复了单人游戏配置中不必要的重复保存配置问题
• 修复了涉及搜索的各种边界情况和小众问题
• 使用 @Translation （或整个类标记为 @Translation ）翻译的设置弹窗现在将在弹窗标题中正确显示翻译后的名称
• 搜索过滤现在在返回屏幕时能正确重置。搜索栏菜单有一个设置选项，可以启用缓存行为，使屏幕从子菜单重新打开时保留搜索内容
• 修复了涉及 Kotlin 构造函数的 ConfigGroup 的意外小众 API 破坏问题

关于 0.6.x 中破坏性变更的提醒

• ValidatedEntityAttribute 已被移除
• Custom[Widgets] 已从内部 widget 包移动到 custom 包中
• 多个 widget 和其他类已被删除
• PopupWidget 有许多已弃用的功能，尽管我已尽力避免，但仍可能至少包含一处破坏性变更。弃用功能计划在 0.7.0 中移除
• 自 0.6.3 起， ActiveButtonWidget 已无使用且被弃用，计划在 0.7.0 中移除
• 自 0.6.3 起， TextlessActionWidget 已无使用且被弃用，计划在 0.7.0 中移除
• 可能还有更多变更，但我没有详细记录

从 0.6.0 开始，1.20.4 和 1.20.6 将不再获得主动更新。

新增功能

• 配置现在支持除 TOML 外的多种保存文件格式。目前支持的格式包括 TOML 、 JSON 、 JSON5 、 JSONC 。通过在配置类中重写 fileType 来选择所需格式。
  • JSON5 和 JSONC 格式将自动保留使用 @Comment 或 @TomlComment 添加的注释

变更

• 将 PopupController 从 PopupParentElement 中分离出来，使得弹窗在现有界面中的实现更加顺畅。

修复

• 修复了单人游戏配置中不必要的重复保存问题。

关于 0.6.x 中重大变更的提醒

• ValidatedEntityAttribute 已被移除
• Custom[Widgets] 已从内部 widget 包移动到 custom 包中
• 多个 widget 和其他类已被删除
• PopupWidget 存在大量弃用内容，尽管我已尽力避免，仍可能至少存在一处重大变更。这些弃用项计划在 0.7.0 中移除
• 自 0.6.3 起， ActiveButtonWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 自 0.6.3 起， TextlessActionWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 可能还有更多变更，但我的记录并不完整

自 0.6.0 起，1.20.4 和 1.20.6 将不再获得主动更新。

新增功能

• 配置现在支持除 TOML 外的多种保存文件格式。当前支持的格式包括 TOML 、 JSON 、 JSON5 、 JSONC 。通过在配置类中重写 fileType 来选择所需格式。
  • JSON5 和 JSONC 可以自动保留使用 @Comment 或 @TomlComment 添加的注释

变更内容

• 将 PopupController 从 PopupParentElement 中分离，使得在现有界面中实现弹窗更加流畅

修复内容

• 修复了单人游戏配置中不必要的重复保存问题

关于 0.6.x 中重大变更的提醒

• ValidatedEntityAttribute 已被移除
• Custom[Widgets] 已从内部 widget 包移动到 custom 包中
• 多个 widget 和其他类已被删除
• PopupWidget 有许多已弃用的功能，尽管我已尽力避免，但仍可能至少存在一处重大变更。这些弃用功能计划在 0.7.0 中移除
• 自 0.6.3 起， ActiveButtonWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 自 0.6.3 起， TextlessActionWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 可能还有更多变更，但我没有做详细的记录

从 0.6.0 开始，1.20.4 和 1.20.6 版本将不再获得主动更新。

新增功能

• 配置现在支持除 TOML 以外的其他保存文件格式。目前支持的格式包括 TOML 、 JSON 、 JSON5 、 JSONC 。通过在配置类中重写 fileType 来选择所需的格式。
  • JSON5 和 JSONC 将自动保留使用 @Comment 或 @TomlComment 添加的注释

变更内容

• 将 PopupController 从 PopupParentElement 中分离出来，使得弹出窗口在现有界面中的实现更加顺畅。

修复内容

• 修复了单人游戏配置中不必要的重复保存配置问题。

关于 0.6.x 中破坏性变更的提醒

• ValidatedEntityAttribute 已被移除
• Custom[Widgets] 已从内部 widget 包移动到 custom 包
• 多个 widget 和其他类已被删除
• PopupWidget 有许多已弃用的内容，尽管我已尽最大努力，仍可能至少存在一个破坏性变更。这些弃用内容计划在 0.7.0 中移除
• 自 0.6.3 起， ActiveButtonWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 自 0.6.3 起， TextlessActionWidget 已无使用并被弃用，计划在 0.7.0 中移除
• 可能还有更多，我没有做详细的记录

自 0.6.0 起，1.20.4 和 1.20.6 将不再接收主动更新。

新增内容

• 配置现在支持除 TOML 外的其他保存文件格式。当前支持的格式包括 TOML 、 JSON 、 JSON5 、 JSONC 。通过在配置类中重写 fileType 来选择你想要的格式。
  • JSON5 和 JSONC 会自动保留使用 @Comment 或 @TomlComment 添加的注释

变更内容

• 将 PopupController 从 PopupParentElement 中分离出来，使得弹窗在现有界面中的实现更加顺畅。

修复内容

• 修复了单人游戏配置中不必要的重复保存配置问题。