RealisticNode Docs
Dépannage

Lire les logs et les rapports de crash

Trouvez et lisez les logs et rapports de crash de votre serveur Minecraft sur RealisticNode, comprenez les erreurs Java et trouvez le plugin ou mod fautif.

Quand quelque chose ne va pas, votre serveur écrit presque toujours pourquoi. Ce guide vous montre où trouver ces informations et comment les lire, même si vous n’avez jamais vu d’erreur Java.

Où trouver les logs

Ouvrez Files dans le panel. Voici les fichiers et dossiers importants :

Fichier ou dossierContenu
logs/latest.logTout ce que le serveur a affiché depuis son dernier démarrage. C’est le premier fichier à consulter.
logs/*.log.gzLes anciens logs, un par jour ou par démarrage (par exemple 2026-10-24-1.log.gz). Ils sont compressés.
crash-reports/Un fichier .txt par crash, nommé avec la date et l’heure. Ouvrez le plus récent.
logs/debug.logForge et NeoForge uniquement. Beaucoup plus détaillé que latest.log, utile quand un mod ne se charge pas.
hs_err_pid*.logDans le dossier principal. Créé quand Java lui-même plante (rare).

latest.log est remplacé à chaque démarrage. Si le problème est survenu avant un redémarrage, regardez plutôt dans le fichier .log.gz le plus récent.

Ouvrir un ancien log

Les anciens logs se terminent par .gz, vous ne pouvez donc pas les ouvrir directement dans le navigateur. Vous pouvez :

  • Faire un clic droit sur le fichier et choisir Unarchive (décompresser) : le fichier .log lisible apparaît dans le même dossier. Cliquez dessus pour le lire.
  • Ou choisir Download et l’ouvrir sur votre ordinateur avec 7-Zip (Windows) ou l’Utilitaire d’archive (Mac).

Les fichiers de plus de 4 Mo ne peuvent pas être ouverts dans l’éditeur du navigateur : téléchargez-les ou utilisez le SFTP.

Utiliser la console

La Console affiche la même sortie que latest.log, en temps réel.

  • Cliquez sur Error ou Warning au-dessus de la sortie pour masquer tout le reste. C’est le moyen le plus rapide de repérer les problèmes dans un long démarrage.
  • Appuyez sur Ctrl + F dans la sortie pour chercher un mot, comme le nom d’un plugin.
  • Cliquez sur l’icône Share Logs pour envoyer les 500 dernières lignes sur mclo.gs. Le lien est copié pour vous, prêt à être envoyé à notre équipe. mclo.gs met aussi en évidence les erreurs et donne des pistes.

Les logs partagés sont publics

Toute personne qui a le lien peut lire le log. Vérifiez qu’il n’affiche pas de mots de passe, d’informations de base de données, de tokens d’API ou d’adresses IP que vous voulez garder privés.

Comment lire une erreur

Les erreurs Java font peur, mais vous n’avez besoin que de quelques lignes. Voici un exemple typique :

logs/latest.log
[12:04:31 ERROR]: Error occurred while enabling ShopPlus v2.3 (Is it up to date?)
java.lang.IllegalStateException: Could not load the shop list
    at com.example.shopplus.config.ShopConfig.load(ShopConfig.java:42)
    at com.example.shopplus.ShopPlus.onEnable(ShopPlus.java:18)
    at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:288)
    ...
Caused by: java.io.FileNotFoundException: plugins/ShopPlus/shops.yml (No such file or directory)
    at java.io.FileInputStream.open0(Native Method)
    ...

Lire la première ligne

Elle indique souvent directement ce qui a échoué : ici, le plugin ShopPlus n’a pas pu démarrer.

Trouver les lignes "Caused by"

Une longue erreur peut contenir plusieurs lignes Caused by:. La dernière est généralement la vraie raison. Ici, un fichier est manquant.

Regarder les noms de packages

Les lignes at ... montrent où l’erreur s’est produite. Ignorez celles qui commencent par java., net.minecraft., org.bukkit., io.papermc. ou net.minecraftforge. (c’est le jeu et le logiciel du serveur). Le premier autre nom, comme com.example.shopplus, désigne le plugin ou le mod responsable.

Rechercher l’erreur

Copiez la ligne d’erreur (sans l’heure) et recherchez-la avec le nom du plugin ou du mod. Souvent, quelqu’un a déjà eu le même problème. Vérifiez aussi sur la page du plugin ou du mod s’il existe une version plus récente.

Lire un rapport de crash

Les rapports de crash du dossier crash-reports/ suivent le même principe. Regardez :

  • Description : un court résumé comme Ticking entity ou Exception in server tick loop.
  • L’erreur et ses lignes Caused by, juste en dessous.
  • Les sections comme -- Entity being ticked -- ou -- Block entity being ticked -- : elles indiquent le type et l’emplacement de ce qui a planté.
  • Sur Forge et NeoForge, certains rapports listent des Suspected Mods (mods suspects). C’est un bon indice, mais pas toujours juste.

La page Erreurs courantes explique les messages que vous verrez le plus souvent.

Trouver un plugin ou mod cassé par moitiés

Si les logs ne désignent aucun coupable, testez la moitié de vos plugins ou mods à la fois. Avec 40 mods, vous trouvez le fautif en environ 6 redémarrages.

Faites d’abord une sauvegarde

Créez une sauvegarde avant de retirer quoi que ce soit. Certains mods suppriment leurs blocs et objets du monde quand ils sont absents.

Retirer la moitié

Arrêtez le serveur. Dans Files, créez un dossier nommé disabled dans le dossier principal et déplacez avec Move la moitié des fichiers .jar de plugins (ou mods) dedans.

Tester

Démarrez le serveur. Si le problème a disparu, le coupable est dans le dossier disabled. S’il est toujours là, il est dans la moitié restée en place.

Recommencer

Continuez à diviser le groupe suspect en deux jusqu’à ce qu’il ne reste qu’un seul fichier. Ensuite, mettez-le à jour, cherchez une alternative ou signalez le bug à son auteur, puis remettez les autres fichiers à leur place.

Gardez les bibliothèques avec les mods qui en ont besoin (par exemple Fabric API, Architectury ou Cloth Config). Sinon, vous aurez des erreurs de "dépendance manquante" qui cachent le vrai problème.

Besoin d’aide ?

Cliquez sur Share Logs dans la console, ou envoyez le rapport de crash sur mclo.gs, puis envoyez le lien à notre équipe sur Discord avec votre Server ID et ce qui a changé avant que le problème n’apparaisse.

Sur cette page