配置全面翻新

配置全面翻新

为懒惰的模组开发者而设计的强大配置库。

配置全面翻新预览查看大图

横幅

厌倦了仅仅为了添加一个配置开关而处理样板代码吗？Config Overhauled 是一个下一代、基于模式驱动的配置框架，旨在让模组开发重拾乐趣。

了解 Config Overhauled 如何消除配置管理、网络同步和 GUI 构建的繁重工作，让你专注于打造优秀的模组。

开发者工具

零样板代码的开发者工具

告别手动映射属性、编写冗长的 JSON 解析器以及连接臃肿的注册表。Config Overhauled 采用简洁的流式接口构建器，让你能够在一个连续、直观的链式调用中构建属性。

无论你需要一个简单的布尔值、一个带边界的双精度浮点数、一个RGB 颜色整数、一个字符串列表，还是直接引用物品和方块，该框架都提供了大量预定义类型供你使用。

为了进一步加快你的工作流程，该框架完全自动化了模组开发中繁琐的边缘工作：

  • 即时本地化：无需再寻找翻译键。在游戏中运行 /config_lang_gen <mod_id> 即可为你所有定义的类别、分组、属性甚至提示文本即时生成完整的语言文件模板。
  • 按需诊断：需要调试吗？使用 /config_dump <mod_id> 命令导出一份干净的当前配置状态 JSON 快照。

用户界面

自动生成、贴合原版的 GUI

构建配置界面是出了名的繁琐。所以我们将其自动化了。

Config Overhauled 读取你的属性链并动态生成美观、贴合原版风格的 GUI——你无需编写任何一行前端代码。

它开箱即用地提供了丰富、交互式的小部件。颜色属性会获得带有可视化颜色预览的专用十六进制输入框，带边界的数字会强制执行正则验证，而物品/方块配置则会生成美观且可搜索的注册表选择界面。它甚至支持实时展示数据包值，允许玩家直接通过界面操作复杂数据。

网络同步

真正的多人游戏和谐

一个漂亮的界面依赖于客户端和服务器对底层数据的完全一致。你可以依赖自动状态协调，而无需编写自定义网络数据包和手动同步程序。

Config Overhauled 静默地桥接主机与客户端：

  • 实时远程编辑：获得授权的服务器管理员可以直接从其本地客户端 GUI 编辑实时服务器配置。客户端会发送安全的更新请求，服务器修改状态，并无缝地向所有在线玩家广播同步信息。
  • 客户端状态保留：当玩家加入多人游戏服务器时，其本地个人配置会被安全存档，并替换为服务器的权威设置。当他们断开连接时，其自定义的本地设置会完美恢复。

系统配置

严格的系统作用域

为了有效管理这种自动化同步，一个健壮的库需要明确的规则。并非所有数据都是平等的。Config Overhauled 强制执行严格的执行边界，将每个属性归类为以下三种作用域之一：

  • 客户端(CLIENT)：针对视觉设置或客户端 UI 切换的独立本地执行。拒绝服务器覆盖。
  • 全局(GLOBAL)：适用于整个环境实例的通用行为。服务器接管控制权并将这些属性同步到所有连接的客户端。会话结束时，客户端状态将被恢复。
  • 存档(LEVEL)：严格绑定到当前存档的世界特定数据。服务器拥有全部权限，并严格同步这些属性到所有连接的客户端。

由于框架天生理解这些作用域，它会智能地路由数据。它知道客户端视觉开关与特定世界的动态数据包参数需要完全不同的网络处理方式。

致谢 本项目包含或依赖于第三方软件组件。

NightConfig

本项目捆绑了 NightConfig。根据 LGPL-3.0 的条款，完整的 GNU GPL 和 GNU LGPL 许可证文本随此软件一同分发。

MultiLoader-Template

用作跨平台构建环境的结构基础。