From e1fe4a7c2f9a3cf54642cf80efb153ae1f06c7f4 Mon Sep 17 00:00:00 2001 From: "minekube-ai-engineer[bot]" Date: Fri, 21 Aug 2026 00:46:25 +0000 Subject: [PATCH] docs: document MC 1.13+ / Java 17+ requirements floor The plugin bundles unrelocated Netty 4.2.x and is compiled for Java 17. Servers below 1.13 (Minecraft 1.8-1.11 ship Netty 4.0.x) fail packet listener injection with AbstractMethodError (missing newChild implementation) and the plugin disables itself, leaving the endpoint without a connector. Document the requirements so users on old server versions are not misled. Refs: connect-java netty floor support finding (Discord support thread). --- .github/hangar-description.md | 9 +++++++++ README.md | 10 ++++++++++ 2 files changed, 19 insertions(+) diff --git a/.github/hangar-description.md b/.github/hangar-description.md index 4665a0e56..432a0a740 100644 --- a/.github/hangar-description.md +++ b/.github/hangar-description.md @@ -19,6 +19,15 @@ the normal plugin setup does not require a backend Geyser installation. For more routing features and the connector that receives the most frequent updates, consider the [Gate connector](https://connect.minekube.com/guide/connectors/). +## Requirements + +- **Minecraft 1.13+** on Paper/Spigot (and supported proxy versions on Velocity and + BungeeCord) — the declared `api-version` floor and the first version whose servers + ship the Netty 4.1+ the plugin's bundled Netty (4.2.x, unrelocated) requires. + Servers 1.8–1.11 ship Netty 4.0.x, where the packet listener injection fails with + `AbstractMethodError` (missing `newChild` implementation). +- **Java 17+** to run the plugin. + ## Quick start 1. Download the jar for your platform and place it in the server or proxy diff --git a/README.md b/README.md index ef708f29f..833775d46 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,16 @@ low latency edge proxies network nearest to you. Please refer to https://connect.minekube.com for more documentation. +## Requirements + +- **Minecraft 1.13 or newer** — the declared `api-version` floor in `plugin.yml`, and + the version from which servers ship the Netty 4.1+ the plugin's bundled Netty (4.2.x, + unrelocated) requires. Servers 1.8–1.11 ship Netty 4.0.x, where the packet listener + injection fails with `AbstractMethodError` (missing `newChild` implementation) and the + plugin disables itself. +- **Java 17 or newer** — the plugin is compiled for Java 17; older server JVMs + (Java 8/11, typical for Minecraft ≤1.12 servers) cannot load it. + ## Integrating with login / auth plugins Connect authenticates players at the edge, so login plugins that force online mode on a