Pourquoi mon serveur Minecraft ne démarre-t-il pas ? Lire le crash et le corriger

Lorsqu'un serveur échoue à démarrer, le panneau l'affiche comme Crashed ou Ran out of memory au lieu de rester bloqué sur "Starting". La raison est toujours inscrite dans le journal du serveur — la partie difficile est de savoir où chercher et ce que le message signifie. Ce guide couvre les deux. Presque chaque crash au démarrage provient d'une poignée de causes, et presque toutes peuvent être résolues en supprimant ou en remplaçant un seul fichier.

Où trouver l'erreur

• L'onglet Console affiche le journal du serveur au démarrage, donc un crash lors du lancement y est visible.
• `logs/latest.log` dans l'onglet Files est le même journal sauvegardé sous forme de fichier. Il y reste après l'arrêt du serveur, vous pouvez donc le lire à votre rythme. Les sessions précédentes sont conservées dans le même dossier sous forme de fichiers .log.gz datés.
• Le dossier `crash-reports` dans l'onglet Files. Lorsque Minecraft lui-même plante, il écrit un rapport complet ici, avec une description en langage clair près du haut.

Comment lire une erreur Java

Les crashs de Minecraft s'accompagnent de longues « traces de pile » (stack traces) — des dizaines de lignes commençant par at …. Vous pouvez ignorer la quasi-totalité de ces lignes. Ce dont vous avez besoin est :

1. La première ligne contenant ERROR, Exception ou FATAL lors du démarrage. Les erreurs plus bas sont généralement des conséquences de la première.
2. Toute ligne commençant par `Caused by:` — la dernière d'un bloc est normalement la cause réelle.
3. Tout nom de mod ou de plugin dans ces lignes. L'ID d'un mod (par exemple create ou jei) ou le nom d'un fichier .jar vous indique ce qu'il faut corriger.

Comparez ensuite ce que vous avez trouvé avec les causes ci-dessous.

Manque de mémoire (Ran out of memory)

Messages : java.lang.OutOfMemoryError: Java heap space, ou le statut du panel Ran out of memory.

Le serveur avait besoin de plus que les 3 Go offerts par un serveur gratuit. C'est courant avec les gros modpacks, et on ne peut pas régler cela par des réglages — un pack de 300 mods nécessite simplement plus de mémoire. Retirez les mods que vous n'utilisez pas, choisissez un pack plus léger, ou passez à un serveur payant avec plus de mémoire. Combien de RAM un serveur Minecraft a-t-il besoin ? montre ce qui est compatible.

Un mod côté client sur le serveur

Message : Attempted to load class … for invalid dist DEDICATED_SERVER, mentionnant souvent une classe issue d'un mod de rendu, de shader, de minimap ou de menu.

Certains mods n'ont de sens que sur l'ordinateur d'un joueur — ils modifient les graphismes, le son ou les menus — et ils font planter un serveur qui tente de les charger. Trouvez le mod mentionné près de l'erreur et supprimez son fichier jar du dossier mods. Lorsque vous installez un modpack CurseForge, Cobbly retire déjà les mods client connus et réessaie automatiquement lorsqu'il détecte cette erreur, vous ne rencontrez donc généralement ce problème qu'avec les mods ajoutés manuellement.

Une dépendance manquante

Messages : Missing or unsupported mandatory dependencies, requires … which is missing, ou Unknown dependency.

De nombreux mods et plugins ont besoin d'un autre élément — une bibliothèque — pour fonctionner. L'erreur nomme les deux : le mod qui a échoué et celui dont il a besoin. Installez la pièce manquante en vérifiant qu'elle correspond à votre version de Minecraft. Le cas le plus courant est un mod Fabric sans Fabric API. Sur Paper, il s'agit souvent de Vault ou ProtocolLib.

Un mod ou plugin pour une version différente

Messages : Incompatible mod set, requires minecraft …, Mod … is incompatible with loaded version, Unsupported class file major version, ou has been compiled by a more recent version of the Java Runtime.

Les mods sont conçus pour une version exacte de Minecraft et pour un loader spécifique. Un mod 1.20.1 ne se chargera pas sur '1.21', et un mod Fabric ne se chargera pas sur Forge. Vérifiez le fichier installé par rapport à la version du serveur dans l'onglet Software, et téléchargez la version correspondante. Les messages Java signifient la même chose de manière détournée : Cobbly exécute la version Java requise par votre version de Minecraft, donc un mod demandant une version différente de Java a été conçu pour une autre version de Minecraft.

Deux mods en conflit

Messages : Mixin apply failed, MixinApplyError, ou InvalidInjectionException, nommant généralement deux mods.

Les mods modifient le code de Minecraft, et parfois deux tentent de modifier la même chose de manière incompatible. Si l'erreur mentionne deux mods, supprimez le plus récent et redémarrez. Si vous en avez ajouté plusieurs à la fois, supprimez la moitié, testez, et réduisez le champ de recherche à partir de là. Une mise à jour de l'un ou de l'autre mod résout souvent le problème.

Mods en double

Message : Found duplicate mods ou Duplicate mod ID.

Deux fichiers jar du même mod, souvent deux versions différentes après une mise à jour. Ouvrez le dossier mods et supprimez l'ancienne version.

Un monde ou un fichier de configuration corrompu

Messages : erreurs mentionnant level.dat, Failed to load level, ou une erreur d'analyse (parse error) nommant un fichier sous config/.

Un fichier de configuration avec une faute de frappe, ou un monde qui ne s'est pas sauvegardé correctement, peut empêcher le démarrage. Une erreur de configuration nomme son fichier — annulez votre dernière modification, ou supprimez-le pour que le mod en crée un nouveau par défaut. Pour les erreurs de monde, restaurez la dernière copie valide depuis l'onglet Backups (voir Comment fonctionnent les sauvegardes).

Le serveur plante plus tard, pas au démarrage

Message : A single server tick took 60.00 seconds (should be max 0.05).

Il s'agit du watchdog de Minecraft qui arrête le serveur car il a gelé pendant une minute entière. Quelque chose demandait trop de ressources — une ferme géante ou une machine en redstone, des milliers d'objets au sol, ou un mod bloqué dans une boucle. Le rapport de crash indique ce qui occupait le serveur. Pourquoi mon serveur Minecraft est-il lent ? couvre les coupables habituels.

La solution : supprimer un fichier

Pour chaque cause mentionnée ci-dessus, la solution suit les mêmes étapes :

1. Assurez-vous que le serveur est arrêté.
2. Ouvrez l'onglet Files et allez dans mods (ou plugins sur Paper et Purpur).
3. Supprimez, ou remplacez par la bonne version, le fichier jar mentionné par l'erreur.
4. Appuyez sur Start et surveillez l'onglet Console jusqu'à ce que vous voyiez la ligne commençant par Done (.

Si l'erreur ne mentionne rien que vous reconnaissez, la page d'assistance liste les moyens de nous contacter. Incluez la première ligne ERROR et la dernière ligne Caused by: — c'est généralement suffisant pour identifier la solution.