Simple Config Lib

模组

· 作者 BizCub

轻松管理模组设置,自动生成配置界面

0 本站下载 0 关注 更新于 1 个月前

最新 2.1-fabric+26.4-snapshot-1 · Fabric / Quilt

一键开服(送7天)

banner.png

Simple Config Lib

Simple Config Lib 是专为 Minecraft 模组设计的配置库,用于处理设置项。它允许开发者通过普通的 Java 类来描述配置,随后该库会自动构建游戏内的设置界面,并负责数据的保存与加载。

本项目的主要目标是让开发者从繁琐的设置系统实现中解放出来,并在所有支持的平台间提供统一且可预期的结果。

该库支持 Fabric、Forge 和 NeoForge 加载器。

详细文档请参阅 Wiki:Simple Config Lib Wiki

Test configuration screen


用途

该库提供了一种统一的模组设置处理方式,涵盖配置描述、存储和显示。

Simple Config Lib 采用单一方法解决此任务:

  • 配置仅作为一个类进行描述;
  • 设置界面自动生成;
  • 数据无需额外代码即可保存和加载;
  • 在 Fabric、Forge 和 NeoForge 上的行为保持一致。

这种方法使开发者能够专注于模组的功能性,而非其设置背后的基础设施。


适用对象

  • 模组开发者 — 旨在帮助那些希望为用户提供便捷设置界面,而不愿花费时间自行实现界面和文件处理的开发者。
  • 玩家 — 该库作为依赖项存在,通常因其他模组需要而安装。它无需单独配置,只需确保其他模组的使用正常即可。

特性

  • 在类级别描述配置,并自动生成设置界面。
  • 提供现成的设置界面,只需在描述配置后调用一次即可获取——由库负责构建界面。
  • 自动保存和加载数值,无需手动处理文件。
  • 在所有支持的加载器上行为一致。
  • 基于配置结构实现自动本地化。
  • 丰富的界面元素集合,用于表示各种数据类型。
  • 一组客户端辅助工具,简化屏幕创建过程。与配置本身一样,这些工具可独立于游戏版本使用。
  • 跨网络同步的服务器端配置:标记为服务器端的配置存储在服务器上,在玩家加入时发送给每位玩家,并对客户端只读显示(除非拥有操作员权限)。
  • 独立于加载器和版本的网络层:将数据包描述为普通的 Java record 并注册一次——库会构建编解码器,在所有加载器上注册它,并处理双向发送。

安装

在 Fabric 加载器上,需额外安装 Fabric API 才能使该库正常工作。在 Forge 和 NeoForge 上,无需其他依赖项。


常见问题

玩家需要安装该库吗? 仅在另一个模组需要时才需要。Simple Config Lib 是一个依赖项,无需单独配置——它只是让使用该库的模组的设置正常工作。

可以将该库添加到整合包中吗? 可以。只要提供其原始页面的链接,该库就可以包含在整合包中。

该库与其他模组冲突吗? 不会。Simple Config Lib 不会干扰其他模组,也不会与之冲突。

我需要为不同的版本和加载器编写不同的代码吗? 不需要。配置和辅助工具均设计为独立于游戏版本和加载器使用——同一套代码可在任何地方运行。

我在哪里报告 bug 和建议? 可以在 GitHub 上报告 bug 和建议。


项目状态

Simple Config Lib 最初是为我的个人项目创建的。由于许多现有库停止在新版 Minecraft 中对 Forge 提供支持,我不得不接手该项目。

该项目处于开放状态并持续发展:功能集将不断扩展,发现的任何 bug 都将得到修复。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源