Fzzy Config

关于 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 将不再获得主动更新。

新增内容

• 新增 @RootConfig 注解，用于标记某个配置为“根”配置。该配置的设置项将直接显示在主界面配置按钮旁边，而不是在单独的子 GUI 中。配置交互的其他所有方面保持不变；包括加载、保存、调用等，因此现有配置可以标记为根配置而不会造成破坏。
• 新增一个灰色占位按钮，用于尚未加载但已在 fabric.mod.json 或 mods.toml 中声明的配置。
• 新增 ConfigApi.isScreenOpen / ConfigApiJava.isSceenOpen 方法，用于检查当前是否已打开配置 GUI。
• DynamicListWidget 新增 scrollToEntry 方法，用于直接滚动到列表中的某个条目。
• ConfigApi.openScreen 现在支持传入作用域参数，以便根据需要滚动到对应项并打开对应项。例如，如果你有一个配置 my_mod:config ，其中包含一个对象设置 coolObject ，将 my_mod.config.coolObject 传给 openScreen 将打开配置 GUI，滚动到该对象设置，并打开对象编辑弹窗。
• 新增 EntryOpener 接口，用于支持按需打开某些内容的条目。这通常用于带有弹窗编辑菜单的验证场景。

变更内容

• 网络 API 方法 registerLenient[side] 现在已移植到所有版本，以实现功能一致性。
• 如果某个配置在模组的界面初始化之后才被加载，管理器将被标记为失效并根据新的完整已加载配置集重建。
• ValidatedColor 弹窗现在为十六进制字符串文本框新增了提交按钮，且当颜色不支持透明度时，透明度编辑框将完全隐藏。

修复内容

• GUI 键绑定现在在弹窗打开后无法继续响应，且无法通过快捷键多次打开相同的弹窗。
• ConfigGroup 现在新增一个可选构造参数，用于让配置初始显示为折叠状态。
• 原料和颜色现在可以在经过验证的集合中作为键/值使用。
  • 原料现在无法在非世界环境中交互。
• 屏幕管理器现在在构建请求的界面时会锁定，防止在构建过程中意外调用打开相同界面导致递归构建。
• ValidatedColor 在不支持透明度时正确显示并仅接受 6 位十六进制值。
• ValidatedIdentifier 和 ValidatedTagKey 的弹窗再次在打开时聚焦到文本框，并且文本框对齐方式也已修复。
• 修复了在拖动“前往”菜单的滚动条时，若鼠标移出菜单区域滚动条消失的问题。当菜单未被悬停时滚动条消失是预期行为。
• 右键菜单现在能正确传递“穿过”它们的点击事件，允许在“点击菜单外区域”时执行操作（包括将菜单“移动”到新点击的位置）。