Le serveur ne démarre pas
Si la panne suit une mise à jour du pack, commence par là: la cause la plus fréquente est un ancien fichier de mod resté en place, qui charge le même mod deux fois. Le détail est sur Mettre à jour son serveur.
La console se ferme instantanément (Windows)
Java a planté tôt. Lance via run_java21.bat pour garder l'erreur affichée et lire le message.
Java trop ancien ou absent
Le pack embarque son propre Java 21. Relance setup_java21.sh (Linux) ou setup_java21.bat (Windows) pour le réinstaller dans jre21/.
Pas assez de RAM
Si la machine n'a pas la RAM libre demandée, baisse -Xms et -Xmx dans user_jvm_args.txt. Détails sur Configurer la RAM.
Chemins avec accents ou espaces
Installe le serveur dans un chemin simple, sans accents ni espaces (par exemple /opt/mcserver ou C:\mcserver). Un chemin avec caractères spéciaux fait échouer le démarrage.
Les joueurs ne peuvent pas se connecter
Port fermé
Ouvre le port 25565 en TCP au pare-feu ET en redirection de port sur la box. La marche à suivre complète est sur Jouer entre amis.
Mauvaise IP partagée
Amis sur internet: donne ton IP publique. Amis en LAN: donne ton IP locale (ipconfig sous Windows, ip a sous Linux).
Version du modpack
Tous les joueurs doivent utiliser exactement la même version d'Arcadia que le serveur. Une version de modpack différente empêche la connexion.
Si le serveur plante toujours au même endroit ou avec le même joueur, il s'agit sans doute d'un chunk abîmé: la marche à suivre est dans Réparer un monde.
Le serveur lag
RAM ou CPU insuffisants
Le pack recommande 16 Go de RAM et un CPU 4 cœurs et plus. Au-delà de 16 Go de heap, les pauses du garbage collector s'allongent et provoquent des warnings "Can't keep up!": reste sur 16 Go.
Trop de chunks chargés
Baisse view-distance et simulation-distance dans server.properties pour alléger la charge.
Diagnostiquer avec Spark
Le mod Spark est inclus. Tape spark tps pour un aperçu rapide, ou spark profiler start --thread Server --timeout 60 pour profiler et obtenir une URL à analyser. Plus de pistes sur Optimiser son serveur.
Erreurs courantes et où trouver les logs
Crash watchdog / tick bloqué
Un tick a gelé. Lance un profiling Spark au prochain démarrage pour identifier la cause, et vérifie le crash-report généré.
Où sont les logs?
Logs en direct: logs/latest.log, le journal de la session en cours.
Rapports de crash: le dossier crash-reports/, un fichier daté par crash.
Signaler un bug proprement
Pour un bug du modpack, transmets l'URL Spark, l'heure en UTC, ce qui se passait, le crash-report et logs/latest.log. Ouvre un ticket via Signaler un bug. Pour maintenir ton serveur au quotidien, vois Maintenir son serveur.
Avant de chercher une panne
Beaucoup de tickets se règlent avec une commande: la boîte à outils est dans Administrer son serveur.
Le pack demande une machine d'au moins 16 Go de RAM et un processeur de 4 cœurs. Attention à ne pas confondre la mémoire de la machine et celle donnée à Java: sur une machine de 16 Go, il faut en laisser environ 6 au système, donc 10 Go pour le serveur. Le fichier livré avec le pack est réglé sur 16 Go, ce qui suppose une machine de 24 Go ou plus. Monter au dessus de 16 Go de mémoire Java rallonge les pauses de nettoyage sans rien apporter. Le tableau complet est sur Arguments JVM et RAM.
Journal en direct: logs/latest.log, la session en cours.
Journal détaillé: logs/debug.log, beaucoup plus bavard, utile quand le message d'erreur reste vague.
Ces fichiers sont archivés et finissent par disparaître, voir plus bas.
Lire un rapport de crash sans être développeur
Un crash-report fait peur parce qu'il est long, mais on n'a besoin que de trois endroits. Ouvre le fichier le plus récent dans crash-reports/ et cherche dans cet ordre.
Ce qu'on chercheOùCe que ça donne
DescriptionTout en haut, sous l'heureLe moment du plantage: chargement du monde, tick d'un bloc, rendu…
Suspected ModsDans la section System DetailsLe mod que NeoForge accuse. Quand la ligne existe, elle est fiable neuf fois sur dix
La première ligne atJuste sous le message d'erreurLe nom de paquet contient presque toujours l'identifiant du mod fautif
Si la ligne Suspected Mods est absente, la première ligne at suffit: dans at com.simibubi.create…, le coupable est Create. Cherche ensuite ce nom dans la liste des mods pour savoir à quoi il sert avant de le retirer.
Les journaux tournent, pense à les récupérer vite
Le pack est configuré pour ne pas saturer le disque, ce qui a une conséquence: un journal ancien finit par disparaître.
logs/latest.log est réécrit à chaque démarrage. L'ancien est archivé compressé, au format 2026-08-15-1.log.gz, et il est aussi découpé tous les 26 Mo.
Le serveur ne garde que les 10 derniers fichiers de ce type. Sur un serveur qui redémarre souvent, ça peut représenter moins d'une journée.
logs/debug.log est beaucoup plus bavard, découpé tous les 200 Mo, et seules 3 archives sont conservées.
Copie le journal avant de redémarrer
C'est le réflexe qui manque à la moitié des tickets: relancer le serveur pour voir si ça repart écrase latest.log. Copie le fichier ailleurs avant de relancer, avec le crash-report correspondant. Sans ça, la cause est souvent perdue.
Trois pannes qui reviennent tout le temps
Ce que dit le journalCe qui se passeQuoi faire
Un mod est chargé deux fois, ou une version en doubleDeux fichiers du même mod cohabitent dans mods/Vider le dossier et le remettre depuis le pack, voir Mettre à jour son serveur
Une dépendance manquante au démarrageUn mod a été retiré alors qu'un autre en a besoinRemettre le mod, ou retirer aussi celui qui en dépend
Un joueur est éjecté à la connexion pour cause de modsLe client et le serveur n'ont pas la même version du packAligner les deux versions, voir Mettre à jour son serveur
Si rien de tout ça ne colle et que le serveur plante toujours au même endroit du monde, ce n'est pas un mod mais un chunk abîmé: la procédure est sur Réparer un monde corrompu.