S-Lib
S-Lib 是一个实用工具和配置库。我的其他模组使用它来管理其配置和配置界面,因此单独安装时不会为游戏添加任何内容。如果你安装的模组将 S-Lib 列为依赖项,请将其放入你的 mods 文件夹中。
依赖项
- 仅限 Fabric:Fabric API
- 可选: YACL,用于游戏内配置界面。即使没有 YACL,所有功能仍然正常工作,但你需要手动编辑配置文件。
- 可选,仅限 Fabric: Mod Menu
版本支持
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.20 - 1.20.1 | Yes | Yes | |
| 1.20.2 - 1.20.4 | Yes | 仅 1.20.4 | |
| 1.20.5 - 1.20.6 | Yes | Yes | |
| 1.21 - 1.21.1 | Yes | Yes | |
| 1.21.2 - 1.21.4 | Yes | Yes | |
| 1.21.5 | Yes | Yes | |
| 1.21.6 - 1.21.8 | Yes | Yes | |
| 1.21.9 - 1.21.10 | Yes | Yes | |
| 1.21.11 | Yes | Yes | |
| 26.1 | Yes | Yes | |
| 26.2 | Yes | Yes | |
| 26.3 | Yes | Yes |
玩家指南
每个模组都会在其 config 文件夹中的 .json5 文件里保存设置。如果你在编辑时弄错了某个选项,只有该选项会恢复为默认值。旧文件会先被备份。
如果安装了 YACL(且模组支持此功能),点击配置按钮即可在游戏内打开设置界面。
在多人游戏中,由服务器管理的设置会在你加入时自动发送给你,并且除非服务器允许你修改(通常仅限管理员),否则这些设置会显示为灰色不可用状态。在局域网世界中,主机始终可以更改它们。在没有安装 S-Lib 的服务器上,这些设置将直接使用默认值。
模组开发者指南
- 配置基于注解的 POJO,支持范围限制、注释等功能
@Sync决定选项是仅本地保留还是同步到服务器
- 可通过一行代码注册配置,只需几行代码即可轻松构建完整的 YACL 界面
- YACL 控制器:支持颜色、枚举以及物品/标签下拉菜单
- 物品匹配器(支持 ID、标签、正则表达式,使用前缀
!表示排除)以及一些辅助工具
请参阅 GitHub README 获取完整文档,并查看 S-Lib Test Mod 获取实际代码示例。
S-Lib
S-Lib is a utility and config library. My other mods use it for their configs and config screens, so on its own it adds nothing to the game. If a mod you installed lists S-Lib as a dependency, drop it in your mods folder.
Dependencies
- Fabric only: Fabric API
- Optional: YACL for the in-game config screens. Without YACL everything still works, you will need to edit the config files manually.
- Optional, Fabric only: Mod Menu
Versions
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.20 - 1.20.1 | Yes | Yes | |
| 1.20.2 - 1.20.4 | Yes | 1.20.4 only | |
| 1.20.5 - 1.20.6 | Yes | Yes | |
| 1.21 - 1.21.1 | Yes | Yes | |
| 1.21.2 - 1.21.4 | Yes | Yes | |
| 1.21.5 | Yes | Yes | |
| 1.21.6 - 1.21.8 | Yes | Yes | |
| 1.21.9 - 1.21.10 | Yes | Yes | |
| 1.21.11 | Yes | Yes | |
| 26.1 | Yes | Yes | |
| 26.2 | Yes | Yes | |
| 26.3 | Yes | Yes |
For players
Each mod keeps its settings in a .json5 file in your config folder. If you mess up an option when editing, only that option goes back to its default. The old file gets backed up first.
With YACL installed (and if the mod supports it), the config button opens a settings screen in game.
In multiplayer, server-managed settings are automagically sent to you when you join, and they stay greyed out unless the server lets you change them (usually operators only). In a LAN world the host can always change them. On a server without S-Lib, those settings just use their defaults.
For mod developers
- Configs are annotation-based POJOs with support for range clamping, comments, and more
@Syncdecides whether an option is kept locally or synced to the server
- Configs can be registered with a one-liner, and an entire YACL screen can easily be built with a few more lines
- YACL controllers for colors, enum and items/tags dropdowns.
- An item matcher (ids, tags, regex,
!to exclude) and some smaller helpers
See the GitHub README for the full documentation, and the S-Lib Test Mod for real code examples.
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 S-Lib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增内容
- 为 API 添加了大量 Javadocs 文档
更改
YaclScreenBuilder.category(ConfigCategory)现已改为category(Supplier<ConfigCategory>)- 移除了
ConfigProvider.getSerializer(),因此同步配置可以使用自定义的ConfigProvider ItemOrTagControllerBuilder.create(Option)不再接受物品索引,且allowTags(boolean)启用了标签选择功能ColorUtils.toHex(TextColor)现在仅返回#RRGGBB格式
修复
已修复:
- 单人客户端和局域网主机未在其中一个值发生变化前发送
INFORM_SERVER值的问题 - 第二次调用
register()时静默重新加载配置的问题 modifyOptions接受了来自其他配置的选项的问题nested、includePrefix和configureOption中的拼写错误被忽略,以及非文本编辑选项上的dropdown仅在绘制时失败的问题- 缺少
String类型键的地图导致配置屏幕崩溃的问题 - 保存、撤销或服务器切换后,自定义类别保留旧屏幕监听器的问题
- 在 Forge 和 NeoForge 上于
RegisterKeyMappingsEvent之后注册的按键映射在无警告情况下丢失的问题 SLibConfigScreens.register仅在安装 YACL 时才拒绝未知模组 ID 的问题- 1.20.5+ 版本中武器伤害和速度忽略物品的默认修饰符及附魔修饰符的问题
API 破坏性更新
S-Lib 现在支持 Minecraft 1.20 至 26.3 版本的 Fabric、Forge 和 NeoForge!
- Modrinth 和 CurseForge 上的每个文件版本号为
<version>+<minecraft>-<loader>
破坏性变更
- 配置文件现通过
SLibConfig.synced(modId, Config.class)和SLibConfig.local(modId, Config.class)进行注册 - 配置管理器、其构建器、
OptionInfo和OptionTree已移至com.stalemated.lib.config - 实现类已移至
*.internal包,客户端专用代码已移至com.stalemated.lib.client,枚举和字符串下拉菜单已合并为SelectDropdownControllerBuilder - 同步数据包使用新通道,向客户端同步超过 256 KB 或向服务器同步超过 32 KB 的数据会被记录且不会发送
新功能
- 新的 YACL 屏幕构建器(
YaclScreenBuilder):autoGenerate()可生成整个配置,或自定义组、嵌套对象、列表和映射。编辑内容在玩家保存前保持在草稿状态 - 嵌套列表和映射具有“添加条目”和“移除条目”按钮
- 当服务器更改其值或玩家的权限时,或在局域网世界中其他玩家保存配置时,打开的配置屏幕会重新加载。重新加载时会保留当前选项卡、滚动位置和展开的组
- ID 字段仅接受有效的 ID,空 ID 不会被保存
SLibConfigScreens.register在所有加载器上添加配置按钮,若无 YACL 则不执行任何操作editListElement和addListElement在其各自的屏幕中编辑或创建单个列表元素SLibTesting.assertScreenBuilds在 JUnit 中检查配置屏幕是否构建成功,并验证其翻译是否存在- 新增注解:
@RangeLong,以及所有范围注解上的 YACL 滑块步长(step)@Title:在字段上方添加章节标题@ItemDropdown:在String和 ID 字段上显示物品下拉菜单@SharedDescription:为多个选项提供共享描述@EnabledIf:当布尔或枚举选项持有特定值时启用某个选项@Format:替换滑块文本@RequiresMod:仅在所需模组加载时才应用 mixin(配合ConditionalMixinPlugin)
- 当玩家 OP 状态发生变化时,同步配置会再次发送;在 26.2 及更高版本中,当局域网世界的房主更改命令访问权限时也会重新发送
- 配置屏幕、保存和同步仅处理发生更改的选项,物品下拉菜单会限制并缓存其匹配项
修复
已修复:
- 配置文件写入不完整或被覆盖且无备份的问题:保存过程现经过临时文件,先备份旧文件,并报告失败情况
- 无效值被静默替换为默认值的问题
- 接受 NaN、无穷大和溢出数字,且范围未对列表和映射内容进行钳制的问题
- 未读取
@SerializedName备用键,且未在@Nest类别上写入@Comment的问题 - 未广播服务器更改、局域网房主无法编辑服务器选项,以及在玩家连接时未发送
INFORM_SERVER值的问题 - 颜色控制器崩溃的问题,以及物品下拉菜单文本遮挡选项名称且光标位置偏离鼠标的问题
- “保存”、“取消”和“撤销”仅在发生更改的选项卡上更新的问题,以及弹出窗口打开时配置屏幕保持旧大小的问题
- Forge 1.20.1 的 mixin、属性数学运算、滚动文本、渐变和共享工具提示状态的问题
还有更多改进!
完整更新日志
3.0.1+1.21.1
修复
- 修复了在单人客户端中同时修改多个字段时,选项虽已保存至磁盘但未正确应用到内存的问题
- 修复了因
shadowBundle声明不正确导致的ResolutionException
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧