Support needed setting up external server - any advice is much appreciated! | Minehut | Page 1

old bobcat Aug 30, 2025, 11:31 AM

#

Hi everyone,

I hope you are well!

I'm currently trying to setup an external server for my Paper 1.21.5 server so that I can be listed on the minehut GUI but maintain being with my current host (revivenode for reference).

If anyone has any advice/feedback on what I should do next it would be much appreciated. I have documented below what I have done so far and what has/didn't work:

As per the instructions, I have set the following 'enforce-secure-profile=false'
In regards to the paper-global.yml instruction, this seems to be the main thing causing problems... I know it states 'proxy-protocol: true' in the instructions but when I do this it does allow my server to start up fully (in console) but as soon as you try to refresh/join .etc. the server - it doesn't actually show up as being online at all - just says 'Connecting' indefinitely. I know it mentions to skip this step when using 'TCPShield' which I am not sure if my host uses this specific brand of DDoS protection, so when I tested this it did actually allow my server to pop up again as being 'online' but when you try connecting to it -- it just says 'Failed to verify username'. Note: I am not trying to join via minehut at this point, I just wanted to join with the direct IP address.
CLI flags to startup command - my host doesn't allow me to edit the startup code myself - instead they offer premade startup commands, one of which is called 'Aikar + Minehut' - this features the exact script code mentioned on the minehut instructions blog but it also has a load of other bits that I don't know what they mean. I am going to paste this below:

#

java -Xms128M -Xmx$((16384-1024))M -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs/ -Daikars.new.flags=true -Duser.timezone={{TIMEZONE}} -Dlog4j2.formatMsgNoLookups=true -DPaper.IgnoreJavaVersion=true -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 -jar server.jar nogui

Minehut dashboard - this has been the most simple step so far at least... IP has entered as our original number ip (we have a URL text based one setup in DNS but just to be safe I am using the number one), proxy type set to other (as using Paper), DNS record type set to port, TCP Shield set to not configured (again - not sure if my host uses this DDoS software so didn't know what to put). For reference in regards to the TCP Shield option - I did try both options when setting up because I was trying to find out which variable is causing issues.

#

Just based on my personal take on this - I tried this many many times and changed one variable at a time. The biggest issue appeared to be setting the 'proxy-protocol: true' - the minute this was true you couldn't even try to connect to the server, so with this being left as false - the main error is just 'Failed to verify username'.

If anyone has any advice please let me know, I have contacted both my host and minehut but given it's the weekend I know I won't hear back from them until at least Tuesday minimum.

Thank you for reading - I appreciate there is a lot...

Best wishes,

Kyle.

slim fable Aug 30, 2025, 1:48 PM

#

you will only be able to connect with the minehut.gg ip after connecting an external server to MH

#

make sure you're trying to join with that IP

#

to add a custom domain - you need to point them back to the minehut.gg ip

#

does it work when you attempt to join with the mh ip?

old bobcat Aug 30, 2025, 3:39 PM

#

@slim fable thanks for replying - I have two questions based on what you just said:

So just to confirm, the IP atm is 'behindbarsmc.com'. Are you saying that once I connect to minehut this IP is effectively dead moving forwards and I HAVE to make all users use the minehut ip address? It's not possible to have my independent IP for my users that I have already joined my server prior to setting up this internal ip address?
In regards to joining the MH ip - I did everything above instruction wise - joined MH - went to join my server and it just said offline. But with that being said I haven't done what you said regarding the minehut.gg ip - there isn't anything on the dashboard saying 'this is your new ip' or instructing me on the DNS setup for this?

Any feedback on these would be amazing thanks!

karmic ingot Aug 30, 2025, 3:42 PM

#

old bobcat <@976447336496660500> thanks for replying - I have two questions based on what y...

Do not configure your custom domain on the minehut dashboard. Instead just configure your direct numerical IP there and then route your custom domain through Minehut for it to work fine.
If you are trying to join and it is saying the server is offline, then something wasn't setup correctly when setting up the external server or you have some plugins interfering with the serverlist ping response such as any motd plugins.

old bobcat Aug 30, 2025, 3:44 PM

#

I will provide screenshots of everything I have done so far across all configs/DNS/minehut .etc. - if you can tell me what I need to add/remove that would be great - I'm not fantastic with plugin/proxy stuff so a hand hold is much appreciated lol

old bobcat Aug 30, 2025, 4:06 PM

#

paper-global.yml

#

currently false as per my reasoning above ^

#

server properties

#

#

#

Minehut dashboard view for external server settings ^^

#

This is the startup command as per my hosts preset codes. Please note again - when I run this startup - I am no longer able to join via 'behindbarsmc.com' so myself and my existing player base cannot join through this ip anymore despite it still being setup in DNS.

The minehut instruction code is within this startup code though

#

And finally this is the DNS setup so far for the URL - if I am missing anything please let me know

karmic ingot Aug 30, 2025, 4:50 PM

#

old bobcat currently false as per my reasoning above ^

it needs to be true. skipping any of the steps will make it not work

karmic ingot Aug 30, 2025, 4:50 PM

#

karmic ingot 1. Do not configure your custom domain on the minehut dashboard. Instead just co...

refer to #1 if you want your custom domain to work

old bobcat Aug 30, 2025, 4:53 PM

#

karmic ingot it needs to be true. skipping any of the steps will make it not work

Even though when I do this it then stops the behindbarsmc.com version of the IP not showing up at all??

karmic ingot Aug 30, 2025, 4:53 PM

#

karmic ingot refer to #1 if you want your custom domain to work

.

old bobcat Aug 30, 2025, 4:54 PM

#

so just to be clear as I'm not sure I full understand - you are saying remove this part?

#

so get rid of the connected custom domain

#

and keep up here with the numerical ip?

karmic ingot Aug 30, 2025, 4:55 PM

#

if your configured IP is already your numerical IP, then just follow this guide below

final torrentBOT Aug 30, 2025, 4:55 PM

#

How do I set up a custom domain?

While using Minehut, all servers by default can be connected to by using the IP servername.minehut.gg. If you are interested in taking your server to the next level by using a custom domain, follow the tutorial below and you'll easily be able to set one up.

⚠️ Requirements:

Dashboard access to the Minehut server you'd like to use the custom domain on. This works with free, paid and external plans!
You will need to purchase a domain. This guide uses Cloudflare as it's a popular, affordable option, but you can use whichever domain registrar you'd like. The records needed are the same across all domain registrars, although the UI will look different than our screenshots if you use a different service.
You will need to have the DNS records page of your domain registrar open in your browser. Most of the custom domain setup involves your providers website

old bobcat Aug 30, 2025, 4:57 PM

#

Will go through this shortl! Final question - I have Geyser installed as well for bedrock users - is there anything in the configs there that I need to change relating to proxies as well?

karmic ingot Aug 30, 2025, 4:58 PM

#

Minehut automatically handles the Geyser installation for you so you do not need to set that up yourself

old bobcat Aug 30, 2025, 5:15 PM

#

Ah okay I will leave this alone then! In regards to the start up command does this look right to you? it means something about aikar + minecart - no idea what aikar is but it's a default option from my host that accompanies the minehut code

karmic ingot Aug 30, 2025, 5:24 PM

#

You can read this to learn more about what aikar's flags are but as long as the minehut one is inside of that, it'll work fine

old bobcat Aug 31, 2025, 9:42 PM

#

I can confirm that I have now managed to connect to my server via minehut 🙂 I am now only left with 2 things that I don't know how to do:

Set it up so that I can point the minehut IP to my original IP address so that my old users can connect with the original IP and also the voting site pages I am on still have this IP address (so basically making it so that behindbarsmc.minehut.gg can also be connected to by using 'behindbarsmc.com' as this is what my old users will have.
Once I have finally done that - how do I get my server added to the main menu GUI for prison servers? I just had a quick look and I can't see it on there - I assume there is a final setup to 'publish' it?

#

or am I correct in thinking that my first question is basically following step 2 in the latest link you posted above? @karmic ingot

#

Please ignore number 2 - we had a newb join - so just the original point 1 question

#

thank you very much for this so far - I really appreciate it!

karmic ingot Aug 31, 2025, 9:47 PM

#

old bobcat I can confirm that I have now managed to connect to my server via minehut 🙂 I a...

Refer to the custom domain article I linked a couple messages above and that will show you how to link your custom domain to work with Minehut.
On the Minehut dashboard, you can set your server visibility to true and also configure any server categories there and it'll show up in the GUI under those categories.

old bobcat Aug 31, 2025, 9:47 PM

#

That is fantastic - thank you so much tarna I really appreciate you helping! 🙂

karmic ingot Aug 31, 2025, 9:47 PM

#

yeah np!

old bobcat Aug 31, 2025, 10:13 PM

#

Sorry to poke you again @karmic ingot - please could I just get your eyes on this java setup - I am about to do the bedrock version as well

#

it's not currently working but I know it can take a few hours/days

#

so just to confirm - this setup should allow me to point 'behindbarsmc.com' (which is why I put @ for host) to the minehut ip 'behindbarsmc.minehut.gg'?

karmic ingot Aug 31, 2025, 10:20 PM

#

if you want to have your domain support both Java and Bedrock, you need to use an SRV record for Java and then a CNAME for Bedrock

#

on the custom domain article, go to the part that says 2B

#Support needed setting up external server - any advice is much appreciated!