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 的弹窗现在在打开时会再次聚焦到文本框，并且文本框对齐已修复。
• 修复了在拖动“前往”菜单的滚动条并移出菜单时滚动条消失的问题。菜单未被悬停时滚动条消失是预期行为。
• 右键菜单现在可以正确传递“穿过”它们的点击事件，允许在“点击菜单外部”时执行操作（包括将菜单“移动”到新点击的位置）。