Minecraft Connection Lost : erreur Internal Exception io.netty

En bref : « Internal Exception: io.netty… » vient de la couche réseau de Minecraft, la bibliothèque Netty : une erreur s'est produite en lisant ou en envoyant un paquet de données, et la connexion a été coupée. Cela peut se passer dans votre client ou sur le serveur, qui vous envoie alors l'erreur comme motif de déconnexion. Ce qui compte, c'est la partie après les deux-points : elle indique quel paquet est en cause et ce qui a échoué. Les causes les plus fréquentes sont des versions différentes, un proxy ou un plugin qui modifie les paquets, des mods qui ne correspondent pas et une connexion instable.

Votre propre serveur Minecraft ? Chez HostValues à partir de €2,80 par mois, en ligne en quelques minutes. Voir les offres →

Ce que signifie le message

Minecraft Java transmet tout ce qui se passe entre le client et le serveur sous forme de paquets, sur une connexion TCP. Quand le client ne parvient pas à traiter un paquet, il coupe la connexion et affiche la raison. L'endroit où vous voyez le message dépend du moment :

• En rejoignant le serveur : l'écran s'intitule « Failed to connect to the server », avec en dessous « Internal Exception: … ».
• En jeu : l'écran s'intitule « Connection Lost ». En cas d'erreur de protocole, le client enregistre aussi un rapport dans le dossier debug de votre dossier de jeu (fichier disconnect-…-client.txt) ; le bouton « Open Report Directory » ouvre ce dossier.
• « Network Protocol Error » : ce message apparaît quand le client a pu lire un paquet reçu, mais pas le traiter.

io.netty.handler.codec.DecoderException signifie qu'un paquet entrant n'a pas pu être lu. EncoderException est l'équivalent à l'envoi. Quand le message contient Failed to decode packet '…', Minecraft donne aussi le nom du paquet, par exemple clientbound/minecraft:login_finished. Ce nom indique le sens : clientbound est un paquet du serveur vers le client que votre client n'a pas pu lire ; serverbound un paquet de votre client que le serveur n'a pas pu lire. Dans ce second cas, l'erreur figure aussi dans le log du serveur.

Les variantes les plus fréquentes

Ce que les joueurs peuvent vérifier

1. La même version que le serveur. Un client dans une autre version de Minecraft ne peut rejoindre le serveur que si celui-ci utilise ViaVersion (clients plus récents) ou ViaVersion avec ViaBackwards (clients plus anciens). Si la version ne correspond pas et que ces plugins manquent, le serveur répond le plus souvent « Incompatible client! Please use … ».
2. Tester sans mods. Lancez un profil sans mods pour tester. Avec un modpack, la version du pack doit être exactement celle du serveur ; un mod manquant ou dans une autre version provoque souvent Failed to decode packet.
3. Tester un autre serveur. Si l'erreur apparaît partout, la cause est plutôt de votre côté : réseau, VPN, pare-feu ou mods.
4. Stabiliser la connexion. Coupez le VPN, redémarrez la box, passez en câble plutôt qu'en Wi-Fi. Cela aide surtout contre Timed out et Connection reset.
5. Transmettre le rapport. Envoyez à l'administrateur du serveur le message complet, l'heure et, s'il existe, le fichier du dossier debug. Plus de détails se trouvent dans logs/latest.log de votre dossier de jeu.

Ce que les administrateurs peuvent vérifier

1. Le log du serveur à la même heure. S'il contient une erreur avec le nom d'un plugin ou d'un mod, vous tenez souvent le coupable.
2. Tout ce qui touche aux versions, à jour. Le logiciel serveur, ViaVersion et ViaBackwards et, le cas échéant, le proxy (Velocity ou BungeeCord) doivent prendre en charge la version du client. Après une nouvelle version de Minecraft, ce sont justement ces éléments qui ont souvent besoin d'une mise à jour.
3. Les plugins qui interviennent dans le trafic réseau. Les bibliothèques de paquets comme ProtocolLib ou PacketEvents, et les plugins qui s'appuient dessus, modifient des paquets. Si l'un d'eux n'est pas prévu pour la version du client, il écrit des paquets que le client ne peut pas lire. Retirez les plugins suspects un par un, à titre de test, jusqu'à ce que l'erreur disparaisse.
4. Sur un serveur moddé, comparer les listes de mods. Le client et le serveur ont besoin des mêmes mods dans les mêmes versions.
5. Cerner les données trop volumineuses. Si Tried to read NBT tag that was too big n'apparaît qu'à un endroit précis, par exemple près d'un coffre ou dans un chunk donné, un objet ou un bloc y contient probablement trop de données enregistrées.
6. En cas de timeout, vérifier la charge du serveur. Le serveur envoie régulièrement des paquets keep-alive. Si le client ne répond pas pendant 15 secondes, le serveur le déconnecte avec « Timed out » ; si c'est le serveur qui se fige, c'est le client qui coupe. Si la console affiche Can't keep up! Is the server overloaded?, le serveur est surchargé : notre article sur le lag d'un serveur Minecraft explique comment le voir au MSPT. Derrière un proxy Velocity avec de gros modpacks Forge, la documentation de Velocity conseille d'augmenter read-timeout dans velocity.toml et de lancer le serveur Forge avec un -Dfml.readTimeout correspondant.

Cas particulier : DecoderException sur login_finished

Le message complet est Internal Exception: io.netty.handler.codec.DecoderException: Failed to decode packet 'clientbound/minecraft:login_finished'. login_finished est le paquet « Login Success » : à la fin de la connexion, le serveur y confirme votre profil de joueur, c'est-à-dire le pseudo, l'UUID et des données de profil comme le skin. Vient ensuite la phase de configuration. Si le client ne peut pas lire ce paquet, la connexion échoue avant même que vous voyiez le monde.

Deux causes sont documentées :

• Un proxy ou un plugin qui intervient dans la connexion ne correspond pas à la version du client. Dans un cas signalé sur GitHub (Velocity, issue 1858), des clients 26.2 natifs échouaient avec exactement ce message ; la cause était le plugin AntiPopup, pas Velocity lui-même. Dans un autre cas (ViaVersion, issue 4943), une version de développement de ViaVersion cassait la connexion des clients 1.20.x ; la version précédente fonctionnait.
• Le profil dépasse les limites du protocole. Le pseudo ne peut pas dépasser 16 caractères et le profil ne peut pas contenir plus de 16 propriétés. Si un proxy ou un plugin en envoie davantage, par exemple un pseudo trop long, le client ne peut pas lire le paquet.

La solution : mettez à jour le proxy, ViaVersion, ViaBackwards et tous les plugins qui modifient la connexion, les pseudos ou les skins. Si cela ne suffit pas, retirez ces plugins un par un pour tester. Si l'erreur ne touche que les joueurs d'une certaine version de Minecraft, vous savez quel élément ne prend pas encore cette version en charge.

Quand ce n'est pas une erreur io.netty

« Connection timed out » au moment de se connecter est un autre cas : votre client n'atteint même pas le serveur, par exemple à cause d'une mauvaise adresse, d'un mauvais port ou d'un serveur arrêté. Notre article Connection timed out : résoudre l'erreur traite ce cas.

Chez HostValues

Sur un serveur Minecraft HostValues, vous voyez la console et le log du serveur directement dans le panel de jeu : vous y trouvez l'heure de l'erreur et les éventuels messages de plugins. Vous changez de version et de logiciel serveur dans l'onglet Versions. Si vous êtes bloqué, envoyez-nous dans un ticket de support le message complet, l'heure et, s'il existe, le rapport du dossier debug.

Questions fréquentes

Que signifie « Internal Exception: io.netty.handler.codec.DecoderException » ?

Un paquet de données n'a pas pu être lu, et la connexion a donc été coupée. Si le nom du paquet contient clientbound, c'est votre client ; avec serverbound, c'est le serveur. Le plus souvent, les versions, les mods ou un proxy ou plugin ne correspondent pas.

« Connection Lost » vient-il de ma connexion Internet ?

Parfois. Avec Timed out, Connection reset ou « forcibly closed », la connexion est souvent en cause. Avec DecoderException et Failed to decode packet, ce sont presque toujours les versions, les mods ou les plugins.

Qu'est-ce que login_finished ?

C'est le paquet « Login Success » par lequel le serveur confirme votre profil de joueur à la fin de la connexion. Une erreur à ce moment vient le plus souvent d'un proxy ou d'un plugin qui modifie la connexion et ne prend pas en charge votre version de Minecraft.

Où trouver le rapport d'erreur ?

Dans le dossier debug de votre dossier de jeu Minecraft, dans un fichier disconnect-…-client.txt. Le bouton « Open Report Directory » de l'écran d'erreur l'ouvre directement. Le log général se trouve dans logs/latest.log.

Sources : textes et messages du client Minecraft 26.3 ; Minecraft Wiki, Java Edition protocol: Packets et Data types ; API Netty : DecoderException ; documentation de Velocity (FAQ, Configuration) ; issues GitHub PaperMC/Velocity #1858 et ViaVersion #4943. Consultés le 14 octobre 2026.