How To Setup A MineHut External Server

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.

Important Notice: Minehut has paused new External Server Plan purchases to streamline their network. This guide will only 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

1. Log into your MintServers panel and stop your server.
2. Open your Files tab and navigate to the config folder, then open the paper-global.yml file.
3. Find the setting for proxy-protocol and change it to true. Save the file.
4. Navigate back to your main Files directory and open the server.properties file.
5. Find the enforce-secure-profile setting and change it to false. Save the file.

For Velocity Proxies

1. Stop your server in the panel.
2. Open the velocity.toml file in your file manager.
3. Under the advanced section, set haproxy-protocol = true. Save the file.

For Waterfall Proxies

1. Stop your server in the panel.
2. Open the config.yml file in your file manager.
3. Under the listeners section, set proxy_protocol: true. Save the file.

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.

1. Identify and copy the exact flag code for your specific server type below.
2. Open a support ticket here on MintServers.
3. Paste the flags in your ticket and request that they be added to your server's startup parameters.

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=""

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.

1. Log into your Minehut account and navigate to your Server Panel.
2. Make sure your Server Plan is set to External.
3. Navigate to the External Server Settings section.
4. IP: Enter your MintServers IP address. Do not include the port here.
5. Proxy Type: Select Velocity or Waterfall if you are using a proxy. Select Other if you are using a standalone Paper server.
6. DNS Record Type: Select Port.
7. Port: Enter the 5-digit port assigned to your MintServers host.
8. TCP Shield: Leave this as Not Configured unless you have manually configured TCPShield externally.
9. Save your changes.

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.