Linking your MintServers host to Minehut as an External Server gives you the best of both worlds: dedicated server performance and direct access to the massive Minehut community. The setup process requires editing a few configuration files on your server and linking your IP address.
As of September 2025, new external servers are only available to accounts accepted into Minehut's Partners Program. This guide will still work if you already have an existing External Server plan active on your Minehut account.
Step 1: Configure Your MintServers Host
Before linking the servers, you must prepare your MintServers host to accept connections forwarded by Minehut's authentication service. The steps differ depending on the server software you are running.
For Paper Servers
For Velocity Proxies
For Waterfall Proxies
Note: Bungeecord is currently not supported by Minehut. If you use a proxy, you must use Velocity or Waterfall.
Step 2: Add Required Startup Flags
Next, specific startup flags need to be added to your server so Minehut can verify your players. Because these are advanced launch parameters, you will need to reach out to our team to get them applied.
Paper Flags:
-Dminecraft.api.services.host=https://api.minecraftservices.com/ -Dminecraft.api.auth.host=https://authserver.mojang.com/ -Dminecraft.api.account.host=https://api.mojang.com/ -Dminecraft.api.profiles.host=https://api.mojang.com/ -Dminecraft.api.session.host=https://api.minehut.com/mitm/proxy
Velocity Flags:
-Dmojang.sessionserver=https://api.minehut.com/mitm/proxy/session/minecraft/hasJoined
Waterfall Flags:
-Dwaterfall.auth.url="https://api.minehut.com/mitm/proxy/session/minecraft/hasJoined?username=%s&serverId=%s%s"
Our support team will quickly apply the changes and restart your server for you so you can proceed to the final step!
Step 3: Connect Minehut to Your Server
Once our team confirms your startup flags are added and your server is running, you need to link the address inside your Minehut account.
Once your settings are saved, your servers will be linked. Players connecting to your Minehut address will automatically be routed to your MintServers host. For additional details or optional settings like custom domains, you can refer to the official Minehut External Hosted Server setup guide.
Still stuck?
Our team is happy to help. Open a ticket through the live chat button in the bottom-right corner of our website, or join our Discord and open a ticket there.
Join our Discord