Espace clientRésoudre les timeouts sur un serveur Minecraft moddé
Vos joueurs sont renvoyés au menu avec « Timed out » ou « Read timed out » avant d'entrer sur votre serveur Minecraft moddé ? Ce guide explique comment résoudre ce time out Minecraft en allongeant le timeout du serveur et du client, sur Forge, NeoForge et Fabric. Il montre aussi où modifier la commande de démarrage dans OuiPanel, le panel de jeu de OuiHeberg.
Comprendre les timeouts
Le problème des déconnexions
Les coupures liées aux délais d'attente sont l'un des obstacles les plus fréquents sur les serveurs Minecraft qui font tourner de gros modpacks. Le scénario classique : vous lancez le jeu, vous tentez de rejoindre le serveur, puis après une longue attente, le jeu vous renvoie au menu principal avec une erreur de délai dépassé.
Le problème vient en général du temps nécessaire pour charger les nombreux mods et se synchroniser avec le serveur. Quelques réglages ou un mod adapté suffisent le plus souvent à retrouver une connexion stable.
Le mécanisme des délais d'attente
Minecraft laisse environ une demi-minute aux opérations critiques : initialisation des mods, établissement de la connexion au serveur, transfert des données de synchronisation. Ce délai suffit pour une installation vanilla. Il devient vite trop court dès que des mods entrent en jeu.
Origines du problème
Facteurs déclencheurs
Les timeouts sont plus fréquents dans ces situations.
| Situation | Impact |
|---|---|
| Modpack volumineux (plus de 100 mods) | Très élevé |
| Connexion réseau instable ou lente | Élevé |
| Machine aux ressources limitées (RAM, CPU) | Élevé |
| Mods qui demandent un traitement intensif | Modéré |
| Serveur saturé ou mal configuré | Modéré |
Diagnostic rapide
Le message d'erreur affiché indique la source du problème.
| Message | Cause probable |
|---|---|
Timed out ou Read timed out | Délai d'attente dépassé |
Connection lost | Réseau instable ou délai dépassé |
| Crash avec une trace d'erreur complète (stacktrace) | Conflit de mods ou incompatibilité |
Missing mod | Mod absent côté client ou côté serveur, installation incomplète |
Solutions par modloader
La correction dépend du chargeur de mods. Forge et NeoForge acceptent des arguments JVM ou un mod spécialisé. Fabric passe par un mod dédié.
Arguments JVM pour Forge et NeoForge
C'est la méthode recommandée. Elle allonge le délai d'attente d'une demi-minute à deux minutes, en ajoutant ces arguments à la commande de lancement.
-Dfml.readTimeout=120 -Dfml.loginTimeout=120
Ces paramètres laissent plus de temps à Forge et NeoForge pendant le chargement et l'authentification. Les coupures deviennent bien plus rares avec les gros modpacks. La valeur s'exprime en secondes.
Les arguments doivent se placer entre java et -jar pour être lus par la JVM.
# Structure correcte
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
# Position erronée (ne fonctionnera pas)
java -Xms4G -Xmx8G -jar server.jar -Dfml.readTimeout=120 nogui
Allonger ces délais ne dégrade pas les performances. Ils fixent seulement l'attente maximale avant de considérer une opération comme échouée, sans effet sur le processeur, la mémoire ou la bande passante.
Les arguments
-Dfml.readTimeoutet-Dfml.loginTimeoutne sont reconnus que par Forge et NeoForge. Une installation vanilla les ignore. En vanilla, les timeouts sont rares et viennent en général du réseau.
Mod TimeoutFixes pour Forge et NeoForge
Pour éviter toute manipulation technique, installez le mod TimeoutFixes. Il est compatible avec Forge et NeoForge et règle les délais tout seul. Il s'installe sur le serveur et sur le client.
Mod TimeOutOut pour Fabric
Fabric a sa propre solution, sans argument JVM à modifier. Le mod TimeOutOut augmente les délais de connexion pour éviter les déconnexions pendant l'initialisation des mods. Il est conçu pour Fabric, ses délais se règlent librement et il doit être installé côté client et côté serveur en multijoueur.
Un mod de gestion des timeouts installé d'un seul côté peut provoquer des comportements imprévisibles. Sur votre serveur OuiHeberg, ajoutez-le depuis le Mods Manager ou déposez son fichier .jar dans le dossier mods. Le guide Comment installer des mods sur votre serveur Minecraft (Forge/Fabric) détaille les deux méthodes.
Configuration serveur
Dans OuiPanel
Connectez-vous à OuiPanel sur dash.ouipanel.com et ouvrez votre serveur.
Ouvrez Configuration › Paramètres du serveur.
Dans la carte Lancement du serveur, cliquez sur Modifier la commande de démarrage.
Dans la fenêtre « Modification de la commande de démarrage », ajoutez
-Dfml.readTimeout=120 -Dfml.loginTimeout=120juste aprèsjava, avant-jar.Cliquez sur Enregistrer.
Dans la Console, cliquez sur Redémarrer, puis vérifiez le journal de démarrage.
Par exemple, une commande de cette forme :
java -Xms4G -Xmx8G -jar server.jar nogui
devient :
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
Une commande de démarrage mal modifiée peut empêcher le serveur de démarrer. Copiez la commande d'origine avant d'y toucher, pour pouvoir la remettre.
Sur l'offre Minecraft gratuite, la commande de démarrage n'est pas modifiable. Le panel affiche alors « Commande de démarrage modifiable sur une offre premium ».
Sur votre propre machine
Si vous administrez votre propre serveur, créez un script de démarrage dédié.
Linux (start.sh) :
#!/bin/bash
java -Dfml.readTimeout=120 \
-Dfml.loginTimeout=120 \
-Xms4G \
-Xmx8G \
-XX:+UseG1GC \
-XX:+ParallelRefProcEnabled \
-XX:MaxGCPauseMillis=200 \
-jar server.jar nogui
Windows (start.bat) :
@echo off
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
pause
Dans tous les cas, enregistrez la configuration, redémarrez complètement le serveur, puis vérifiez dans les logs que les paramètres sont pris en compte.
Configuration client
Les joueurs peuvent aussi allonger le délai de leur côté, dans leur launcher.
Launcher officiel Minecraft
Ouvrez le launcher Minecraft et allez dans l'onglet Installations.
Sélectionnez le profil de votre modpack.
Cliquez sur Plus d'options pour afficher les paramètres avancés.
Dans le champ Arguments JVM, complétez les paramètres existants comme ci-dessous.
Cliquez sur Enregistrer, puis lancez le jeu avec ce profil.
-Xms4G -Xmx8G -Dfml.readTimeout=120 -Dfml.loginTimeout=120
CurseForge
Ouvrez les Paramètres de l'application.
Sélectionnez la section Minecraft.
Dans le champ Arguments Java additionnels, ajoutez
-Dfml.readTimeout=120 -Dfml.loginTimeout=120.
Prism Launcher et MultiMC
Faites un clic droit sur l'instance concernée.
Choisissez Modifier (ou Edit Instance).
Ouvrez l'onglet Paramètres, puis Java.
Saisissez les arguments dans le champ prévu.
ATLauncher
Ouvrez les Settings (paramètres).
Ouvrez l'onglet Java/Minecraft.
Ajoutez les arguments dans Extra JVM Arguments.
GDLauncher
Cliquez sur l'icône des paramètres (engrenage).
Sélectionnez Java.
Remplissez le champ Additional Arguments.
Diagnostic et résolution avancée
Vérifier que les paramètres sont appliqués
Examinez les logs de démarrage du serveur. Dans OuiPanel, ouvrez logs/latest.log depuis le Gestionnaire de fichiers, ou suivez la Console. Sur votre propre machine, cette commande cherche les lignes utiles.
# Rechercher dans les logs
grep -i "timeout" logs/latest.log
Bon signe : plus aucun message « Timed out » à la connexion des joueurs, et des connexions plus longues mais réussies.
Ajuster les valeurs par paliers
Commencez à 120, soit deux minutes, ce qui convient à la plupart des configurations. Si les déconnexions continuent, montez par paliers de 60, soit une minute de plus à chaque fois.
| Niveau | Valeur | Cas d'usage |
|---|---|---|
| Standard | 120 (2 minutes) | Modpacks classiques (50 à 100 mods) |
| Étendu | 180 (3 minutes) | Gros modpacks (100 à 200 mods) |
| Maximum | 240 (4 minutes) | Modpacks massifs (plus de 200 mods) |
| Extrême | 300 (5 minutes) | Configurations très lentes |
Exemple avec le délai étendu :
-Dfml.readTimeout=180 -Dfml.loginTimeout=180
Au-delà de 300, soit cinq minutes, le problème tient plutôt au modpack ou aux ressources matérielles qu'au délai d'attente. Optimisez le modpack plutôt que d'allonger encore.
Lire les messages d'erreur
| Message | Signification | Solution |
|---|---|---|
io.netty.handler.timeout.ReadTimeoutException | Délai de lecture dépassé | Augmenter readTimeout |
Login timed out | Authentification trop lente | Augmenter loginTimeout |
Connection reset | Connexion interrompue | Vérifier la stabilité du réseau |
Internal Exception | Erreur interne | Consulter la trace d'erreur complète |
Si le problème persiste
Vérifiez dans les logs que les paramètres sont bien appliqués.
Testez votre connexion réseau (ping, stabilité).
Retirez des mods temporairement pour trouver celui qui pose problème.
Augmentez les ressources allouées, la RAM en particulier.
Mettez tous vos mods à jour vers leur dernière version.
Optimisations complémentaires
Mods de performance
Allonger les délais n'est parfois qu'un palliatif. Pour traiter le problème à la source, installez des mods d'optimisation.
| Mod | Effet | Chargeurs |
|---|---|---|
| ModernFix | Optimise la gestion de la mémoire et accélère le chargement des ressources. Réduit nettement le temps de démarrage. | Forge, NeoForge, Fabric |
| FerriteCore | Réduit fortement la consommation de RAM sur les grosses installations, jusqu'à 50 % de RAM économisée. | Forge, NeoForge, Fabric |
| LazyDFU | Diffère l'initialisation du DataFixerUpper pour un démarrage plus rapide. | Forge, Fabric |
Stabilisation réseau
Le mod Connectivity optimise le protocole réseau. Il améliore la gestion des connexions et réduit les déconnexions dues à l'instabilité. Il fonctionne avec Forge et NeoForge.
Connectivity ne peut pas cohabiter avec TimeoutFixes. Choisissez l'un ou l'autre selon votre problème principal.
Configuration réseau du serveur
Dans server.properties :
# Augmenter si nécessaire
max-tick-time=120000
network-compression-threshold=256
Dans spigot.yml, si votre serveur en a un :
settings:
timeout-time: 120
restart-on-crash: true
Dans OuiPanel, server.properties se modifie dans Configuration › Éditeur de propriétés, ou en ouvrant le fichier dans le Gestionnaire de fichiers.
Le paramètre
player-idle-timeoutdeserver.propertiesn'a rien à voir avec ces erreurs. Il expulse les joueurs inactifs après le nombre de minutes indiqué, etplayer-idle-timeout=0désactive cette expulsion.
Ressources utiles
Documentation
Outils de diagnostic
Communautés
Besoin d'aide ?
Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.
Découvrez nos offres d'hébergement Minecraft dès 1,99 €/mois avec installation automatique de mods.
Notre hébergeur Minecraft →