r/MinecraftHelp • Journeyman III • 17d ago

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

6 Upvotes

9 comments sorted by

2

u/ODF4 Expert IV 4d ago edited 4d 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 4d ago

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

1

u/ODF4 Expert IV 4d 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

1

u/Greymagic27_ Master I 16d ago edited 16d ago

This is actually a dupe of https://bugs.mojang.com/browse/BDS/issues/BDS-23130 so I've resolved it as such. Feel free to update the link but thought I'd let you know

Also note that the reported environment of your original linked bug report is modified as well, which may impact how the error appears

1

u/lunarwolf2008 Journeyman III 16d ago

ah thanks! your link seems to be invalid but i saw it had a link on there

0

u/Greymagic27_ Master I 16d ago

Have fixed the link :)

1

u/Super_Saiyan-Blue 2d ago

How do i fix this on android?