Minekube Connect Documentation

website·Indexed 32 days ago

https://connect.minekube.com/

An ingress tunnel for Minecraft servers that allows authenticated Java and Bedrock players to connect. Features include support for public localhost servers, custom domains, DDoS protection, and dedicated connectors such as the Java Plugin and Gate Proxy.

Tokens
10.7K
Snippets
29
Records
96
Agent score
64%

What's inside Minekube Connect

  1. Overview of Craftless Minecraft client automation

    Craftless is a Minecraft client automation framework that allows developers to launch or attach to real Minecraft Java clients. It supports both headless mode for unattended runs and visible game windows for monitoring. Each running client is exposed as a generated local OpenAPI document, enabling agents, tools, and CI to drive the client without needing a manually maintained catalogue of gameplay commands. It is available as an install script for Linux and macOS, a runtime container image, and a GitHub Actions setup action.
  2. Overview of Minekube Connect

    Minekube Connect is a global gateway and DDoS-protected Minecraft native Superproxy. It provides a developer platform with public Anycast domains, allowing administrators to secure and scale Minecraft servers or proxies (including those running on localhost) to build durable networks in any environment.
  3. Overview of the Connect platform for Minecraft

    Connect is a platform designed to bridge the gap between Minecraft server creators and players. It aims to solve the 'empty server' problem by providing an in-game server browser that allows players to discover and join servers organically, removing the need to manually copy-paste server addresses from external voting websites. The platform provides equal opportunity for both large networks and small, new creators to gain visibility and build recurring player bases.
  4. Understand Minekube Connect Connectors

    A Connector is a software component that creates secure outbound tunnels between a Minecraft server or proxy and the Connect Edge Network. This allows the server to receive player connections without exposing its actual public IP address. It is particularly useful for users who want to hide their IP from attackers or those running servers on private networks/home connections without a public IP.
  5. Understand the status and limitations of the Connect AuthSession API

    The Connect AuthSession API is currently unavailable in production. It is designed as an adaptation of the Mojang AuthSession API to securely authenticate online-mode players from the Connect Network to a server or proxy.

    Key Constraints:

    • Requires a public IP address.
    • Only useful for users wanting to use Connect with online-mode players.
    • Unsupported Topology: The path Connect -> Gate Lite -> Online Mode Backend is not supported because Gate Lite is a thin reverse proxy and cannot translate Connect's edge-authenticated sessions into backend online-mode logins.

    Current Alternatives: To support online-mode players today, use standard Gate with Connect enabled or the Connect Java Plugin.

  6. Understand how Connect Tunnels bypass port forwarding

    Connect Tunnels allow Minecraft servers to be accessible from the internet without configuring port forwarding on a home router or dealing with dynamic public IP addresses. Instead of accepting inbound connections directly (which are typically blocked by firewalls on port 25565), the Connect plugin establishes outbound-only tunnel connections from the server to publicly routable edge proxies in the Connect Network. These edge proxies receive the player's inbound connection and route it through an encrypted tunnel to the server.
  7. Use Connect Network as a Proxy-as-a-Service

    The Connect Network replaces traditional Minecraft proxies such as BungeeCord. It acts as a global shared proxy, removing the need for server owners to deploy, configure, or maintain their own secure proxy infrastructure. To utilize this, the Connect Plugin must be installed on the servers.
  8. Understand Connect proxy routing

    Connect proxies utilize anycast routing, meaning all proxies share the same IP address. When a user connects to the Connect network, their internet service provider (ISP) automatically routes the traffic to the geographically nearest available Connect proxy.
  9. Mitigate DDoS attacks with the Connect Network

    The Connect Network protects servers from DDoS attacks by routing player traffic through a distributed network of proxies. If a specific proxy in the network comes under attack, other proxies automatically take over the real player traffic to prevent the destination server from being overloaded.
  10. Increase server visibility via the Connect Browser Hub

    Servers connected to the Connect Network can be discovered by players in-game through the Connect Browser Hub, in addition to being joined directly via their domain.
  11. Use Anycast Public IP for Minecraft endpoints

    Connect provides endpoints with a shared public Anycast IP address. This ensures that player traffic is routed through the nearest Connect Edge region relative to the player's location before being tunneled to the Minecraft server, reducing latency and optimizing the network path.
  12. Expose a local Minecraft server to the internet using Connect

    Connect allows you to host a Minecraft server on your local PC and make it publicly joinable without requiring router configuration or port forwarding. This is useful for local development, testing with global players, or hosting free multiplayer sessions for friends beyond your local network. When the Connect Plugin is active and the server starts, it automatically links with the Connect Network to enable external access.