NetherNet- und Terracotta-Fehler in Geyser beheben
NetherNet- und Terracotta-Fehler auf einem Geyser-Server beheben: InitialConnection-Code prüfen, Geyser aktualisieren, TCP- und UDP-Zugang testen.

Pixly hat Bedrock 26.60 vom ersten Tag an unterstützt. Aktiviere Bedrock-Crossplay in den Einstellungen und starte neu; Pixly installiert und konfiguriert Geyser und Floodgate automatisch. Java- und Bedrock-Spieler verbinden sich über dieselbe Adresse.
Was die Codes NetherNet, Terracotta und Door bedeuten
Bedrock 26.60, erschienen am 27. Oktober 2026, verbindet sich nur noch über NetherNet mit Servern.12 Schlägt ein Beitritt mit einem NetherNet-Fehler, Terracotta oder Door fehl, tippe auf Details anzeigen, um die InitialConnection-Nummer zu sehen. Anhand dieser Nummer wählst du unten die passenden Prüfungen aus.
Ein Beitritt mit Bedrock 26.60 beginnt mit dem Signaling, einer Webanfrage über TCP, die den Server findet; gespielt wird danach über UDP.3 Die Support-Hinweise von GeyserMC ordnen jeder InitialConnection-Nummer eine Ursache zu:4
| Code | Details | Ursache | Lösung |
|---|---|---|---|
| Terracotta | InitialConnection-149 | Geyser auf RakNet oder TCP-Port geschlossen | Die vier Schritte unten |
| Door | InitialConnection-83 | UDP blockiert oder Server hinter NAT | UDP öffnen, advertise-addresses setzen |
| NetherNet | InitialConnection-13 | Keine Antwort über NetherNet oder RakNet | Adresse und beide Ports prüfen |
| NetherNet | InitialConnection-122 | Verbindung geöffnet, dann geschlossen | Geyser aktualisieren; tritt es weiter auf, die Disconnect-Logs prüfen |
Terracotta mit 149 bedeutet, dass der Server kein NetherNet spricht oder sein Signaling nicht erreichbar ist.4 Ein NetherNet-Fehler mit 13 bedeutet, dass der Server auf keinem der beiden Wege geantwortet hat; prüfe also zuerst die Adresse. Bei 122 wurde die Verbindung geöffnet und dann geschlossen; Geyser-Builds vor 1273 taten das unter Alpine Linux.5
Terracotta-Fehler auf einem Geyser-Server beheben
Lade Geyser von der Download-Seite von GeyserMC herunter und gehe dann so vor:
- Aktualisiere Geyser auf den neuesten Build. Build 1273 vom 26. Oktober ist der erste, der Bedrock 26.60 unterstützt; spätere Builds ergänzen 26.61 bis 26.63.6
- Setze
transport: nethernetin der Geyser-Konfiguration. Sie liegt auf Paper inplugins/Geyser-Spigot/und auf Fabric oder NeoForge inconfig/Geyser-Fabric/bzw.config/Geyser-NeoForge/.7 Builds bis 1279 behalten eine alteraknet-Zeile; ab Build 1280 ändert Geyser sie selbst. Der einzige andere Wert istboth, der zusätzlich RakNet annimmt und einen zweiten UDP-Port braucht.8910 - Öffne den Geyser-Port für TCP und UDP. Mit Docker veröffentlichst du
-p 19132:19132 -p 19132:19132/udp.3 Es darf nicht der Port des Java-Servers sein.7 - Starte neu und teste einen Bedrock-Beitritt.
Built-in signaling started on http://0.0.0.0:19132bestätigt, dass der Signaling-Server von Geyser läuft.8 Verbinde dich von außerhalb deines Netzwerks, um zu prüfen, dass Spieler über TCP und UDP hereinkommen.3
Der Abschnitt bedrock: der Konfiguration sieht dann so aus:
bedrock:
port: 19132
transport: nethernetEin Proxy, Geyser Standalone oder ein Host, der nur den Java-Port öffnet, braucht mehr als das; die Anleitung zu Geyser und Floodgate behandelt diese Fälle.
Door-Fehler beheben: UDP und NAT prüfen
Door mit 83 bedeutet, dass das Signaling über TCP funktioniert hat, der Spielverkehr über UDP aber nicht durchkam. Das passiert, wenn eine Portweiterleitung oder Docker-Zuordnung nur für TCP gilt; füge also UDP auf demselben Port hinzu. Ein Betreiber hat Door 83 auf einer Konsole mit 26.60 behoben, indem er UDP reparierte, während TCP bereits funktionierte.11
Steht Geyser hinter einem Router oder NAT und Door tritt weiter auf, empfiehlt GeyserMC, deine öffentliche IP zu bedrock.signaling.advertise-addresses hinzuzufügen und neu zu starten.4 Ergänze dafür den bestehenden Abschnitt bedrock: und ersetze 203.0.113.10 durch die öffentliche IP deines Servers:
bedrock:
signaling:
advertise-addresses:
- "203.0.113.10"Geyser-Warnungen nach 26.60 und was sie bedeuten
Geyser gibt diese Meldungen beim Start aus. Die Builds 1273 bis 1279 schicken Operatoren beim Beitritt außerdem eine Nachricht zu NetherNet.69
Warnungen in der Geyser-Konsole
WARNING! NetherNet support is NOT enabled.
Die Builds 1273 bis 1279 geben das aus, wenn in der Konfiguration noch
raknetsteht. Aktualisiere Geyser oder setzetransport: nethernetund starte neu.WARNING! Raknet-only transport has now been REMOVED.
Build 1280 oder neuer hat die Konfiguration auf NetherNet umgestellt. Öffne den Port neben UDP auch für TCP.
NetherNet will not start! Could not load its WebRTC native library
Builds vor 1280 geben stattdessen
NetherNet is not available on Linux (amd64)aus. Geyser konnte seine NetherNet-Bibliothek nicht laden. Gemeldete Ursachen sind ein fehlendeslibcrypto.so.3(unter Ubuntulibssl3installieren) und ein schreibgeschütztes/tmp.1211
Builds vor 1280 hängen an die letzte Warnung den Rat an, transport auf raknet zu setzen. Ignoriere ihn: Laut GeyserMC verbindet sich Bedrock 26.60 überhaupt nicht mehr über RakNet.2
Getestet: Was jedes fehlerhafte Setup mit einem Beitritt macht
Wir haben am 1. November 2026 fünf Setups mit Paper 26.3, Geyser 2.12.1 und einem NetherNet-Testclient geprüft, der auf gophertunnel aufbaut, einer Open-Source-Bibliothek für Bedrock.8
| Geyser | Setup | Ergebnis beim Beitritt |
|---|---|---|
| 1279 | transport: raknet | Sofort über TCP abgelehnt |
| 1279 | transport: nethernet | Login erreicht Geyser |
| 1280 | transport: raknet | Auf NetherNet umgestellt; Login erreicht Geyser |
| 1280 | TCP 19132 geschlossen | Sofort über TCP abgelehnt |
| 1280 | UDP 19132 verworfen | Signaling funktioniert; Timeout nach 30 s |
Der Testclient meldet den Schritt, an dem jeder Beitritt abbrach. Berichte von außen passen zum funktionierenden Setup: Ein Betreiber verbindet sich von Bedrock 26.60 unter Windows über NetherNet,13 und die Server-Images von groundsgg haben Beitritte mit 26.60 durch Build 1280 und TCP plus UDP 19132 wiederhergestellt.14
Fragen zu NetherNet- und Terracotta-Fehlern
Wie behebe ich den NetherNet-Fehler als Spieler?
Prüfe die Serveradresse und deine Spielversion. Schick dem Betreiber den vollständigen Bildschirm Details anzeigen, dein Gerät, deine Spielversion und ob andere Spieler beitreten können. Die Codes 13 und 122 bedeuten, dass die Verbindung fehlgeschlagen ist oder geschlossen wurde; mit den Details kann der Betreiber die Server-Logs prüfen.
Warum erscheint mein Geyser-Server unter 26.60 nicht bei den LAN-Spielen?
Bedrock 26.60 sucht LAN-Welten auf UDP-Port 7551, wo Geyser noch nicht antwortet, laut einem Bericht, der am 10. November 2026 im Issue-Tracker von Geyser noch offen war.13 Füge den Server stattdessen unter „Server“ über seine Adresse hinzu.
Footnotes
minecraft.wiki, Bedrock Edition 26.60: erschienen am 27. Oktober 2026, Protokoll 2225. Geprüft am 1. November 2026. ↩
GeyserMC, Preparing Your Geyser Server for NetherNet, 8. Oktober 2026: „Bedrock clients will stop connecting over RakNet.“ ↩ ↩
GeyserMC, Port forwarding: „players find the server over TCP (signaling), and play on it over UDP.“ Geprüft am 1. November 2026. ↩ ↩ ↩
GeyserMC/Geyser Issue #6807, geschlossen: Mit dem Alpine-Image „shows
InitialConnection-122(NetherNetDataChannelClosed) after 30 s“; behoben in Build 1273. ↩GeyserMC, Build-Liste von Geyser 2.12.1: Build 1273, 26. Oktober 2026, „Support 26.60“, „Surgically remove 26.30“ und „Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet“; Build 1291, 6. November, „Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support“; Build 1298, 9. November, „Indicate Minecraft: Bedrock Edition 26.63 Support“. Geprüft am 10. November 2026. ↩ ↩ ↩
GeyserMC, Geyser-Einrichtungsanleitung: „Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.“ Geprüft am 1. November 2026. ↩ ↩
Pixly-Test, 1. November 2026: Paper 26.3 und Geyser-Spigot 2.12.1, Builds 1279 und 1280, in Docker, verbunden von einem NetherNet-Client auf Basis von gophertunnel im selben Netzwerk; Ports wurden mit Firewall-Regeln im Container des Servers geschlossen. Build 1279 erzeugte eine neue Konfiguration mit
transport: nethernet, behielt ein vorhandenestransport: raknetbei und protokollierteWARNING! NetherNet support is NOT enabled.↩ ↩ ↩GeyserMC, Remove RakNet-only transport (#6843), Build 1280, 31. Oktober 2026 (UTC): stellt einen
raknet-Transport aufnethernetum, entfernt die Start- und BeitrittsmeldungenWARNING! NetherNet support is NOT enabled.und ersetzt die Linux-Meldung durch „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“. Geprüft am 10. November 2026. ↩
spruyt-labs, run NetherNet transport for Bedrock 26.60 clients, geschlossen am 28. Oktober 2026: „The first console test failed with
initialconnection 83. TCP signaling worked“, danach wurde UDP behoben und „A console on Minecraft 26.60 reaches the server list and joins“; der Start war zuvor mit „/tmp/datachannel-java-...: Read-only file system“ fehlgeschlagen. ↩ ↩GeyserMC/Geyser Issue #6852, „NETHERNET: Terracotta error“, 31. Oktober 2026: Das Log zeigt
libcrypto.so.3: cannot open shared object file, und ein Geyser-Mitwirkender antwortet „Installing libssl3 should resolve your issue.“ ↩GeyserMC/Geyser Issue #6853, 31. Oktober 2026, am 10. November noch offen: „Joining by address from the Servers tab works fine over NetherNet“ auf Bedrock 26.60 für Windows mit Geyser 2.12.1-b1279, während der LAN-Broadcast des Clients an UDP 7551 keine Antwort bekommt, weil „Nothing listens on UDP 7551“. ↩ ↩
groundsgg, fix(geyser): restore Bedrock 26.60 connections, gemergt am 1. November 2026: pinnt Geyser 2.12.1 Build 1280 und öffnet TCP und UDP 19132. ↩
GeyserMC, Supported versions: „Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3.“ Geprüft am 10. November 2026. ↩