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épannage du serveur.
La procédure, dans l'ordre
- 1Arrête le serveur proprement avec la commande stop. Ne tue jamais le processus tant qu'il écrit encore.
- 2Sauvegarde tout avant de toucher à quoi que ce soit. Une archive du dossier world entier, datée. C'est la seule étape non négociable.
- 3Ouvre 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.
- 4Convertis 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.
- 5Supprime 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.
- 6Supprime le même nom de fichier dans region/, entities/ et poi/. Laisser une moitié désynchronisée est une cause classique de nouveau plantage.
- 7Relance 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 Arcadia et Lancer et configurer son serveur. Le réglage mémoire est expliqué dans Les arguments JVM et la RAM, le diagnostic de lag dans Optimiser et diagnostiquer son serveur, et les pannes courantes dans Dépannage du serveur. Si tu joues avec des amis sur ce serveur, Jouer entre amis couvre l'ouverture du port et la liste blanche.