Lattice

插件

· 作者 Hydr46605

基于 Java 21 的结构化 Paper/Folia 插件开发共享运行时和框架。

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

最新 0.8.9 · 1.21.11 · Paper

一键开服(送7天)

Lattice

Lattice

一个用于在 Java 21 上构建结构化、感知 Folia 的 Paper 插件的开发框架。

Lattice 标准化了生命周期、模块、服务、配置、命令、文本、任务、UI、存储、诊断以及可选集成,使 Minecraft 插件能够保持精简、显式且具备生产就绪状态。


什么是 Lattice?

Lattice 是 BerylStudios 和 BerylLabs Minecraft 插件的共同基础。它不是一个玩法插件,本身不会添加命令、世界、机制或面向玩家的功能。

插件作者使用 Lattice 来构建具有统一运行时形态的 Paper/Folia 插件:包括显式的模块、可预测的生命周期阶段、类型化的服务、经过验证的配置、感知 Folia 的任务路由、存储辅助工具以及在生产环境中出现问题时很有用的诊断功能。


部署模型

自 0.8.0 版本起,推荐的部署模型是独立共享运行时:

模式 适用场景 运行时行为
独立共享运行时 可以依赖服务器上已安装 Lattice 的新 Paper/Folia 插件 服务器只需安装一次 Lattice 插件。依赖插件在不进行重定位的情况下针对 Lattice 进行编译,并通过明确的 Paper 依赖加入 Lattice 类路径。
传统隔离库模式 需要自包含插件 jar 包或仍需阴影处理(shading)的兼容路径 每个依赖插件都拥有自己的 Lattice 运行时、模块图、服务注册表、任务跟踪、存储句柄和诊断接口。

独立运行时是新开发的首选路径,因为它避免了在同一服务器的每个依赖插件中重复构建共享基础设施。


提供的内容

领域 内置支持
生命周期 加载、启用、就绪、禁用、启动报告以及失败回滚
模块 具有依赖排序和循环检测功能的显式功能模块
服务 无需重度反射依赖注入的类型化服务注册表
配置 Configurate YAML、默认值、验证、架构版本、迁移以及可选的 Junction 变量渲染
命令 后端无关的命令树,配合 Paper 注册
文本 Adventure 组件、MiniMessage 以及遗留输入边界
任务 感知 Folia 的异步、全局、区域和实体调度
UI 库存菜单、书籍、铁砧输入和虚拟告示牌输入
存储 SQLite、MySQL、MariaDB、PostgreSQL、HikariCP、迁移、JDBC 辅助工具,以及在独立模式下的共享连接池管理
诊断 针对生命周期、模块、服务、命令、任务、UI、存储和集成的运行时快照
集成 PlaceholderAPI、PacketEvents、Junction、Nexo、Oraxen、ItemsAdder 和 CraftEngine

模块

Lattice 分为三个 Maven 工件:

工件 用途
io.github.hydr46605:lattice-api 最小的 API 状态标记和首个共享运行时契约边界。
io.github.hydr46605:lattice-core 平台中立的契约和位于 dev.beryl.lattice 下的基础实现。
io.github.hydr46605:lattice-paper Paper/Folia 引导程序、调度器、命令、UI、诊断、存储、钩子、集成以及独立主机适配器。

lattice-core 故意不包含任何 Bukkit、Paper 或 Folia 类。服务器特定行为属于 lattice-paper,从而保持核心 API 可测试且对插件作者稳定。


兼容性

  • Java 21
  • 现代 Paper 1.21.x,当前目标版本为 1.21.11
  • 通过显式任务上下文实现感知 Folia 的调度
  • 以 Adventure 组件和 MiniMessage 作为主要文本格式
  • 在框架针对真实插件集成加固之前,处于 1.0 之前的 API 状态

当前状态

Lattice 处于 0.x 测试版阶段。虽然存在稳定的开发路径,但在 1.0 发布之前仍可能发生破坏性更改。

当前的重点是共享运行时架构:一个已安装的 Lattice 主机、干净地注册到该主机的依赖插件、共享 JDBC 连接池管理、更清晰的诊断功能,以及面向长期插件开发的更小公共 API 表面。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源