Como corrigir os erros NetherNet e Terracotta no Geyser
Corrija os erros NetherNet e Terracotta em um servidor com Geyser: confira o código InitialConnection, atualize o Geyser e teste o acesso TCP e UDP.

A Pixly oferece suporte ao Bedrock 26.60 desde o primeiro dia. Ative o crossplay com Bedrock nas configurações e reinicie; a Pixly instala e configura o Geyser e o Floodgate automaticamente. Jogadores de Java e Bedrock entram pelo mesmo endereço.
O que significam os códigos NetherNet, Terracotta e Door
O Bedrock 26.60, lançado em 27 de outubro de 2026, só entra em servidores via NetherNet.12 Quando a conexão falha com um erro NetherNet, Terracotta ou Door, toque em Mostrar detalhes para ver o número do InitialConnection. Use esse número abaixo para escolher quais verificações fazer.
Uma conexão do Bedrock 26.60 começa com o signaling, uma requisição web por TCP que encontra o servidor, e depois o jogo roda por UDP.3 As notas de suporte do GeyserMC associam cada número de InitialConnection a uma causa:4
| Código | Detalhes | Causa | Solução |
|---|---|---|---|
| Terracotta | InitialConnection-149 | Geyser em RakNet ou porta TCP fechada | Os quatro passos abaixo |
| Door | InitialConnection-83 | UDP bloqueado ou servidor atrás de NAT | Libere o UDP e defina advertise-addresses |
| NetherNet | InitialConnection-13 | Nenhuma resposta via NetherNet nem RakNet | Confira o endereço e as duas portas |
| NetherNet | InitialConnection-122 | Conexão aberta e depois fechada | Atualize o Geyser; se continuar, veja os logs de desconexão |
Terracotta com 149 significa que o servidor não fala NetherNet ou que o signaling dele está inacessível.4 Um erro NetherNet com 13 significa que o servidor não respondeu por nenhum dos dois caminhos, então confira o endereço primeiro. Com 122, a conexão abriu e depois fechou; builds do Geyser anteriores à 1273 faziam isso no Alpine Linux.5
Corrija o erro Terracotta em um servidor com Geyser
Baixe o Geyser na página de download do GeyserMC e depois:
- Atualize o Geyser para a build mais recente. A build 1273, de 26 de outubro, é a primeira com suporte ao Bedrock 26.60, e as builds seguintes adicionam da 26.61 à 26.63.6
- Defina
transport: nethernetna configuração do Geyser. Ela fica emplugins/Geyser-Spigot/no Paper e emconfig/Geyser-Fabric/ouconfig/Geyser-NeoForge/no Fabric ou NeoForge.7 Builds até a 1279 mantêm uma linha antiga comraknet; a partir da build 1280, o Geyser muda isso para você. O único outro valor éboth, que também aceita RakNet e precisa de uma segunda porta UDP.8910 - Libere a porta do Geyser para TCP e UDP. Com Docker, publique
-p 19132:19132 -p 19132:19132/udp.3 Ela não pode ser a porta do servidor Java.7 - Reinicie e teste a entrada pelo Bedrock.
Built-in signaling started on http://0.0.0.0:19132confirma que o servidor de signaling do Geyser iniciou.8 Entre de fora da sua rede para verificar se os jogadores conseguem se conectar por TCP e UDP.3
A seção bedrock: da configuração fica assim:
bedrock:
port: 19132
transport: nethernetUm proxy, o Geyser Standalone ou uma hospedagem que só libera a porta do Java precisam de mais do que isso; o guia de configuração do Geyser e do Floodgate cobre esses casos.
Corrija o erro Door: confira UDP e NAT
Door com 83 significa que o signaling por TCP funcionou, mas o tráfego do jogo por UDP não passou. Isso acontece quando o redirecionamento de porta ou o mapeamento do Docker é só para TCP, então adicione UDP na mesma porta. Um dono de servidor resolveu o Door 83 em um console com 26.60 corrigindo o UDP, quando o TCP já funcionava.11
Se o Geyser estiver atrás de um roteador ou NAT e o Door continuar, o GeyserMC recomenda adicionar seu IP público em bedrock.signaling.advertise-addresses e reiniciar.4 Junte isto à seção bedrock: que já existe, trocando 203.0.113.10 pelo IP público do seu servidor:
bedrock:
signaling:
advertise-addresses:
- "203.0.113.10"Avisos do Geyser depois da 26.60 e o que eles significam
O Geyser mostra estes avisos na inicialização. As builds 1273 a 1279 também mandam uma mensagem sobre NetherNet para os operadores quando eles entram.69
Avisos do console do Geyser
WARNING! NetherNet support is NOT enabled.
As builds 1273 a 1279 mostram isso quando a configuração ainda diz
raknet. Atualize o Geyser, ou definatransport: nethernet, e reinicie.WARNING! Raknet-only transport has now been REMOVED.
A build 1280 ou mais recente mudou a configuração para NetherNet. Libere a porta para TCP além de UDP.
NetherNet will not start! Could not load its WebRTC native library
Builds anteriores à 1280 mostram
NetherNet is not available on Linux (amd64)no lugar. O Geyser não conseguiu carregar a biblioteca do NetherNet; as causas relatadas são a falta dolibcrypto.so.3(instale olibssl3no Ubuntu) e um/tmpsomente leitura.1211
Builds anteriores à 1280 acrescentam a esse último aviso a dica de definir transport como raknet. Ignore: segundo o GeyserMC, o Bedrock 26.60 não se conecta mais por RakNet de jeito nenhum.2
Testado: o que cada configuração quebrada faz com a conexão
Em 1º de novembro de 2026, testamos cinco configurações com Paper 26.3, Geyser 2.12.1 e um cliente de teste NetherNet feito com o gophertunnel, uma biblioteca open source para Bedrock.8
| Geyser | Configuração | Resultado da conexão |
|---|---|---|
| 1279 | transport: raknet | Recusada na hora via TCP |
| 1279 | transport: nethernet | O login chega ao Geyser |
| 1280 | transport: raknet | Mudada para NetherNet; o login chega ao Geyser |
| 1280 | TCP 19132 fechado | Recusada na hora via TCP |
| 1280 | UDP 19132 descartado | O signaling funciona; tempo esgotado após 30 s |
O cliente de teste informa a etapa em que cada conexão parou. Relatos externos batem com a configuração que funciona: um dono de servidor entra pelo Bedrock 26.60 no Windows via NetherNet,13 e as imagens de servidor da groundsgg voltaram a aceitar conexões do 26.60 com a build 1280 e TCP mais UDP 19132.14
Perguntas sobre os erros NetherNet e Terracotta
Como corrijo o erro NetherNet sendo jogador?
Confira o endereço do servidor e a versão do seu jogo. Envie ao dono do servidor a tela completa de Mostrar detalhes, seu dispositivo e versão do jogo, e se outros jogadores conseguem entrar. Os códigos 13 e 122 significam que a conexão falhou ou foi fechada; com os detalhes, o dono pode verificar os logs do servidor.
Por que meu servidor com Geyser não aparece em Jogos LAN no 26.60?
O Bedrock 26.60 procura mundos LAN na porta UDP 7551, onde o Geyser ainda não responde, segundo um relato que seguia aberto no rastreador de issues do Geyser em 10 de novembro de 2026.13 Adicione o servidor pelo endereço na aba Servidores.
Footnotes
minecraft.wiki, Bedrock Edition 26.60: lançado em 27 de outubro de 2026, protocolo 2225. Verificado em 1º de novembro de 2026. ↩
GeyserMC, Preparing Your Geyser Server for NetherNet, 8 de outubro de 2026: “Bedrock clients will stop connecting over RakNet.” ↩ ↩
GeyserMC, Port forwarding: “players find the server over TCP (signaling), and play on it over UDP.” Verificado em 1º de novembro de 2026. ↩ ↩ ↩
GeyserMC/Geyser, issue #6807, fechada: na imagem Alpine, o cliente “shows
InitialConnection-122(NetherNetDataChannelClosed) after 30 s”; corrigido na build 1273. ↩GeyserMC, lista de builds do Geyser 2.12.1: build 1273, 26 de outubro de 2026, “Support 26.60”, “Surgically remove 26.30” e “Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet”; build 1291, 6 de novembro, “Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support”; build 1298, 9 de novembro, “Indicate Minecraft: Bedrock Edition 26.63 Support”. Verificado em 10 de novembro de 2026. ↩ ↩ ↩
GeyserMC, guia de configuração do Geyser: “Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.” Verificado em 1º de novembro de 2026. ↩ ↩
Teste da Pixly, 1º de novembro de 2026: Paper 26.3 e Geyser-Spigot 2.12.1, builds 1279 e 1280, no Docker, com um cliente NetherNet feito com o gophertunnel entrando pela mesma rede; portas fechadas com regras de firewall dentro do contêiner do servidor. A build 1279 gerou uma configuração nova com
transport: nethernete manteve umtransport: raknetexistente, registrandoWARNING! NetherNet support is NOT enabled.↩ ↩ ↩GeyserMC, Remove RakNet-only transport (#6843), build 1280, 31 de outubro de 2026 (UTC): muda um transporte
raknetparanethernet, remove as mensagens de inicialização e de entradaWARNING! NetherNet support is NOT enabled.e troca a mensagem do Linux por “NetherNet will not start! Could not load its WebRTC native library”. ↩ ↩GeyserMC, GeyserConfig.java: “both”: “accepts NetherNet and RakNet. Each needs its own UDP port”. Verificado em 10 de novembro de 2026. ↩
spruyt-labs, run NetherNet transport for Bedrock 26.60 clients, fechada em 28 de outubro de 2026: “The first console test failed with
initialconnection 83. TCP signaling worked”, depois o UDP foi corrigido e “A console on Minecraft 26.60 reaches the server list and joins”; a inicialização tinha falhado com “/tmp/datachannel-java-...: Read-only file system”. ↩ ↩GeyserMC/Geyser, issue #6852, “NETHERNET: Terracotta error”, 31 de outubro de 2026: o log mostra
libcrypto.so.3: cannot open shared object file, e um colaborador do Geyser responde “Installing libssl3 should resolve your issue.” ↩GeyserMC/Geyser, issue #6853, 31 de outubro de 2026, ainda aberta em 10 de novembro: “Joining by address from the Servers tab works fine over NetherNet” no Bedrock 26.60 para Windows com Geyser 2.12.1-b1279, enquanto o broadcast LAN do cliente para UDP 7551 fica sem resposta porque “Nothing listens on UDP 7551”. ↩ ↩
groundsgg, fix(geyser): restore Bedrock 26.60 connections, mesclado em 1º de novembro de 2026: fixa o Geyser 2.12.1 build 1280 e libera TCP e UDP 19132. ↩
GeyserMC, Supported versions: “Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3.” Verificado em 10 de novembro de 2026. ↩