Skip to content

Java Plugin - Connector Guide

Using the Connect Java Plugin as a Connector for your Minecraft server or proxy. If you have a Minecraft Java server or proxy, this the most convenient Connector for you, but it is not as capable as the Gate Proxy Connector in terms of routing features and performance.

The Connect Plugin is a powerful multi-platform Minecraft plugin that tunnels your players through the global Connect Network to your Minecraft server/proxy.

-> It supports PaperMC, BungeeCord and Velocity platforms.

Downloading the Connect Plugin

The installation steps are the same as for every other Minecraft plugin (Download jar, put in plugins folder, start server). Download the Connect plugin right here!

Spigot/PaperMC PluginVelocity PluginBungeeCord Plugin
connect-spigot.jarconnect-velocity.jarconnect-bungee.jar

Ready to experience Minekube Connect? Download the latest stable release for your platform! 👆

Console showing public domain

Disabling "enforce secure player profiles" Required

Since Minecraft 1.19 the enforce-secure-profile property was introduced. Players joining through the Connect Network to your server won't be able to join if this setting is enabled. It is safe to disable this setting as it only affects chat messages.

properties
enforce-secure-profile=false

# If you disable online-mode, then enforce-secure-profile has no effect
online-mode=true
toml
force-key-authentication = false

# If you disable online-mode, then force-key-authentication has no effect
online-mode = true
yaml
enforce_secure_profile=false

  # If you disable online-mode, then enforce-secure-profile has no effect
online_mode=true

Joining your Server

Every server has a unique configurable Endpoint name that directly reflects the domain players can join the server with. If you leave this field empty, Connect will use a temporary random endpoint name for your server provided by the Random Name Service.

You can always update that endpoint name in the config:

yaml
endpoint: your-server-name
yaml
connect:
  name: your-server-name

The environment variable CONNECT_ENDPOINT takes precedence over the configuration file.

Joining with free provided Public Domain

After installing Connect plugin and starting your server you will see the free public domain for your server that looks like <endpoint>.play.minekube.net.

shell
[connect] Enabling connect vX.Y.Z
[connect] Enpoint name: live-beru
[connect] Your public address: live-beru.play.minekube.net

Use your domain to join your server.

Console showing public domain

Ping requests are also mirrored to the endpoint server.

Joining from Browser Hub

Players can also discover your server from the in-game Browser Hub at minekube.net and can join with the in-game UIs or with the /browser join <your-server-name> command.

Example Setups

Minekube Connect advances the way players connect and developers architect secure Minecraft servers and networks. Let's take a look at some common example setups.

#1 Example: Velocity

Connect -> [ Velocity -> Papers ]

  • We have Velocity in online mode running on localhost:25577 and want to use Connect.
  • We install the Connect plugin to Velocity's plugins folder.
  • We choose a name for our endpoint in the Connect plugin config plugins/connect/config.yml.
  • We start Velocity and Connect Plugin will automatically tunnel players from the Connect Network.
  • Done! We can now join our Velocity server at <endpoint>.play.minekube.net. Online mode players from Connect Network can join thanks to Plugins's auth session injection mechanisms.

#2 Example: Paper

Connect -> Paper

  • We have Paper running on localhost:25565 and want to use Connect.
  • We install the Connect plugin to Paper's plugins folder.
  • We choose a name for our endpoint in the Connect plugin config plugins/connect/config.yml.
  • We start Paper and Connect Plugin will automatically tunnel players from the Connect Network.
  • Done! We can now join our Paper server at <endpoint>.play.minekube.net. Online mode players from Connect Network can join thanks to Plugin's auth session injection mechanisms.

#3 Example: Connect passthrough + AuthSession API

Passthrough mode and AuthSession API is Coming soon

Plugins are released under the MIT License (version: a249ad69) - Not affiliated with Mojang nor Minecraft