Aller au contenu

Wiki

Révision #473

Enregistrée le 15 août 2026 à 0:32

Auteur: vyrriox Type: Édition « Harmonisation des titres du wiki (schema unique). »
Cette révision #473

Dépanner son serveur

Le serveur ne démarre pas

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.

Version actuelle

Dépanner son serveur

Le serveur ne démarre pas

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.