S-Lib

S-Lib

S-Lib 是一个用于 Minecraft 模组开发的轻量级实用工具与配置前置库。

示例模组： 查看 S-Lib 测试模组 仓库，获取完整的配置用法示例以及使用 YACL 生成 GUI 的示例。

特性

注解驱动的配置

• 使用 SLibConfig.syncedBuilder() 或 SLibConfig.localBuilder()，只需一行代码即可注册同步或本地配置。
• 网络 @Sync 选项：
• OVERRIDE_CLIENT：服务端权威配置，同步到客户端。配置在登录时广播并实时更新。支持可配置的权限检查（例如仅限 OP）。
• INFORM_SERVER：本地配置，将更改通知服务端
• NONE：本地配置，不同步网络
• 使用 @RangeInt、@RangeFloat 和 @RangeDouble 注解时，新增字段会自动填充默认值，过时的键会被移除，数值会被限制在指定范围内。
• 在配置类的字段上方使用 @Comment 注解即可插入注释。
• 如果检测到文件损坏或语法无效，会自动创建备份，在你意外出错时保留损坏的配置文件。
• 使用 @Nest 注解可支持嵌套类，以构建更复杂的配置结构。
• 使用 @Ignore 注解可完全忽略某个字段。
• 内置类型适配器，兼容 AWT 的 Color、Minecraft 的 TextColor、Identifier、Pattern 和 UUID 类的序列化。

自定义 YACL 控制器

为 YACL 提供的自定义控制器：

• 高级颜色控制器： 支持十六进制代码（#RRGGBBAA）、Minecraft 颜色名称以及旧版格式化代码（&a、&3）。
• 物品或标签控制器： 自动补全下拉框，可匹配精确物品、标签（#c:swords）、命名空间（minecraft:*）和正则表达式。
• 简单下拉框： 用于枚举和字符串的下拉选择器。

通用工具

• 目标匹配引擎： 通过精确 ID、标签、命名空间、通配符（*）和正则表达式（regex:.*_sword）进行物品匹配。
• 平台辅助工具： 对加载器特定方法的抽象，既可作为通用工具（PlatformHelper），也可用于网络相关功能（NetworkHelper）。
• 数学与颜色工具： 缓动函数（lerp、ease-out、clamp）、文本渐变生成器、颜色工具等。