VertexCore

插件

· 作者 Tebrox

为 Paper 服务器提供的轻量级核心插件,为插件开发者提供配置、数据库和命令基础设施。

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

最新 1.1.1 · 26.2 · Paper

一键开服(送7天)

VertexCore Banner

VertexCore

VertexCore 是一个 仅适用于 Paper 的核心插件,旨在为插件开发者提供共享的基础架构。

它提供了用于配置处理、数据库访问和命令执行的复用基础设施,减少了跨多个插件的重复样板代码。

VertexCore 不是一个游戏性插件。
它被设计为其他插件的依赖项使用。


功能特性

配置系统

  • 基于注解的配置定义
  • 自动生成和加载配置文件
  • 验证、默认值和注释支持
  • 配置对象直接映射到 Java 类

数据库系统

  • 统一的数据库抽象层
  • 支持的后端:
    • JSON(平面文件)
    • H2
    • MySQL / MariaDB
  • 异步和同步访问
  • 内置迁移支持
  • 通过配置驱动数据库设置

命令系统

  • 集中的命令执行框架
  • 支持根命令和子命令
  • 参数注入和解析器
  • 权限和可见性处理
  • Tab 补全支持

要求与兼容性

VertexCore 1.1.x 构建为 Java 21 字节码,并针对 Paper 1.21.4 API 进行编译。

已验证的运行时兼容性:

Paper Java 状态
1.21.4 21 已验证
26.2 25 已验证

相同的 VertexCore JAR 文件用于两者的运行时检查。

  • VertexCore 所需的最低 Java 版本: Java 21
  • 最低支持的 Paper 基线: Paper 1.21.4
  • 较新的 Paper 版本可能需要更新的 Java 运行时,这与 VertexCore 无关。例如,已验证的 Paper 26.2 运行时使用 Java 25。
  • VertexCore 1.x 保持兼容性导向;公共 API 兼容性在可能的情况下得到保留。

该兼容性矩阵通过 GitHub Actions 使用可重现的运行时冒烟测试在两个受支持的端点上执行。


安装

  1. 下载最新版本
  2. 将 VertexCore.jar 放入服务器的 plugins 文件夹中
  3. 重启服务器

使用 VertexCore 的插件必须将其声明为依赖项。


开发者用法

VertexCore 通过 jitpack.io 分发。

Gradle

repositories {
    mavenCentral()
    maven { url "https://jitpack.io" }
}

dependencies {
    compileOnly("com.github.Tebrox-Development:VertexCore:v1.1.0")
}

Maven

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.Tebrox-Development</groupId>
    <artifactId>VertexCore</artifactId>
    <version>v1.1.0</version>
    <scope>provided</scope>
</dependency>

开发分支

当前的 development 分支目标是 1.1.0-SNAPSHOT。

其构建基线为:

  • Java 发布目标:21
  • Paper 编译 API:1.21.4-R0.1-SNAPSHOT
  • 运行时兼容性门控:Paper 1.21.4 / Java 21 以及 Paper 26.2 / Java 25

文档

  • 完整文档可在 GitHub Wiki 中找到
  • 涵盖配置、数据库、命令系统和迁移

许可证

MIT License

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源