FR

Serveurs de jeux

Comment prégénérer un monde Minecraft avec Chunky

Prégénérez votre monde Minecraft avec Chunky sur Paper, puis limitez-le avec une bordure : taille, suivi, reprise après arrêt, retour arrière et dépannage.

7 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Quand des joueurs explorent de nouvelles zones, le serveur doit créer le terrain en pleine partie, ce qui provoque souvent des ralentissements. Chunky génère ce terrain à l'avance. Une bordure empêche ensuite les joueurs de sortir de la zone préparée.

Ce guide prolonge Installer et mettre à jour des plugins sur Paper. Il réutilise le dossier /opt/minecraft/server, le service minecraft.service et la commande mc-console.

À la fin de ce guide, vous aurez :

  • les trois dimensions prégénérées sur la surface choisie
  • une bordure en place dans chaque dimension
  • une méthode pour suivre, interrompre et reprendre la génération

Prérequis

  • Un serveur Paper avec mc-console, installé avec le guide Paper
  • Chunky installé. Ce plugin sert d'exemple dans la section Installer depuis Hangar de ce guide
  • Un accès SSH avec un utilisateur disposant de sudo
  • De l'espace disque libre pour le monde généré et pour une sauvegarde

Vérifiez que Chunky est chargé :

Terminal
sudo mc-console plugins

Choisir la taille

Chunky travaille avec un rayon en blocs, autour d'un centre. La commande worldborder attend au contraire un diamètre, soit deux fois le rayon.

Rayon Bordure (diamètre) Chunks à traiter, environ
1 000 2 000 16 000
2 500 5 000 99 000
5 000 10 000 393 000
10 000 20 000 1 565 000

Commencez petit : vous pourrez agrandir la zone plus tard, et Chunky ignorera les chunks déjà créés. Ce guide prend un rayon de 5000 dans le monde normal, et de 2500 dans le Nether et l'End. Ajustez ces valeurs à votre disque et à votre processeur.

Générez aussi une marge de 200 blocs au-delà de la bordure. Un joueur placé contre elle charge encore les chunks situés derrière, dans la limite de sa distance de rendu : avec view-distance=10, cela représente 160 blocs.

Sauvegarder le serveur

Arrêtez le serveur, contrôlez l'espace disponible et créez une archive :

Terminal
sudo systemctl stop minecraft.service
sudo du -sh /opt/minecraft/server
df -h /opt/minecraft
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-chunky-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups
sudo systemctl start minecraft.service

Attendez que le serveur soit prêt avant de continuer :

Terminal
sudo journalctl -u minecraft.service -f

Quittez le suivi avec Ctrl+C après la ligne Done.

Vérifier le centre et la bordure actuelle

Demandez le point d'apparition du monde normal et l'état de la bordure :

Terminal
sudo mc-console chunky world minecraft:overworld
sudo mc-console chunky spawn
sudo mc-console worldborder get

La deuxième commande affiche Center changed to X, Z. Notez ces valeurs : ce guide écrit 0 0, remplacez-les par les vôtres pour centrer la zone sur le point d'apparition.

Une bordure par défaut mesure 59999968 blocs. Si la vôtre est plus petite que la zone prévue, agrandissez-la avant de générer, pour la raison indiquée plus haut.

Lancer la prégénération

Si possible, lancez la génération sans joueurs connectés, et désactivez temporairement les plugins de carte comme Dynmap ou BlueMap. Réduisez d'abord la fréquence des messages, qui est d'une ligne par seconde par défaut :

Terminal
sudo mc-console chunky quiet 30
sudo mc-console chunky start minecraft:overworld square 0 0 5200

Les arguments sont, dans l'ordre : le monde, la forme, le centre X et Z, puis le rayon. Le journal doit afficher Task started in minecraft:overworld.

Suivez l'avancement :

Terminal
sudo journalctl -u minecraft.service -f | grep --line-buffered Chunky

Chaque ligne indique le nombre de chunks traités, le pourcentage, le temps restant estimé et la vitesse en chunks par seconde. Quittez le suivi avec Ctrl+C : la génération continue. À tout moment, vous pouvez aussi demander l'état :

Terminal
sudo mc-console chunky progress

Surveillez le disque pendant les premiers pourcentages, puis de temps en temps :

Terminal
df -h /opt/minecraft
sudo du -sh /opt/minecraft/server/world

Générer le Nether et l'End

Quand la ligne Task finished for minecraft:overworld apparaît, lancez les autres dimensions, l'une après l'autre :

Terminal
sudo mc-console chunky start minecraft:the_nether square 0 0 2700
Terminal
sudo mc-console chunky start minecraft:the_end square 0 0 2700

Interrompre et reprendre

Action Commande
Mettre en pause et enregistrer l'avancement sudo mc-console chunky pause
Reprendre sudo mc-console chunky continue
Voir la progression sudo mc-console chunky progress
Annuler définitivement sudo mc-console chunky cancel, puis sudo mc-console chunky confirm

Un arrêt normal du serveur enregistre l'avancement, mais la tâche ne repart pas seule. Tapez chunky continue après le redémarrage, ou activez la reprise automatique :

Terminal
sudo -u minecraft sed -i 's/^continue-on-restart: .*/continue-on-restart: true/' /opt/minecraft/server/plugins/Chunky/config.yml
sudo mc-console chunky reload

Annuler une tâche n'efface pas les chunks déjà générés.

Poser la bordure

Quand toutes les tâches sont terminées, placez la bordure. Depuis la console, les commandes s'appliquent au monde normal :

Terminal
sudo mc-console worldborder center 0 0
sudo mc-console worldborder set 10000

Chaque dimension possède sa propre bordure. Passez donc par execute in pour les deux autres :

Terminal
sudo mc-console execute in minecraft:the_nether run worldborder center 0 0
sudo mc-console execute in minecraft:the_nether run worldborder set 5000
sudo mc-console execute in minecraft:the_end run worldborder center 0 0
sudo mc-console execute in minecraft:the_end run worldborder set 5000

Si votre monde possède déjà une bordure, chunky worldborder reprend directement son centre et son rayon pour la tâche suivante. Le module ChunkyBorder permet, lui, des bordures rondes ou d'autres formes.

Vérifier le résultat

Terminal
sudo mc-console chunky progress
sudo mc-console worldborder get
sudo mc-console execute in minecraft:the_nether run worldborder get
sudo mc-console execute in minecraft:the_end run worldborder get
sudo du -sh /opt/minecraft/server/world

Vous devez obtenir No tasks running, puis The world border is currently 10000 block(s) wide pour le monde normal et 5000 pour les deux autres dimensions. Connectez-vous ensuite et approchez-vous de la bordure : le terrain doit s'afficher sans ralentissement, et le journal ne doit pas multiplier les messages Can't keep up!.

Revenir en arrière

Pour retirer une bordure, redonnez-lui sa taille par défaut :

Terminal
sudo mc-console worldborder set 59999968

Pour retrouver le monde tel qu'il était, restaurez l'archive créée au début. Remplacez le nom du fichier par celui affiché par ls :

Terminal
sudo systemctl stop minecraft.service
sudo ls -lh /opt/minecraft/backups
sudo mv /opt/minecraft/server /opt/minecraft/server-echec
sudo tar -xzf /opt/minecraft/backups/avant-chunky-AAAA-MM-JJ-HHMM.tar.gz -C /opt/minecraft
sudo systemctl start minecraft.service

Ce retour efface tout ce qui a été construit depuis la sauvegarde. Si des joueurs ont continué à jouer, vous pouvez plutôt supprimer les chunks hors de la zone avec chunky trim minecraft:overworld square 0 0 5200, puis chunky confirm. Cette suppression est irréversible : faites une nouvelle sauvegarde avant, et redémarrez complètement le serveur après.

En cas de problème

Terminal
sudo journalctl -u minecraft.service -n 200 --no-pager | grep -iE 'chunky|error|exception'

« World minecraft:the_nether not found. Available worlds: … »

Ce monde n'est pas chargé, ou son nom diffère. Utilisez un nom de la liste affichée. Si le Nether ou l'End manque, vérifiez allow-nether dans server.properties et allow-end dans bukkit.yml.

« Task already started for … »

Une tâche tourne déjà dans ce monde. Suivez-la avec chunky progress, ou annulez-la si vous voulez changer de zone.

« A task was already started for this world »

Une tâche interrompue a été enregistrée. Tapez chunky continue pour la reprendre, ou chunky confirm pour la remplacer par la nouvelle.

« No tasks to continue. »

Aucune tâche enregistrée n'existe. La précédente est terminée ou annulée. Vérifiez la surface souhaitée et relancez chunky start : les chunks déjà présents seront ignorés.

La génération est lente ou le serveur rame

  • Le message Can't keep up! est fréquent pendant une génération intensive. Mettez-la en pause quand des joueurs sont connectés
  • La vitesse dépend surtout du processeur, du disque et de la mémoire. Chunky conseille un SSD et au moins 4 Go de mémoire
  • Testez sans les plugins et packs de données non essentiels : certains ralentissent ou bloquent la génération

« OutOfMemoryError: Java heap space »

Le serveur manque de mémoire. Augmentez -Xmx dans la ligne ExecStart de /etc/systemd/system/minecraft.service, sans dépasser la mémoire disponible, puis appliquez le changement et reprenez la tâche :

Terminal
sudo systemctl daemon-reload
sudo systemctl restart minecraft.service

Attendez la ligne Done, puis lancez sudo mc-console chunky continue.

« No space left on device »

Le disque est plein. Arrêtez le serveur, libérez de l'espace, puis contrôlez le monde au redémarrage. Si le journal signale des chunks corrompus, restaurez votre sauvegarde.

Aucun animal dans une zone générée

La zone a été générée alors qu'une bordure ou max-world-size était plus petite. Restaurez la sauvegarde, ou supprimez ces chunks avec chunky trim et générez-les de nouveau avec une bordure assez grande.

Pour aller plus loin, consultez le wiki de Chunky, notamment ses pages Commands et World borders.