Getting Started with GensCore
GensCore is an all-in-one survival and faction core plugin developed for PaperMC & Folia (Minecraft 26.1+) running on Java 25 (LTS).
Key Highlights
- Server Loaders Supported: PaperMC, Folia, and Purpur (Minecraft 26.1+).
- Runtime Requirement: Java 25+ (uses modern JVM features, pattern matching, and ASM 9.10.1).
- Zero Mandatory Dependencies: GensCore includes its own economy engine, SQLite database, container locking, and permission fallback.
- Cross-Play Out of the Box: Native Bedrock support when Geyser & Floodgate are installed.
Installation Steps
- Check your Java version: Make sure your Minecraft server is running on Java 25 or higher:bash
java -version - Download the latest
.jar: GetGensCore-vX.Y.Z.jarfrom GitHub Releases or Modrinth. - Place in the
plugins/directory: Drop the jar file into your server'splugins/folder. - Start the server: Start or restart your server. GensCore will automatically:
- Create the
plugins/GensCore/configuration directory. - Initialize the local SQLite database (
genscore.db) with WAL concurrency. - Extract the web panel assets to
plugins/GensCore/web/. - Start the Javalin web micro-server on port
8080.
- Create the
Ecosystem & Integrations
GensCore operates 100% autonomously, but automatically enhances its capabilities if these plugins are detected:
| Plugin | Integration Type | Description |
|---|---|---|
| Vault | Soft Dependency | Automatically registers GensVaultEconomy. Allows 3rd-party plugins (ChestShop, Towny, Claims) to access GensCore balances. |
| LuckPerms | Soft Dependency | Automatically reads player ranks, primary groups, weights, and prefixes for Chat and Tablist/Scoreboard. |
| Floodgate / Geyser | Optional | Automatically enables native Bedrock UI forms (Cumulus API), handles Bedrock UUIDs, and resolves Bedrock skin heads. |
| BlueMap | Optional | If installed, embeds a live 2D/3D map viewer directly into the Web Admin Panel. |
| PlaceholderAPI | Optional | Expands GensCore variables across other plugins. |
Recommended Client: Gens Launcher
For the best player experience when connecting to a GensCore server (automatic mod and resource pack sync, zero friction), recommend Gens Launcher. It features automated Java setup, instant cloud sync (Horizon Delta Sync), and native support for Fabric, NeoForge, and Forge.
Next Steps
- Explore the complete Commands Reference.
- Set up player and staff ranks with Permissions & LuckPerms.
- Dive into the 30 In-Game Modules.
- Connect to the Web Panel & Minigames.