VertexCore

VertexCore

VertexCore is a shared core and library plugin for Paper servers.

It provides reusable infrastructure for other plugins and is designed to reduce duplicated boilerplate for common systems such as configuration handling, database access, and command execution.

VertexCore is not a gameplay plugin.

It is intended to be installed as a dependency for plugins that use the VertexCore API.

Features

Configuration System

• Annotation-based configuration definitions
• Automatic configuration file generation and loading
• Default values and validation
• Configuration comments
• Direct mapping between configuration files and Java objects

Database System

VertexCore provides a common persistence layer with support for:

• JSON flat-file storage
• H2
• MySQL
• MariaDB
• Synchronous and asynchronous access
• Database migrations
• Configurable database backends

Command System

• Centralized command infrastructure
• Root commands and subcommands
• Argument injection and resolvers
• Permission handling
• Command visibility
• Tab completion

Requirements

• Paper 1.21.4 or newer
• Java 21 or newer

VertexCore itself is compiled for Java 21.

The Java version required by your Paper version still applies. Newer Paper releases may therefore require a newer Java runtime independently of VertexCore.

Verified compatibility

The same VertexCore JAR is runtime-tested at both compatibility endpoints.

Installation

1. Download the latest VertexCore release.
2. Place the JAR in your server's plugins directory.
3. Restart the server.
4. Install a plugin that uses VertexCore.

Plugins using VertexCore should declare it as a required dependency.

Developer Usage

VertexCore is available through JitPack.

Gradle

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

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

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.1</version>
    <scope>provided</scope>
</dependency>

Documentation

Detailed documentation and integration examples are available in the GitHub Wiki.

Source Code

VertexCore is open source and licensed under the MIT License.

View the source code on GitHub

Support

For support, questions, or discussion, join the Tebrox Development Discord.

More Plugins

Looking for more plugins by Tebrox?

View all public plugins