Corriger les erreurs NetherNet et Terracotta sur Geyser
Corrigez les erreurs NetherNet et Terracotta sur un serveur Geyser : vérifiez le code InitialConnection, mettez Geyser à jour et testez TCP et UDP.

Pixly prend en charge Bedrock 26.60 depuis le premier jour. Activez le crossplay Bedrock dans les paramètres et redémarrez : Pixly installe et configure Geyser et Floodgate automatiquement. Les joueurs Java et Bedrock se connectent à la même adresse.
Ce que signifient les codes NetherNet, Terracotta et Door
Bedrock 26.60, sorti le 27 octobre 2026, ne rejoint plus les serveurs que via NetherNet.12 Quand une connexion échoue avec une erreur NetherNet, Terracotta ou Door, appuyez sur Afficher les détails pour voir son numéro InitialConnection. Ce numéro vous indique ci-dessous quelles vérifications faire.
Une connexion depuis Bedrock 26.60 commence par le signaling, une requête web en TCP qui trouve le serveur, puis la partie se joue en UDP.3 Les notes d'assistance de GeyserMC associent chaque numéro InitialConnection à une cause :4
| Code | Détails | Cause | Solution |
|---|---|---|---|
| Terracotta | InitialConnection-149 | Geyser en RakNet, ou port TCP fermé | Les quatre étapes ci-dessous |
| Door | InitialConnection-83 | UDP bloqué, ou serveur derrière un NAT | Ouvrir l'UDP, définir advertise-addresses |
| NetherNet | InitialConnection-13 | Aucune réponse via NetherNet ni RakNet | Vérifier l'adresse et les deux ports |
| NetherNet | InitialConnection-122 | Connexion ouverte, puis fermée | Mettre Geyser à jour ; si l'erreur persiste, lire les logs de déconnexion |
Terracotta avec 149 signifie que le serveur ne parle pas NetherNet, ou que son signaling est injoignable.4 Une erreur NetherNet avec 13 signifie que le serveur n'a répondu par aucune des deux voies : vérifiez d'abord l'adresse. Avec 122, la connexion s'est ouverte puis fermée ; les builds de Geyser antérieurs au 1273 le faisaient sous Alpine Linux.5
Corriger l'erreur Terracotta sur un serveur Geyser
Téléchargez Geyser depuis la page de téléchargement de GeyserMC, puis :
- Mettez Geyser à jour vers le dernier build. Le build 1273, du 26 octobre, est le premier à prendre en charge Bedrock 26.60, et les builds suivants ajoutent les versions 26.61 à 26.63.6
- Définissez
transport: nethernetdans la configuration de Geyser. Elle se trouve dansplugins/Geyser-Spigot/sur Paper et dansconfig/Geyser-Fabric/ouconfig/Geyser-NeoForge/sur Fabric ou NeoForge.7 Jusqu'au build 1279, une ancienne ligneraknetest conservée ; à partir du build 1280, Geyser la modifie pour vous. La seule autre valeur estboth, qui accepte aussi RakNet et nécessite un second port UDP.8910 - Ouvrez le port de Geyser en TCP et en UDP. Avec Docker, publiez
-p 19132:19132 -p 19132:19132/udp.3 Ce ne peut pas être le port du serveur Java.7 - Redémarrez et testez une connexion Bedrock.
Built-in signaling started on http://0.0.0.0:19132confirme que le serveur de signaling de Geyser a démarré.8 Connectez-vous depuis l'extérieur de votre réseau pour vérifier que les joueurs passent en TCP et en UDP.3
La section bedrock: de la configuration ressemble alors à ceci :
bedrock:
port: 19132
transport: nethernetUn proxy, Geyser Standalone ou un hébergeur qui n'ouvre que le port Java demandent davantage ; le guide d'installation de Geyser et Floodgate couvre ces cas.
Corriger l'erreur Door : vérifier l'UDP et le NAT
Door avec 83 signifie que le signaling en TCP a fonctionné, mais que le trafic de jeu en UDP n'est pas passé. Une redirection de port ou un mappage Docker limité au TCP en est la cause : ajoutez l'UDP sur le même port. Un propriétaire de serveur a résolu Door 83 sur une console en 26.60 en corrigeant l'UDP, alors que le TCP fonctionnait déjà.11
Si Geyser se trouve derrière un routeur ou un NAT et que Door persiste, GeyserMC conseille d'ajouter votre IP publique à bedrock.signaling.advertise-addresses puis de redémarrer.4 Intégrez ceci à la section bedrock: existante, en remplaçant 203.0.113.10 par l'IP publique de votre serveur :
bedrock:
signaling:
advertise-addresses:
- "203.0.113.10"Avertissements de Geyser après la 26.60 et leur signification
Geyser affiche ces messages au démarrage. Les builds 1273 à 1279 envoient aussi un message sur NetherNet aux opérateurs quand ils se connectent.69
Avertissements de la console Geyser
WARNING! NetherNet support is NOT enabled.
Les builds 1273 à 1279 l'affichent quand la configuration indique encore
raknet. Mettez Geyser à jour, ou définisseztransport: nethernet, puis redémarrez.WARNING! Raknet-only transport has now been REMOVED.
Le build 1280 ou plus récent a basculé la configuration sur NetherNet. Ouvrez le port en TCP en plus de l'UDP.
NetherNet will not start! Could not load its WebRTC native library
Les builds antérieurs au 1280 affichent à la place
NetherNet is not available on Linux (amd64). Geyser n'a pas pu charger sa bibliothèque NetherNet ; les causes signalées sont l'absence delibcrypto.so.3(installezlibssl3sur Ubuntu) et un/tmpen lecture seule.1211
Les builds antérieurs au 1280 ajoutent à ce dernier avertissement le conseil de régler transport sur raknet. Ignorez-le : selon GeyserMC, Bedrock 26.60 ne se connecte plus du tout via RakNet.2
Testé : l'effet de chaque configuration cassée sur une connexion
Le 1er novembre 2026, nous avons testé cinq configurations avec Paper 26.3, Geyser 2.12.1 et un client de test NetherNet basé sur gophertunnel, une bibliothèque Bedrock open source.8
| Geyser | Configuration | Résultat de la connexion |
|---|---|---|
| 1279 | transport: raknet | Refusée immédiatement en TCP |
| 1279 | transport: nethernet | La connexion atteint Geyser |
| 1280 | transport: raknet | Basculée sur NetherNet ; la connexion atteint Geyser |
| 1280 | TCP 19132 fermé | Refusée immédiatement en TCP |
| 1280 | UDP 19132 bloqué | Le signaling fonctionne ; expiration après 30 s |
Le client de test indique l'étape où chaque connexion s'est arrêtée. Les retours extérieurs concordent avec la configuration qui fonctionne : un propriétaire se connecte depuis Bedrock 26.60 sous Windows via NetherNet,13 et les images de serveur de groundsgg ont rétabli les connexions en 26.60 avec le build 1280 et le TCP plus l'UDP 19132.14
Questions sur les erreurs NetherNet et Terracotta
Comment corriger l'erreur NetherNet en tant que joueur ?
Vérifiez l'adresse du serveur et votre version du jeu. Envoyez au propriétaire du serveur l'écran Afficher les détails complet, votre appareil et votre version du jeu, et dites-lui si d'autres joueurs arrivent à se connecter. Les codes 13 et 122 signifient que la connexion a échoué ou s'est fermée ; grâce aux détails, le propriétaire peut consulter les logs du serveur.
Pourquoi mon serveur Geyser n'apparaît-il pas dans les parties LAN en 26.60 ?
Bedrock 26.60 cherche les mondes LAN sur le port UDP 7551, où Geyser ne répond pas encore, d'après un signalement toujours ouvert sur le suivi des tickets de Geyser au 10 novembre 2026.13 Ajoutez plutôt le serveur par son adresse dans l'onglet Serveurs.
Footnotes
minecraft.wiki, Bedrock Edition 26.60 : sortie le 27 octobre 2026, protocole 2225. Consulté le 1er novembre 2026. ↩
GeyserMC, Preparing Your Geyser Server for NetherNet, 8 octobre 2026 : « Bedrock clients will stop connecting over RakNet. » ↩ ↩
GeyserMC, Port forwarding : « players find the server over TCP (signaling), and play on it over UDP. » Consulté le 1er novembre 2026. ↩ ↩ ↩
GeyserMC/Geyser, ticket #6807, fermé : avec l'image Alpine, le client « shows
InitialConnection-122(NetherNetDataChannelClosed) after 30 s » ; corrigé dans le build 1273. ↩GeyserMC, liste des builds de Geyser 2.12.1 : build 1273, 26 octobre 2026, « Support 26.60 », « Surgically remove 26.30 » et « Add operator join message informing NetherNet deprecation, change bedrock.transport config default to nethernet » ; build 1291, 6 novembre, « Indicate Minecraft: Bedrock Edition 26.61 and 26.62 Support » ; build 1298, 9 novembre, « Indicate Minecraft: Bedrock Edition 26.63 Support ». Consulté le 10 novembre 2026. ↩ ↩ ↩
GeyserMC, guide d'installation de Geyser : « Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server. » Consulté le 1er novembre 2026. ↩ ↩
Test Pixly, 1er novembre 2026 : Paper 26.3 et Geyser-Spigot 2.12.1, builds 1279 et 1280, sous Docker, rejoints par un client NetherNet basé sur gophertunnel depuis le même réseau ; ports fermés par des règles de pare-feu dans le conteneur du serveur. Le build 1279 a généré une nouvelle configuration avec
transport: nethernetet conservé untransport: raknetexistant, en journalisantWARNING! NetherNet support is NOT enabled.↩ ↩ ↩GeyserMC, Remove RakNet-only transport (#6843), build 1280, 31 octobre 2026 (UTC) : bascule un transport
raknetsurnethernet, supprime les messages de démarrage et de connexionWARNING! NetherNet support is NOT enabled.et remplace le message Linux par « 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 ». Consulté le 10 novembre 2026. ↩
spruyt-labs, run NetherNet transport for Bedrock 26.60 clients, fermé le 28 octobre 2026 : « The first console test failed with
initialconnection 83. TCP signaling worked », puis l'UDP a été corrigé et « A console on Minecraft 26.60 reaches the server list and joins » ; le démarrage avait échoué avec « /tmp/datachannel-java-...: Read-only file system ». ↩ ↩GeyserMC/Geyser, ticket #6852, « NETHERNET: Terracotta error », 31 octobre 2026 : le log affiche
libcrypto.so.3: cannot open shared object file, et un contributeur de Geyser répond « Installing libssl3 should resolve your issue. » ↩GeyserMC/Geyser, ticket #6853, 31 octobre 2026, toujours ouvert le 10 novembre : « Joining by address from the Servers tab works fine over NetherNet » sur Bedrock 26.60 pour Windows avec Geyser 2.12.1-b1279, tandis que la diffusion LAN du client vers l'UDP 7551 reste sans réponse car « Nothing listens on UDP 7551 ». ↩ ↩
groundsgg, fix(geyser): restore Bedrock 26.60 connections, fusionnée le 1er novembre 2026 : fixe Geyser 2.12.1 build 1280 et ouvre TCP et UDP 19132. ↩
GeyserMC, Supported versions : « Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3. » Consulté le 10 novembre 2026. ↩