How minekube/connect-java works
Minekube Connect is a Minecraft server/proxy plugin that exposes servers to Connect’s edge-proxy network. The principal flow is WatchService session negotiation, admission (including configured Bedrock identity checks), then creation of a local session that carries the player connection through a tunnel to the server. The repository also provides platform-specific adapters, packet interception, and an optional libp2p endpoint mode. Edges are limited to relationships visible in the supplied excerpts or README; unverified handoffs are dashed.
Main entry points: WatchClient.java WatchService client · BungeePlugin.java Connect plugin · LocalSession.java Local session · BedrockAdmissionCoordinator.java Bedrock admission
Components 21
Platform integration
- Connect plugin
bungee/src/main/java/com/minekube/connect/BungeePlugin.java - Platform adapters
bungee/src/main/java/com/minekube/connect/module/BungeePlatformModule.java - Spigot login adaptation
spigot/src/main/java/com/minekube/connect/addon/data/SpigotDataHandler.java
Session lifecycle
- Connect configuration
core/src/main/java/com/minekube/connect/config/ConnectConfig.java - WatchService client
core/src/main/java/com/minekube/connect/watch/WatchClient.java - Session proposal
core/src/main/java/com/minekube/connect/watch/SessionProposal.java - Local session
core/src/main/java/com/minekube/connect/network/netty/LocalSession.java
Identity and admission
- Bedrock admission
core/src/main/java/com/minekube/connect/bedrock/BedrockAdmissionCoordinator.java - Bedrock identity verification
api/src/main/java/com/minekube/connect/api/player/bedrock/BedrockIdentityVerifier.java - Signed principal verification
api/src/main/java/com/minekube/connect/api/player/principal/DefaultBedrockPrincipalVerifier.java
Tunnel transport
- Local channel pipeline
core/src/main/java/com/minekube/connect/network/netty/LocalChannelInboundHandler.java - Tunnel connection
core/src/main/java/com/minekube/connect/tunnel/TunnelConn.java - Tunnel orchestration
core/src/main/java/com/minekube/connect/tunnel/Tunneler.java - Watch tunnel transport
core/src/main/java/com/minekube/connect/tunnel/WebSocketTunnelTransport.java - libp2p endpoint
core/src/main/java/com/minekube/connect/tunnel/p2p/Libp2pEndpointRuntime.java
Plugin features
- Packet handler API
api/src/main/java/com/minekube/connect/api/packet/PacketHandlers.java - Packet dispatch
core/src/main/java/com/minekube/connect/packet/PacketHandlersImpl.java - Commands and configuration
core/src/main/java/com/minekube/connect/command/main/MainCommand.java
Other components
- Minecraft player
- Connect edge network
- Minecraft server
Connections 21
- Minecraft player → Connect edge network: requests connection
README.md - Connect edge network → WatchService client: negotiates sessions
README.md - WatchService client → Connect configuration: reads settings
core/src/main/java/com/minekube/connect/watch/WatchClient.java - WatchService client → Session proposal: receives proposals
core/src/main/java/com/minekube/connect/watch/WatchClient.java - Session proposal → Local session: starts session
core/src/main/java/com/minekube/connect/network/netty/LocalSession.java - Local session → Bedrock admission: coordinates admission
core/src/main/java/com/minekube/connect/network/netty/LocalSession.java - Bedrock admission → Bedrock identity verification: verifies identity
- Bedrock admission → Signed principal verification: checks principal
- Local session → Local channel pipeline: installs pipeline
core/src/main/java/com/minekube/connect/network/netty/LocalSession.java - Local channel pipeline → Tunnel orchestration: uses tunnel
core/src/main/java/com/minekube/connect/network/netty/LocalSession.java - Tunnel orchestration → Tunnel connection: opens connection
- Tunnel connection → Watch tunnel transport: uses transport
- Watch tunnel transport → Connect edge network: carries session
- Tunnel connection → Minecraft server: forwards traffic
README.md - Connect plugin → Platform adapters: configures platform
bungee/src/main/java/com/minekube/connect/BungeePlugin.java - Connect plugin → WatchService client: enables watcher
bungee/src/main/java/com/minekube/connect/BungeePlugin.java - Connect plugin → libp2p endpoint: enables endpoint
bungee/src/main/java/com/minekube/connect/BungeePlugin.java - libp2p endpoint → Connect edge network: registers peer
README.md - Packet handler API → Packet dispatch: implemented by
core/src/main/java/com/minekube/connect/packet/PacketHandlersImpl.java - Spigot login adaptation → Packet handler API: registers handler
- Commands and configuration → Connect configuration: inspects settings