Lorsque votre serveur ne démarre pas, crash, ou se comporte bizarrement, le fichier latest.log est la première chose à vérifier.
Ce guide liste les erreurs les plus fréquentes et leurs solutions simples, même si vous débutez.
Où trouver les logs ?
Depuis le panel du serveur, créez un accès FTP, puis rendez-vous dans le dossier /minecraft/logs/ et téléchargez le fichier latest.log
Crash Reports : Si le serveur crash, un fichier est généré dans /minecraft/crash-reports/
Le fichier latest.log contient toutes les informations utiles au démarrage du serveur. C'est la clé pour comprendre les erreurs.
Erreurs Fréquentes et Solutions
1. Mauvaise version de Forge / Fabric / NeoForge
Log :
Mod File 'examplemod.jar' requires Minecraft 1.20.1 and modloader Forge 47.x
Solution :
- Vérifier la version sélectionnée dans le panel
- Faire une demande sur Discord ou par ticket si la version est absente
2. Dépendance manquante
Log :
Mod [examplemod] requires [cloth-config] to be installed.
Solution :
- Ajouter le mod requis dans /mods via FTP
3. Le serveur "freeze" - Tick trop long / Watchdog
Log : [Server Watchdog/FATAL]: A single server tick took 60.00 seconds (should be max 0.05)
Solution :
- Modifier le fichier server.properties :
max-tick-time=-1
- Cette erreur est liée à un tick serveur trop long, mettre la valeur à -1 permet de désactiver l’autocrash du serveur quand le tick est trop long
- Vérifier qu’une usine ne produit pas trop d’entités qui restent au sol
- Vérifier dans le crash report qu’une entitée n’est pas responsable du crash voir le champ Entity
4. Mod incompatible ou cassé
Log :
Exception in thread "main" java.lang.NoClassDefFoundError
Solution :
- Supprimer le mod concerné
- Vérifier la compatibilité version/modloader
5. Mod client installé sur le serveur
Log :
Mod [xxxxxxx] is marked as client-side only
Solution :
- Supprimer du dossier /mods du serveur
Mods client à éviter sur serveur :
- OptiFine, Sodium, Iris, BetterF3, ReplayMod, Xaero’s Minimap, Inventory HUD, etc.
6. Crash graphique (Blaze3D) - client ou serveur
Client :
Blaze3D error: Invalid framebuffer operation
- Problèmes de shaders ou pilotes obsolètes
- Désactiver les shaders, mettre à jour les pilotes
Serveur :
Exception caught during firing event: net.minecraft.client.gui.screen.Screen
- Un mod client qui modifie l’interface a été mis sur le serveur
- Supprimer tous les mods client side
Astuces rapides
- Recherchez dans le log : ERROR, Exception, client, missing, tick took
- Utilisez https://mclo.gs pour partager les logs
Besoin d'aide ?
Vous pouvez ouvrir un ticket au support depuis le panel ou rejoignez notre Discord pour obtenir de l’aide avec le fichier latest.log
