安装与环境
运行要求
| 项目 | 要求 |
|---|---|
| 服务端 | Luminol、Folia 或 Paper 26.2 |
| Java | 25 |
| 插件 | cubeball-1.1.2.jar |
| 已记录运行核心 | Luminol 26.2 build 726 |
| 构建 API | me.earthme.luminol:luminol-api:26.2.build.726-stable |
folia-supported: true 只允许插件加载，不能单独证明线程安全。其他核心、其他 build 或 API 更新后都要重新验证。
安装步骤
- 使用 Java 25 启动目标 26.2 服务端。
- 关闭服务器，将
cubeball-1.1.2.jar放入plugins/。 - 按需安装 CraftEngine、Residence、
emotecraft或 BodySize；它们都是软依赖。 - 启动服务器，确认插件数据目录、
config.yml和语言文件已生成。 - 执行
/ccb help，确认命令注册和管理员权限。 - 执行
/ccb打开管理中心。
不要在服务器运行中直接覆盖 JAR。升级前备份插件数据目录，尤其是 config.yml、matches 场地数据和 inv_backup/ 玩家备份。
首次健康检查
- 控制台没有 Java 版本、API 或主类加载错误。
/ccb help能列出命令。/ccb能打开管理中心。plugins/<数据目录>/config.yml可读且 YAML 缩进正常。- 安装软依赖时，控制台显示对应联动被发现；缺失软依赖不应阻止核心插件加载。
构建
项目使用 Maven 3.9+ 与 Java 25：
mvn -B clean package
产物：
target/cubeball-1.1.2.jar
安装成功后继续快速建场。