Using Minehut external

How to connect your Minecraft server to Minehut's network.

By connecting your server to Minehut, you become part of their network. This allows you to advertise in their lobby, use their DDoS protection, and more. We fully support connecting to Minehut external.

We recommend only using an external Minehut proxy if you know what you're doing.

Changing your startup flags

Before players can connect to your server through Minehut you will need to set up your server to use Minehut’s authentication service.

To prevent misuse, you won't be able to change your startup flags yourself. You'll need to open a ticket and request for your flags to be changed.

If you're using Velcoity, in the velocity.toml file, set haproxy-protocol to true.

You can then add the following CLI flag to your start script:

-Dmojang.sessionserver=https://api.minehut.com/mitm/proxy/session/minecraft/hasJoined

If you're using Paper, in the server.properties file, set enforce-secure-profile to false.

You can then add the following CLI flag to your start script:

-Dminecraft.api.auth.host=https://authserver.mojang.com/ -Dminecraft.api.account.host=https://api.mojang.com/ -Dminecraft.api.services.host=https://api.minecraftservices.com/ -Dminecraft.api.session.host=https://api.minehut.com/mitm/proxy

Connecting a Minehut server

Go to Minehut and create an account. You’ll use this account to manage your server. Create a new plan, or use an existing one, and set it to be external.

On Minehut, open your server’s server panel and navigate to the "External Server Settings" section.

Complete the following fields:

IP: <the IP or domain of your external server>
Proxy Type: Velocity / Other
DNS Record Type: Port / SRV
Port: <the port of your external server>
TCP Shield: Not Configured

Save your changes, then restart both servers.

Other settings

We recommend reading the official Minehut guide for information on how to use other settings. These include using resource packs and setting up custom appearances.