Le pack sort de nouvelles versions régulièrement. Mettre son serveur à jour n'est pas compliqué, mais une seule erreur suffit à empêcher le démarrage ou à faire disparaître des réglages. Cette page explique quoi remplacer, quoi garder, et pourquoi la méthode qui paraît la plus prudente est justement la plus dangereuse.

Ce que l'archive contient, et ce qu'elle ne contient pas

Bonne nouvelle avant tout: l'archive du serveur ne contient aucune donnée de jeu. Ni monde, ni joueurs, ni réglages de serveur. Tout cela est créé au premier lancement et n'est jamais écrasé par une mise à jour.

La règle d'or: remplacer, jamais fusionner

Pour donner une idée de l'ampleur, entre deux versions séparées de quelques semaines, 14 fichiers de mods ont disparu et 18 sont apparus. Plusieurs correspondaient au même mod à une version différente: une bibliothèque partagée passée de v2.13.38 à v2.13.41, une autre de v21.1.39 à v21.1.52. Fusionner aurait chargé les deux à chaque fois.

La bonne méthode est donc de supprimer entièrement les dossiers concernés avant de déposer les nouveaux.

Ce qu'on supprime et remplace

Ce qu'on garde absolument

• Le dossier du monde et toutes les dimensions. C'est ta partie, rien dans l'archive ne le touche.
• server.properties, sinon tu perds le nom du serveur, le port, la difficulté et la distance d'affichage.
• ops.json, whitelist.json et les listes de bannis, sinon tu perds tes droits d'administrateur et ta modération.
• eula.txt, déjà accepté.

Le cas du dossier config

config est le seul dossier où il faut réfléchir. Il contient à la fois les réglages livrés avec le pack et ceux que tu as pu ajuster toi même.

• Si tu n'as rien modifié, remplace le dossier entier, c'est le plus sûr.
• Si tu as modifié des fichiers, note lesquels avant de remplacer, puis réapplique tes changements après. Garder l'ancien dossier entier fait rater les nouveaux réglages des mods ajoutés.

Attention au changement de NeoForge

La version de NeoForge ne change pas à chaque mise à jour du pack, mais elle change parfois. Sur une période récente, elle est passée de 21.1.221 à 21.1.232 entre deux versions du pack.

Quand c'est le cas, libraries, l'installeur et unix_args.txt doivent être remplacés ensemble. Un mélange entre l'ancien et le nouveau donne une erreur au démarrage, avant même le chargement des mods.

La procédure complète

1. 1
   Arrête le serveur proprement et attends qu'il ait fini de sauvegarder.
2. 2
   Fais une sauvegarde complète du dossier, monde compris. C'est la seule étape non négociable.
3. 3
   Note ton allocation de RAM et la liste des fichiers de config que tu as modifiés.
4. 4
   Supprime mods, libraries, kubejs, l'installeur NeoForge et unix_args.txt.
5. 5
   Décompresse la nouvelle archive dans le dossier du serveur.
6. 6
   Réapplique ta RAM et tes réglages, puis relance et surveille le démarrage.

Si le serveur ne démarre plus

Dans tous les cas, le journal de démarrage nomme le mod fautif. La lecture des journaux et les autres pannes courantes sont traitées sur Dépanner son serveur.

Où continuer

Pour l'installation initiale, va voir Installer son serveur, et pour l'entretien courant Maintenir son serveur. Les réglages de démarrage sont détaillés sur Arguments JVM et RAM, et les recettes que tu retrouveras dans kubejs sont expliquées sur Comprendre KubeJS.

Prérequis

Avant de te lancer, vérifie que ta machine tient la charge. Le modpack Arcadia est lourd et demande des ressources sérieuses pour tourner correctement.

• RAM: 16 Go au total recommandés (10 Go minimum absolu).
• CPU: 4 cœurs ou plus.
• Disque: environ 5 Go libres (le pack plus la croissance du monde).
• Réseau: port 25565 en TCP ouvert au firewall et au routeur pour le multijoueur.
• OS: Windows 10 (build 17063+, avril 2018) ou 11, ou tout Linux moderne (Debian 11+, Ubuntu 20.04+, RHEL 8+, Arch) en x86_64 ou aarch64.

Télécharger et extraire le pack

Récupère le serverpack officiel puis extrais-le dans un dossier propre. Le chemin où tu extrais le pack est important.

Sous Windows, clic droit sur le fichier zip puis Extraire tout. Sous Linux:

sudo mkdir -p /opt/mcserver
sudo chown $USER:$USER /opt/mcserver
cd /opt/mcserver
unzip /chemin/vers/serverpack.zip

Installation en 1 clic

Le pack embarque un installateur automatique qui gère tout d'un coup: téléchargement de Java, acceptation de l'EULA et premier démarrage.

1. 1 Windows: double-clic sur INSTALL.bat, puis appuie sur Entrée. Linux: chmod +x INSTALL.sh setup_java21.sh run.sh puis ./INSTALL.sh.
2. 2 Le script télécharge Java 21 (environ 50 Mo) dans le dossier jre21/.
3. 3 Tape y quand on te demande d'accepter l'EULA de Mojang. Le fichier eula.txt est créé automatiquement pour toi.
4. 4 Tape y pour lancer le serveur tout de suite, ou n pour le lancer plus tard via run.bat ou run.sh.

Premier démarrage

Le premier lancement est le plus long. Le modpack charge des centaines de mods et génère les fichiers de configuration, dont server.properties. Compte entre 3 et 10 minutes selon ta machine.

Une fois l'installation terminée, tu n'auras plus jamais à repasser par INSTALL: les lancements suivants se font directement via run.bat ou run.sh. La suite est détaillée dans Lancer et configurer son serveur. Pour optimiser les performances ou diagnostiquer des lags, vois Optimiser son serveur. Si tu veux comprendre la structure des fichiers, consulte Fichiers du modpack.

Pas envie de gérer une machine? WabbaNode s'en occupe

Faire tourner Arcadia chez soi demande une machine allumée en permanence, 16 Go de RAM et un port ouvert sur ta box. Si tu préfères éviter tout ça, WabbaNode, l'hébergeur partenaire du serveur, propose une infrastructure taillée pour les gros modpacks: déploiement rapide, ressources dimensionnées pour un pack de 441 mods et support dédié. Le pack tourne alors 24 heures sur 24 sans que ton PC ait à rester allumé.

Si tu héberges quand même chez toi, la suite de ce guide reste valable de bout en bout: les réglages mémoire sont dans Arguments JVM et RAM, et l'ouverture du port dans Jouer entre amis.

Démarrer le serveur

Une fois que INSTALL a été exécuté une première fois, tu lances le serveur normalement à chaque session, sans repasser par l'installateur.

• Windows: double-clic sur run.bat.
• Linux: ./run.sh.

Le serveur est prêt quand la console affiche Done (...)! For help, type "help".

Configurer server.properties

Le premier démarrage crée le fichier server.properties. Ouvre-le avec n'importe quel éditeur de texte pour personnaliser ton serveur. Voici les réglages clés:

• server-port: le port de connexion (25565 par défaut).
• motd: le nom ou message affiché dans la liste des serveurs Minecraft.
• max-players: le nombre maximum de joueurs.
• difficulty: peaceful, easy, normal ou hard.
• pvp: true ou false pour activer ou couper le combat entre joueurs.
• white-list: mets true pour n'autoriser que les comptes que tu ajoutes.
• online-mode: true = comptes Minecraft officiels seulement.
• view-distance et simulation-distance: nombre de chunks rendus et simulés côté serveur.

Ajuster la RAM

Le fichier complet et le rôle de chaque option sont détaillés dans Arguments JVM et RAM.

Par défaut le serveur utilise un heap de 16 Go. Pour changer cette valeur, édite le fichier user_jvm_args.txt et modifie les deux lignes:

-Xms16384M
-Xmx16384M

Le -Xmx fixe le maximum. Combien allouer selon ta RAM système?

• 16 Go de RAM: alloue 10 Go (par exemple -Xmx10240M).
• 24 Go de RAM: reste sur 16 Go, le défaut.
• 32 Go ou plus: garde 16 Go quand même, en donner plus dégrade les performances.

Arrêter proprement le serveur

Ne coupe jamais le serveur en fermant brutalement la fenêtre.

Pour un arrêt correct, tape simplement dans la console du serveur:

stop

Le serveur sauvegarde tout puis se ferme. C'est aussi la commande à lancer avant de faire une sauvegarde du monde.

Besoin d'aller plus loin? Vois Optimiser son serveur, ou reviens à Installer son serveur. Pour ajouter des scripts, consulte KubeJS et pour l'aspect économie Économie sur serveur privé. Le détail sur la RAM est dans Allouer de la RAM.

Les arguments JVM, ce sont les options passées à Java au démarrage du serveur. Sur un pack de plus de quatre cents mods comme Arcadia, ils font la différence entre un serveur qui tient vingt joueurs et un serveur qui se fige toutes les trente secondes. Bonne nouvelle: le serverpack arrive déjà réglé. Cette page t'explique ce que fait chaque ligne, et surtout ce qu'il ne faut pas toucher.

Où vivent les arguments

Tout se trouve dans le fichier user_jvm_args.txt, à la racine du serveur. Les scripts de lancement le passent à Java avec la syntaxe @user_jvm_args.txt, puis ajoutent les arguments propres à NeoForge. Concrètement, tu n'as jamais besoin de taper une longue commande java à la main: tu édites ce fichier avec un éditeur de texte, tu relances, c'est tout.

La RAM, la seule chose que tu dois vraiment régler

Deux lignes commandent la mémoire:

• -Xms définit la mémoire allouée au démarrage.
• -Xmx définit la mémoire maximale.

Sur un serveur Minecraft, ces deux valeurs doivent être identiques. Java réserve alors tout d'un coup et ne passe pas son temps à agrandir puis rétrécir son tas, ce qui provoque des à coups. Le pack est livré avec 16 384 Mo sur les deux lignes.

Le ramasse miettes et les flags Aikar

Le reste du fichier configure G1GC, le ramasse miettes de Java. Les valeurs viennent des flags Aikar, la référence dans le monde des serveurs Minecraft. Voici ce que font les principales:

Deux lignes concernent le Metaspace, la zone où Java range les classes: -XX:MetaspaceSize=256M et -XX:MaxMetaspaceSize=1024M. Avec plus de quatre cents mods, il faut de la marge, sinon Java passe son temps à redimensionner cette zone. Enfin, -Dlog4j2.configurationFile=log4j2.xml impose la configuration de journalisation fournie avec le pack, et -Dusing.aikars.flags sert uniquement de marqueur pour les outils de supervision.

La variante GraalVM

Le pack fournit un second fichier, user_jvm_args_graalvm.txt, à n'utiliser que si tu as installé Oracle GraalVM 21. Il reprend les mêmes réglages mémoire et G1GC, puis ajoute le compilateur maison de GraalVM avec -XX:+EnableJVMCI, -XX:+UseJVMCICompiler et -XX:+EagerJVMCI, plus des options de compilation comme la vectorisation SIMD et le déroulage partiel de boucles. On y trouve aussi -XX:+UseTransparentHugePages, qui demande de grandes pages mémoire au système, et -XX:+EnableDynamicAgentLoading, nécessaire à certains profileurs.

Les erreurs qu'on voit tout le temps

• Xms et Xmx différents. C'est l'erreur classique. Mets les deux à la même valeur.
• Allouer toute la RAM de la machine. Le système d'exploitation a besoin de mémoire pour le cache disque, qui accélère justement le chargement des chunks.
• Doubler les arguments. Si ton hébergeur passe déjà un -Xmx dans sa commande de démarrage, ne le remets pas dans le fichier: la dernière valeur gagne et tu ne sais plus laquelle s'applique.
• Copier des flags trouvés au hasard. Beaucoup de listes qui circulent sont écrites pour Java 8 et cassent sous Java 21. Les options de l'ancien ramasse miettes CMS, par exemple, n'existent plus.
• Se tromper de Java. Le pack tourne sous Java 21. Une version plus ancienne refuse simplement de charger NeoForge.

Vérifier que tes réglages sont bien pris

Le pack embarque déjà plusieurs mods qui allègent le serveur sans réglage de ta part: ModernFix accélère le démarrage et réduit la mémoire, FerriteCore compresse les données de blocs, Lithium optimise la logique du jeu. Tes arguments JVM viennent en complément de ces mods, pas à leur place.

Au démarrage, le script affiche la version de Java avant de lancer le serveur: tu dois y voir Temurin 21 ou GraalVM 21 selon ton choix. Ensuite, en jeu ou en console, la commande spark health te donne la mémoire réellement utilisée, l'activité du ramasse miettes et les TPS. Si le tas monte au plafond puis redescend en permanence avec des pauses longues, c'est que ton allocation est trop juste pour le nombre de joueurs et de chunks chargés.

Où continuer

Pour l'installation depuis zéro, suis Installer son serveur, puis Lancer et configurer son serveur pour le fichier server.properties. Le diagnostic des lags et l'usage de Spark sont détaillés dans Optimiser son serveur, et la mise en service permanente dans Maintenir son serveur. Si ton monde donne des signes de corruption, va voir Réparer un monde. Enfin, côté joueur, la RAM du client se règle dans Allouer de la RAM, ce qui n'a rien à voir avec le serveur.

Ouvrir le port 25565

Pour que des amis qui ne sont pas sur ton réseau te rejoignent, ton serveur doit être joignable depuis internet. Minecraft écoute sur le port 25565 en TCP par défaut (celui défini dans server.properties). Deux réglages sont à faire.

Trouver ton IP

L'adresse à partager dépend de l'emplacement de tes amis.

• Amis hors de ton réseau (internet): partage ton IP publique. Tu la trouves en cherchant "mon IP" sur un moteur de recherche.
• Amis sur le même réseau (LAN): partage ton IP locale. Sous Windows, tape ipconfig; sous Linux, ip a (une adresse en 192.168.x.x ou 10.x.x.x).

Alternatives sans ouvrir de port

Si tu ne peux pas (ou ne veux pas) toucher à ta box, plusieurs solutions évitent la redirection de port.

• Service de tunnel comme playit.gg: il te fournit une adresse publique qui redirige vers ton serveur, sans configuration de box.
• Réseau virtuel (VPN) type Hamachi: tes amis rejoignent un réseau privé et se connectent via une IP locale.
• Hébergeur dédié: tu déposes le serverpack chez un hébergeur Minecraft qui gère la connexion et l'uptime à ta place.

La whitelist

La whitelist (liste blanche) est ta meilleure protection: seuls les pseudos autorisés peuvent rejoindre. Depuis la console du serveur:

whitelist on
whitelist add Pseudo
whitelist add AutrePseudo

Tu peux aussi forcer la liste blanche dans server.properties:

white-list=true
enforce-whitelist=true

Pour la mise en route du service et les sauvegardes, vois Maintenir son serveur. En cas de souci de connexion, consulte le Dépanner son serveur. Le lancement de base est détaillé sur Lancer et configurer son serveur.

Une fois ton serveur en ligne, il faut le tenir: donner des droits, gérer les protections, surveiller la charge et intervenir quand un joueur a un souci. Le pack embarque déjà tout le nécessaire, encore faut il savoir ce qui est là. Voici les outils disponibles et les commandes qui servent vraiment.

Donner des droits

• Les niveaux d'opérateur vanilla restent la base: /op et /deop depuis la console. Le niveau 2 suffit pour la plupart des outils du pack, notamment pour contourner les zones protégées.
• LuckPerms est installé. Il permet de créer des grades avec des permissions précises plutôt que de donner l'opérateur complet à quelqu'un. C'est la bonne solution dès que tu as plus d'un modérateur.
• La liste blanche se gère avec /whitelist on, /whitelist add et /whitelist reload. C'est la protection la plus simple contre les visiteurs indésirables.

Les commandes déjà activées

FTB Essentials fournit 32 commandes, toutes actives sur le pack. Elles se répartissent en trois familles.

Les protections de terrain

Les claims du pack ont des règles précises, utiles à connaître avant de répondre à un joueur:

Surveiller et diagnostiquer

1. 1
   Spark pour mesurer: spark health pour un état rapide, spark profiler start quand ça rame. Le détail est dans Optimiser son serveur.
2. 2
   Chunky pour pré générer le monde à froid, serveur vide, plutôt que de laisser les joueurs générer en jouant.
3. 3
   Les journaux: logs/latest.log pour le contexte, crash-reports/ pour les plantages.
4. 4
   Les sauvegardes, testées au moins une fois, comme expliqué dans Maintenir son serveur.

Intervenir sans casser le monde

• Arrête toujours proprement avec stop. Un arrêt brutal pendant une sauvegarde est la première cause de chunk corrompu, voir Réparer un monde corrompu.
• Évite de retirer un mod en cours de partie. Les blocs qu'il a posés deviennent illisibles et la zone plante au chargement.
• Modifie les recettes par script plutôt qu'en changeant les mods, avec KubeJS, voir Comprendre KubeJS.
• Sauvegarde avant de terrasser. Le pack embarque WorldEdit, dont l'historique ne conserve que cinq annulations: une copie du monde vaut mieux qu'un //undo qui n'existe plus.
• Note tes changements. Quand un problème apparaît une semaine plus tard, savoir ce que tu as modifié fait gagner des heures.

Répondre aux joueurs

Les trois questions qui reviennent le plus souvent ont des réponses simples:

• Une action refusée quelque part: c'est une zone protégée, la liste des règles est dans Les zones protégées.
• Un objet impossible à fabriquer: il est probablement dans Les objets bannis.
• Un stuff perdu à la mort: le cadavre tient deux heures et n'est ouvrable que par son propriétaire, voir Récupérer ses objets après la mort.

Où continuer

L'installation est couverte par Installer son serveur, la configuration par Lancer et configurer son serveur, et la mémoire par Arguments JVM et RAM. En cas de panne, la marche à suivre est sur Dépanner son serveur.

Faire tourner le serveur en continu

Pour que le serveur reste en ligne même après avoir fermé ta session, ne le lance pas dans une simple fenêtre. Utilise un service ou un multiplexeur de terminal.

Sous Linux, la méthode propre est un service systemd. Crée /etc/systemd/system/mcserver.service:

[Unit]
Description=Modded Minecraft Server
After=network.target

[Service]
Type=simple
User=mcserver
Group=mcserver
WorkingDirectory=/opt/mcserver
ExecStart=/usr/bin/tmux new -d -s mcserver '/opt/mcserver/run.sh'
ExecStop=/usr/bin/tmux send-keys -t mcserver "stop" Enter
Restart=on-failure
RestartSec=10
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

Puis active-le:

sudo systemctl daemon-reload
sudo systemctl enable --now mcserver
sudo -u mcserver tmux attach -t mcserver

Sous Windows, tu peux installer le serveur en service avec NSSM (nssm.cc) en pointant l'application vers run.bat et le dossier de démarrage sur le dossier du serveur, ou simplement le garder ouvert via une tâche planifiée.

Sauvegarder ton monde

Ton monde vit dans le dossier world. C'est la seule chose vraiment irremplaçable: le pack, lui, se retélécharge. Sauvegarde-le régulièrement.

• Copie l'intégralité du dossier world vers un autre disque ou un stockage externe.
• Garde plusieurs versions datées, pas une seule qui s'écrase.
• Automatise via une tâche planifiée (Windows) ou un cron (Linux) pour ne pas oublier.

Une sauvegarde sert surtout le jour où un chunk casse: garde Réparer un monde sous la main, et teste au moins une restauration avant d'en avoir besoin.

Mettre à jour le pack Arcadia

Quand une nouvelle version du serverpack sort, tu retélécharges le pack mais tu conserves ta progression. La procédure détaillée, avec la liste précise de ce qu'il faut supprimer et de ce qu'il faut garder, est sur Mettre à jour son serveur.

Avant une grosse modification du monde

Terrasser une zone entière, coller une structure, régénérer un secteur: toutes ces opérations passent par WorldEdit, et son historique ne remonte que cinq commandes en arrière. Fais ta sauvegarde avant, jamais après.

Gérer la console

Les commandes s'entrent directement dans la console du serveur, sans slash. Les plus utiles:

• op Pseudo: donne les droits d'administrateur à un joueur.
• ban Pseudo et pardon Pseudo: bannit ou débannit.
• kick Pseudo: expulse un joueur de la session.
• stop: arrête proprement le serveur (jamais Ctrl+C ni le bouton X, corruption garantie).

Au quotidien

Droits, commandes disponibles et réponses aux questions fréquentes des joueurs sont regroupés dans Administrer son serveur.

Choix de la JVM

Le pack utilise Eclipse Temurin JRE 21 par défaut: libre, stable, open-source, déjà embarqué dans jre21/ et actif via user_jvm_args.txt. C'est le meilleur choix pour 99 % des cas et la compatibilité maximale avec les mods.

Pour plus de performances sur un gros serveur, tu peux passer à Oracle GraalVM 21: 5 à 15 % plus rapide sur les contraptions Create grâce à la vectorisation SIMD et au compilateur JVMCI. En contrepartie, c'est un téléchargement d'environ 300 Mo, une install manuelle et une licence Oracle.

1. 1 Télécharge Oracle GraalVM 21 sur graalvm.org/downloads (Java 21, ta plateforme).
2. 2 Extrais le dossier à côté du dossier serveur et renomme-le en graalvm21 (les scripts de lancement détectent ce nom automatiquement).
3. 3 Active les flags GraalVM. Windows: ren user_jvm_args.txt user_jvm_args_temurin.txt puis ren user_jvm_args_graalvm.txt user_jvm_args.txt. Linux: mêmes commandes avec mv.

Le détail de chaque argument passé à Java, ligne par ligne, est expliqué dans Arguments JVM et RAM.

Diagnostiquer les lags avec Spark

Spark est un mod de profiling déjà inclus dans le modpack. Il identifie précisément la cause des baisses de TPS, des freezes ou des crashes watchdog. Les commandes se tapent dans la console serveur, sans slash au début:

• spark health: check rapide de santé (TPS, CPU, RAM, GC).
• spark profiler start --thread Server --timeout 60: profile le thread serveur pendant 60 s puis affiche une URL cliquable à transmettre à l'admin.
• spark profiler start --thread * --timeout 30: profile tous les threads, idéal pour repérer un deadlock quand le serveur freeze.
• spark tps: TPS et durée de tick courants.

Réduire le lag

Deux mods s'en chargent déjà en partie: ServerCore abaisse tout seul la distance de simulation et le plafond de monstres quand la charge monte, et Chunky permet de générer le monde à l'avance pour éviter le pire coût d'un serveur moddé. Les deux sont détaillés sur Chunky et ServerCore.

Si le serveur affiche des warnings Can't keep up!, c'est qu'il est surchargé. Plusieurs leviers dans server.properties:

• Baisse la simulation-distance: c'est le rayon de chunks réellement simulés, souvent le plus gros gain.
• Baisse la view-distance pour alléger le chunk loading côté serveur.
• Réduis le nombre de mobs et d'entités actives (fermes trop grosses, animaux en masse).

Lance un spark profiler pour identifier ce qui coûte le plus avant de tout baisser à l'aveugle.

Alléger les mods gourmands

Avant de chercher plus loin, sache que le pack embarque ArcadiaTweaks, un mod maison qui retire du travail inutile à Botany Pots, Refined Storage et Mekanism. Ses trois modules se désactivent séparément, ce qui aide à isoler l'origine d'une baisse de performance.

Que faire en cas de crash

Un crash n'est jamais silencieux: le serveur laisse des traces à analyser.

• Regarde le dossier crash-reports/: le fichier le plus récent contient la cause exacte du crash.
• Consulte latest.log dans le dossier logs/ pour le contexte juste avant le plantage.
• En cas de crash watchdog (tick bloqué), relance avec un profiling spark profiler start --thread * --timeout 30 la prochaine fois pour capter le deadlock.

Pour transmettre un bug proprement, garde sous la main l'URL Spark, l'heure en UTC, le crash report et le latest.log. Reviens aux étapes de base dans Installer son serveur et Lancer et configurer son serveur. Si le souci vient d'un lag audio côté client, vois Corriger le lag audio.

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.

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).

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.

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.

Avant de chercher une panne

Beaucoup de tickets se règlent avec une commande: la boîte à outils est dans Administrer son serveur.

Un monde Minecraft n'est pas un gros fichier unique: c'est une mosaïque de petits fichiers, et il suffit qu'un seul soit tronqué pour que le serveur plante en boucle. La bonne nouvelle, c'est qu'un monde corrompu se répare presque toujours sans tout perdre. Cette page explique comment il est rangé, comment repérer la zone fautive et comment la retirer proprement.

Comment un monde est rangé sur le disque

Dans le dossier de ton serveur, tout part de world/. Trois sous dossiers comptent vraiment:

• region/ contient les blocs, sous forme de fichiers r.X.Z.mca.
• entities/ contient les entités, mobs et objets au sol, dans des fichiers portant le même nom.
• poi/ contient les points d'intérêt, essentiellement les blocs de métier des villageois.

Chaque fichier de région couvre 32 chunks sur 32, soit une zone de 512 blocs sur 512. Pour retrouver le fichier qui correspond à une position, divise la coordonnée du bloc par 512 et arrondis vers le bas. Un point situé en X 1700 et Z 300 vit donc dans r.3.0.mca, parce que 1700 divisé par 512 donne 3 et des poussières, et 300 divisé par 512 donne 0.

Reconnaître une vraie corruption

Les symptômes typiques:

• Le serveur démarre puis plante dès qu'un joueur se connecte, toujours le même joueur.
• Le serveur plante dès qu'on s'approche d'une zone précise, et seulement de celle là.
• La console répète des erreurs de lecture ou d'écriture de chunk pendant la sauvegarde.
• Le monde tourne, mais une zone reste en trous noirs et ne se charge jamais.

Si le serveur plante partout et tout le temps, ce n'est probablement pas le monde: regarde d'abord les rapports de plantage, comme expliqué dans Dépanner son serveur.

La procédure, dans l'ordre

1. 1
   Arrête le serveur proprement avec la commande stop. Ne tue jamais le processus tant qu'il écrit encore.
2. 2
   Sauvegarde tout avant de toucher à quoi que ce soit. Une archive du dossier world entier, datée. C'est la seule étape non négociable.
3. 3
   Ouvre le dernier fichier du dossier crash-reports/ et cherche les coordonnées ou le nom de fichier de région cités dans le détail de l'erreur. Le fichier logs/latest.log donne le contexte juste avant.
4. 4
   Convertis les coordonnées en nom de fichier avec la division par 512 vue plus haut, ou laisse un éditeur de région le faire pour toi.
5. 5
   Supprime le strict minimum. L'outil MCA Selector permet de supprimer quelques chunks au lieu de toute une région. Si la zone est en pleine nature, sans construction, supprimer le fichier .mca entier va aussi vite.
6. 6
   Supprime le même nom de fichier dans region/, entities/ et poi/. Laisser une moitié désynchronisée est une cause classique de nouveau plantage.
7. 7
   Relance et va voir sur place. Les chunks supprimés se régénèrent depuis la graine du monde. Le terrain revient, les constructions non.

Le cas du joueur qui fait planter le serveur

Quand c'est toujours le même joueur qui déclenche le crash, le problème est souvent dans son fichier de données, dans world/playerdata/, ou dans le chunk où il s'est déconnecté. Deux approches: déplacer son fichier .dat hors du dossier pour qu'il réapparaisse au spawn avec un inventaire vide, ou nettoyer le chunk de sa position. La première fait perdre l'inventaire, la seconde fait perdre la zone. Fais toujours une copie du fichier avant, on peut le remettre.

La cause numéro un: retirer un mod

Sur un serveur privé qui bidouille sa liste de mods, la corruption vient rarement du disque. Elle vient du fait qu'on a retiré un mod alors que ses blocs étaient encore posés dans le monde. Au chargement, le jeu trouve des identifiants qu'il ne connaît plus et refuse la zone.

• Avant de retirer un mod, casse et récupère ses blocs, ou au minimum sache où ils sont.
• Si le mal est fait, remets le mod le temps de nettoyer la zone, puis retire le proprement.
• Sur Arcadia, la liste des mods est figée par le pack, donc ce cas ne concerne que ton serveur privé. Si tu modifies les recettes, passe plutôt par les scripts décrits dans KubeJS: c'est quoi, comment ça marche, qui ne touchent pas au monde.

Éviter la corruption plutôt que la réparer

• Arrêt propre systématique. La commande stop, puis on attend que le processus se termine. Un arrêt brutal pendant une sauvegarde est la première cause de fichier tronqué.
• Surveille l'espace disque. Un disque plein pendant l'écriture produit exactement le même résultat qu'une coupure de courant.
• Sauvegardes automatiques et testées: une sauvegarde qu'on n'a jamais restaurée n'est pas une sauvegarde. La mise en place est détaillée dans Maintenir son serveur.
• Pré-génère ton monde avec Chunky, déjà inclus dans le pack. Générer les chunks à froid, serveur vide, évite les pics de charge quand les joueurs explorent, et donc les sauvegardes qui traînent.
• Ne copie jamais un monde en cours d'exécution. Arrête le serveur, ou utilise une commande de sauvegarde prévue pour ça.

Où continuer

Pour la mise en place initiale, va voir Installer son serveur et Lancer et configurer son serveur. Le réglage mémoire est expliqué dans Arguments JVM et RAM, le diagnostic de lag dans Optimiser son serveur, et les pannes courantes dans Dépanner son serveur. Si tu joues avec des amis sur ce serveur, Jouer entre amis couvre l'ouverture du port et la liste blanche.

WorldEdit est l'outil qui permet de modifier des milliers de blocs d'un seul coup: terrasser, remplacer, copier, coller, générer des formes. Il est présent dans le pack Arcadia, réservé aux opérateurs, et il est livré avec deux compléments que peu de gens remarquent. Voici comment il est réglé et comment s'en servir sans casser son monde.

La baguette n'est pas une hache en bois

Les réglages du serveur

Les blocs interdits

La configuration bloque une longue liste de blocs, qu'aucune commande ne peut poser en masse. On y trouve:

• La TNT, le feu et la bedrock, pour des raisons évidentes.
• Tous les lits et toutes les pousses d'arbre.
• Les rails, normaux, alimentés et détecteurs.
• Toute la redstone posable: fil, torches, répéteurs, comparateurs, boutons, leviers.
• Les cultures, les torches, les cactus, la canne à sucre, les champignons et les fleurs.

Ce sont des blocs à état ou à entité de bloc, qui plantent ou se cassent quand on les pose par milliers. Le blocage évite un monde corrompu, sujet traité sur Réparer un monde corrompu.

Les commandes qui servent vraiment

Les pinceaux et les schematics

• Les pinceaux se lient à un objet en main et posent des formes à distance. Le rayon est plafonné à 6, ce qui reste largement suffisant pour du terrain.
• Les schematics se sauvegardent et se rechargent depuis un dossier dédié du serveur. C'est le moyen propre de transporter une construction d'un monde à l'autre.
• L'aperçu de sélection est activé côté serveur: tu vois ta zone surlignée sans avoir besoin d'un mod client.

Un correctif embarqué qu'on oublie

Le pack ajoute un petit mod nommé worldedit-hang-fix. Son rôle tient en une phrase: empêcher WorldEdit de bloquer l'arrêt du serveur. Sans lui, une opération lourde encore en cours au moment d'un stop peut laisser le processus suspendu, et un serveur qui ne s'arrête pas proprement est la première cause de monde abîmé.

Si tu montes ton propre serveur avec ce pack, garde ce mod. C'est deux cents kilo octets qui évitent une catégorie entière de problèmes, détaillée sur Dépanner son serveur.

Bonnes pratiques sur un serveur en production

1. 1
   Sauvegarde d'abord. Cinq annulations ne remplacent pas une copie du monde.
2. 2
   Travaille serveur vide pour les grosses opérations. Une commande sur un million de blocs fait chuter le nombre de ticks pour tout le monde.
3. 3
   Découpe en morceaux. Plusieurs commandes moyennes passent mieux qu'une énorme, et restent annulables.
4. 4
   Active la journalisation si plusieurs personnes ont accès à l'outil. Elle est coupée par défaut, donc rien n'est tracé.
5. 5
   Vérifie l'impact après coup avec les outils de mesure décrits sur Optimiser son serveur.

Où continuer

Pour monter ton serveur, commence par Installer son serveur puis Lancer et configurer son serveur. La gestion au quotidien est sur Administrer son serveur, la mémoire sur Arguments JVM et RAM, et les modifications de recettes sur Comprendre KubeJS.

// Priority: 100 ← Ordre de chargement (optionnel)

ServerEvents.recipes(event => { // ← Hook: event "recipes"

 // 1) On retire d'abord
 event.remove({ output: 'minecraft:diamond_sword' });

 // 2) On rajoute ensuite (avec un id explicite)
 event.shaped('minecraft:diamond_sword', [
 ' D ',
 ' D ',
 ' S '
 ], {
 D: 'minecraft:diamond',
 S: 'minecraft:stick'
 }).id('arcadia:custom_diamond_sword');
});

grep -r "arcadia:vote_key" kubejs/
// ou sous Windows avec ripgrep:
rg "arcadia:vote_key" kubejs/

ServerEvents.recipes(event => {
 event.remove({ output: 'minecraft:diamond_sword' });

 /* DÉSACTIVÉ TEMPORAIREMENT, 11/05/2026, test PvP
 event.shaped('minecraft:netherite_sword', [...], {...}).id('arcadia:custom_netherite_sword');
 */
});

mob_damage_nerfs.js ← chargé
mob_damage_nerfs.js.disabled ← ignoré (mais conservé)

{
 "replace": false,
 "values": [],
 "remove": [
 "arcadia:adept_helmet",
 "arcadia:heretic_chestplate"
 ]
}

// Pour augmenter le HP du Wither de 500 à 800:
'minecraft:wither': { health: 800, damage: 12, armor: 15 },

ServerEvents.recipes(event => {
 event.shaped('5x minecraft:bread', [
 'WWW',
 ' S ',
 ' '
 ], {
 W: 'minecraft:wheat',
 S: 'minecraft:stick'
 }).id('arcadia:bread_bonus');
});

StartupEvents.registry('item', event => {
 event.create('arcadia:mon_item').displayName('Mon Item').rarity('rare').maxStackSize(16);
});

"item.arcadia.mon_item": "Mon Item"

Pour aller plus loin

Pour voir ce que ces scripts changent concrètement sur Arcadia, lis Les recettes modifiées. Si tu montes ton propre serveur avec le pack, commence par Installer son serveur, puis Lancer et configurer son serveur et Optimiser son serveur.