Comprendre les logs Minecraft

Les logs Minecraft sont votre meilleure source de vérité quand quelque chose casse. Ils enregistrent ce que le jeu ou le serveur a fait, dans l'ordre, jusqu'au moment de la panne. Ce guide explique quels fichiers de log comptent, comment lire une ligne de log et quoi rechercher.

Les fichiers de log qui comptent

Tout se trouve dans le dossier logs/ (racine du serveur, ou instance/.minecraft sur un client) :

  • latest.log
    Le journal complet de l'exécution en cours. C'est le fichier que vous ouvrez en premier ; l'erreur y est presque toujours.
  • debug.log
    Une version bien plus détaillée de la même exécution. Utilisez-le quand latest.log n'en dit pas assez.
  • Journaux archivés
    Les exécutions plus anciennes sont compressées sous la forme 2026-06-08-1.log.gz. Décompressez-le pour lire une session passée.
  • crash-reports/
    Un dossier séparé contenant un rapport ciblé, écrit uniquement quand le jeu crashe. Voir Comment lire un rapport de crash Minecraft.

Comment lire une ligne de log

Chaque ligne suit le même format :

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    L'horodatage : quand l'événement s'est produit.
  • [Server thread/ERROR]
    Le thread qui l'a journalisé, et le niveau.
  • Le message
    Ce qui s'est réellement passé, souvent suivi d'une trace de la pile s'il s'agit d'une erreur.

Le niveau du journal indique la gravité en un coup d'œil : INFO (normal), WARN (quelque chose ne va pas mais ce n'est pas fatal), ERROR (une véritable défaillance), et FATAL (le serveur s'arrête).

Threads : qui parle

  • Server thread / main
    La boucle de jeu principale. Les erreurs ici affectent généralement le jeu directement (et peuvent faire crasher le serveur).
  • Worker / IO threads
    Le travail en arrière-plan comme les E/S de chunks. Utile pour les problèmes de disque et de sauvegarde du monde.
  • Mod/plugin threads
    Nommé d'après un mod ou un plugin : un indice rapide sur le responsable.

Quoi rechercher

  1. Allez à la première ligne ERROR/FATAL ou Exception ; les erreurs suivantes ne sont souvent que des conséquences.
  2. Lisez la section de démarrage pour repérer les mods/plugins en échec, la mauvaise version de Java ou un EULA non accepté.
  3. Surveillez les répétitions de WARN comme « Can't keep up! » (performance, voir Can't Keep Up) ou « moved too quickly ».
  4. Notez les dernières lignes avant un gel ou un arrêt : elles montrent ce que faisait le serveur au moment de la panne.
  5. Recoupez toute erreur avec la Problèmes courants liste pour la solution exacte.

Logs serveur vs logs client

Ils partagent le même format mais se trouvent à des endroits différents. Un journal de serveur enregistre la sauvegarde du monde, les connexions des joueurs et le chargement des plugins/mods ; un journal de client enregistre le rendu, les packs de ressources et votre propre connexion. Pour résoudre un problème de connexion, comparez les deux : la cause peut n'être que d'un seul côté.

Partager les logs en toute sécurité

Les journaux peuvent contenir l'IP de votre serveur et parfois des jetons, alors ne les collez pas publiquement sans y jeter un œil d'abord. Utilisez un service de collage (comme mclo.gs) pour le partage, ou téléversez le fichier directement dans MCDoctor.ai, qui lit le journal et vous explique la cause et la solution, sans fouille manuelle.

Questions fréquentes

Dans le dossier logs/ à la racine de votre serveur ou dans le dossier instance/.minecraft. La session en cours est latest.log ; les sessions plus anciennes sont des fichiers .log.gz compressés.

Ils couvrent la même session, mais debug.log est bien plus détaillé. Commencez par latest.log et passez à debug.log seulement si vous avez besoin de plus de détails.

WARN signifie qu'un élément est anormal mais pas fatal ; ERROR est une vraie défaillance ; FATAL signifie que le serveur s'arrête. Concentrez-vous sur la première ligne ERROR/FATAL.

Oui, importez latest.log ou un rapport de crash et MCDoctor.ai l'analyse et renvoie la cause probable et la solution recommandée.