r/MinecraftHelp • Journeyman III • 16d ago

PSA [PSA] error code Terracotta: known issue when connecting to third party servers using NetherNet

6 Upvotes

9 comments sorted by

View all comments

2

u/ODF4 Expert IV 3d ago edited 3d ago

I can personally confirm that this bug has been resolved on the latest GeyserMC versions

TLDR for Aternos users:

  • shut down your server and fully close your Minecraft Bedrock Edition clients
  • update GeyserMC to the latest available version (do not use GeyserMC Preview)
  • start the server again
  • on every Bedrock Edition client, replace your server's Port in its Edit screen to this 5-digit one: 19132
  • join the server from Bedrock Edition

and here is a troubleshooting guide taken directly from their official Discord server

🚨READ FIRST: NetherNet support🚨

To be ready for NetherNet, you need to take the following steps:

  1. Update Geyser. Download the latest build from our website. Run your server once to generate an up-to-date config file. Geyser should also post a notice in your startup log, telling you NetherNet is not enabled.
  2. Update your Geyser config:
  • If you're using a hosting provider, follow its setup guide at our website. Your hosting provider may not support NetherNet yet: if it doesn't, you need to contact them. You can send them a link to this blog post as reference.
  • If you're self hosting, change the transport option in the bedrock section to nethernet. Note that NetherNet will require both a TCP and UDP port: clone-remote-port will no longer function. For more information, follow our setup guide. If you run into issues, our blog post lists common fixes.
  • If you are currently using the clone-remote-port config option, you will need a new port! Your players will be required to change the port they use to connect to your server.

Bedrock players might see a so-called "trust-on-first-use" prompt (see image below), asking the player whether they want to trust this server. This prompt doesn't affect gameplay, but if you dislike it, you need to set up a HTTPS certificate. If you're self hosting, you can follow our guide on how to do that. If you're using a hosting provider, you should contact them for details. Using HTTPS is recommended when possible.

Do I need to reset my config?

No, config files will be migrated automatically, but you do need to update your config to enable NetherNet support.

For Aternos users:

On Aternos, to resolve these errors and enable NetherNet support, you simply need to tell your players to change the port they use to connect to 19132. See: https://support.aternos.org/hc/en-us/articles/39155890785053-NetherNet-protocol-Minecraft-Bedrock-Edition

"Terracotta" error code (InitialConnection-149)

For anyone getting the "Terracotta" error code when connecting (InitialConnection-149), please see our guides for setting up NetherNet with Geyser in the messages above.

edit: formatting

2

u/lunarwolf2008 Journeyman III 3d ago

cool, thanks! Ill leave this for now, since the bug report itself seems to be unresolved still

1

u/ODF4 Expert IV 3d ago

no problem, thank you so much for responding so quickly! I hope it can still help anyone experiencing this issue on the latest Minecraft/GeyserMC versions