Home

VertexCore Wiki

VertexCore is a Paper-only core plugin that provides shared infrastructure for other plugins.

It is designed for plugin developers who want to avoid duplicated boilerplate code for configuration handling, database access and command execution.

VertexCore is not a gameplay plugin.
It serves as a reusable technical foundation for multiple dependent plugins.

VertexCore 1.1.0

Java 21 or newer
Paper 1.21.4 or newer
Compiled against the Paper 1.21.4 API
Runtime compatibility verified with:
- Paper 1.21.4 / Java 21
- Paper 26.2 / Java 25

The same VertexCore JAR is tested against both compatibility endpoints.

Newer Paper versions may require a newer Java runtime independently of VertexCore.

Getting Started
Installation, JitPack dependency setup, runtime requirements and first integration steps.

Config System
Annotation-based YAML configuration, validation, defaults and configuration persistence.

Command System
Annotation-driven commands, subcommands, permissions, arguments and tab completion.

Database System
Persistent data storage using JSON, H2 or MySQL/MariaDB, including async and tracked writes.

Migration Guide
Register plugin data and migrate between supported database backends.

API Overview
Quick reference for the most important VertexCore APIs and their intended use.

Troubleshooting
Solutions for common installation, configuration, database and migration problems.

VertexCore 1.1.0 targets Java 21 bytecode and is compiled against the Paper 1.21.4 API.

Runtime compatibility is verified using the same release JAR on:

Paper	Java	Status
1.21.4	21	✅ Verified
26.2	25	✅ Verified

This allows the same VertexCore release to support a broad range of Paper environments while keeping Java 21 as the VertexCore baseline.

VertexCore 1.1.0 · Repository · Releases · Issues