pixly.

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.

AlekseiFounder
Mis à jour le 8 min de lecture
Logo GeyserMC au-dessus d'une porte en pierre fermée, des blocs de terre cuite et un câble débranché sur une plateforme d'herbe.

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

CodeDétailsCauseSolution
TerracottaInitialConnection-149Geyser en RakNet, ou port TCP ferméLes quatre étapes ci-dessous
DoorInitialConnection-83UDP bloqué, ou serveur derrière un NATOuvrir l'UDP, définir advertise-addresses
NetherNetInitialConnection-13Aucune réponse via NetherNet ni RakNetVérifier l'adresse et les deux ports
NetherNetInitialConnection-122Connexion ouverte, puis ferméeMettre 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 :

  1. 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
  2. Définissez transport: nethernet dans la configuration de Geyser. Elle se trouve dans plugins/Geyser-Spigot/ sur Paper et dans config/Geyser-Fabric/ ou config/Geyser-NeoForge/ sur Fabric ou NeoForge.7 Jusqu'au build 1279, une ancienne ligne raknet est conservée ; à partir du build 1280, Geyser la modifie pour vous. La seule autre valeur est both, qui accepte aussi RakNet et nécessite un second port UDP.8910
  3. 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
  4. Redémarrez et testez une connexion Bedrock. Built-in signaling started on http://0.0.0.0:19132 confirme 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: nethernet

Un 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éfinissez transport: 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 de libcrypto.so.3 (installez libssl3 sur Ubuntu) et un /tmp en 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

GeyserConfigurationRésultat de la connexion
1279transport: raknetRefusée immédiatement en TCP
1279transport: nethernetLa connexion atteint Geyser
1280transport: raknetBasculée sur NetherNet ; la connexion atteint Geyser
1280TCP 19132 ferméRefusée immédiatement en TCP
1280UDP 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.

Pourquoi les joueurs sur une ancienne version de Bedrock ne peuvent-ils pas se connecter ?

Le build 1273 a retiré Bedrock 26.30, et les builds actuels de Geyser acceptent Bedrock 26.40 à 26.63.615 Les joueurs sur une ancienne version mettent le jeu à jour depuis la boutique de leur appareil.

Footnotes

  1. minecraft.wiki, Bedrock Edition 26.60 : sortie le 27 octobre 2026, protocole 2225. Consulté le 1er novembre 2026. ↩

  2. GeyserMC, Preparing Your Geyser Server for NetherNet, 8 octobre 2026 : « Bedrock clients will stop connecting over RakNet. » ↩ ↩

  3. GeyserMC, Port forwarding : « players find the server over TCP (signaling), and play on it over UDP. » Consulté le 1er novembre 2026. ↩ ↩ ↩

  4. GeyserMC, tags d'assistance pour les codes d'erreur Bedrock, GeyserDiscordBot : InitialConnection-149 correspond à « Terracotta », UnsupportedTransport, et « may also appear if the signaling server is unreachable or not running » ; 83 à « Door », NetherNetICE, « try adding your public IP address to the advertise-addresses config option » ; 13 à « NetherNet », LegacyDisconnect, affiché « if both attempts time out » ; 122 à « NetherNet », NetherNetDataChannelClosed. Consulté le 1er novembre 2026. ↩ ↩ ↩

  5. GeyserMC/Geyser, ticket #6807, fermé : avec l'image Alpine, le client « shows InitialConnection-122 (NetherNetDataChannelClosed) after 30 s » ; corrigé dans le build 1273. ↩

  6. 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. ↩ ↩ ↩

  7. 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. ↩ ↩

  8. 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: nethernet et conservé un transport: raknet existant, en journalisant WARNING! NetherNet support is NOT enabled. ↩ ↩ ↩

  9. GeyserMC, Remove RakNet-only transport (#6843), build 1280, 31 octobre 2026 (UTC) : bascule un transport raknet sur nethernet, supprime les messages de démarrage et de connexion WARNING! NetherNet support is NOT enabled. et remplace le message Linux par « NetherNet will not start! Could not load its WebRTC native library ». ↩ ↩

  10. GeyserMC, GeyserConfig.java : « both » : « accepts NetherNet and RakNet. Each needs its own UDP port ». Consulté le 10 novembre 2026. ↩

  11. 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 ». ↩ ↩

  12. 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. » ↩

  13. 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 ». ↩ ↩

  14. 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. ↩

  15. GeyserMC, Supported versions : « Geyser currently supports Minecraft Bedrock 26.40-26.63 and Minecraft Java 26.3. » Consulté le 10 novembre 2026. ↩

AlekseiFounder at Pixly

Écrit sur l'exploitation de serveurs Minecraft : des chiffres mesurés, des correctifs reproductibles et les compromis que les pages d'hébergeurs passent sous silence.

Continuer la lecture.