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.
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 cherche | Où | Ce que ça donne |
|---|---|---|
| Description | Tout en haut, sous l'heure | Le moment du plantage: chargement du monde, tick d'un bloc, rendu… |
| Suspected Mods | Dans la section System Details | Le mod que NeoForge accuse. Quand la ligne existe, elle est fiable neuf fois sur dix |
La première ligne at | Juste sous le message d'erreur | Le nom de paquet contient presque toujours l'identifiant du mod fautif |
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.logest réécrit à chaque démarrage. L'ancien est archivé compressé, au format2026-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.logest beaucoup plus bavard, découpé tous les 200 Mo, et seules 3 archives sont conservées.
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 journal | Ce qui se passe | Quoi faire |
|---|---|---|
| Un mod est chargé deux fois, ou une version en double | Deux 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émarrage | Un mod a été retiré alors qu'un autre en a besoin | Remettre le mod, ou retirer aussi celui qui en dépend |
| Un joueur est éjecté à la connexion pour cause de mods | Le client et le serveur n'ont pas la même version du pack | Aligner 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.
Avant de chercher une panne
Beaucoup de tickets se règlent avec une commande: la boîte à outils est dans Administrer son serveur.