SLib

SLib

Slib是一个为Forge 1.20.1模组开发的闭源基础库。它统一了高级网络机制和安全防护措施,确保所有依赖模组的完全稳定性,无需频繁进行维护更新。

基础库

Slib 在 Modrinth 上作为必要依赖项发布。它本身不包含任何游戏内容——它是作者其他模组底层的架构引擎。其主要目的是彻底消除性能卡顿、优化网络性能,并让所有关联模组同时在单一高效运行时下运行。

此模组是一个闭源库。不建议其他模组开发者使用。不提供源代码。公开的 Java API 仅用于让作者自己的模组共享统一引擎,而非供第三方模组在其基础上构建。没有支持渠道、文档网站,不对外部用户承诺 API 稳定性,也没有开放仓库。

终端用户:仅当作者某个模组需要 Slib 时才安装它。你永远不会单独与 Slib 交互。

模组作者:不要依赖此库中的任何包。包布局、类名、数据包 ID、网络协议和配置键可能会在任何小版本中不经通知而更改。

主要特性

  • 性能与同步优化:专门设计用于防止服务端卡顿、冻结帧和开销,通过强制作者所有关联模组同时共享统一、精简的内部系统。
  • 网络封装:内置每个模组的分配器、速率限制、游戏时间冷却保护、距离检查、发送方/方向验证,以及为所有玩家一次性序列化的单个广播管道。
  • 快照保护:严格的 NBT 和 JSON 大小限制、结构深度限制、NaN/Inf 值拒绝、畸形检测以及针对恶意数据包的零分配清理。
  • 严格的 API 隔离:通过每次构建时的自定义 Gradle 任务完全强制实施,防止外部泄露。
  • 数值清理器:用于有限、正数、限幅和角度归一化值的内部辅助工具。

配置

Slib 不提供配置界面。它是一个库,而非面向用户的模组。所有配置均不可变,直接编译到 jar 中,并在内部作为常量公开。