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.
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é :
sudo mc-console pluginsChoisir 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 :
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.serviceAttendez que le serveur soit prêt avant de continuer :
sudo journalctl -u minecraft.service -fQuittez 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 :
sudo mc-console chunky world minecraft:overworld
sudo mc-console chunky spawn
sudo mc-console worldborder getLa 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 :
sudo mc-console chunky quiet 30
sudo mc-console chunky start minecraft:overworld square 0 0 5200Les 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 :
sudo journalctl -u minecraft.service -f | grep --line-buffered ChunkyChaque 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 :
sudo mc-console chunky progressSurveillez le disque pendant les premiers pourcentages, puis de temps en temps :
df -h /opt/minecraft
sudo du -sh /opt/minecraft/server/worldGé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 :
sudo mc-console chunky start minecraft:the_nether square 0 0 2700sudo mc-console chunky start minecraft:the_end square 0 0 2700Interrompre 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 :
sudo -u minecraft sed -i 's/^continue-on-restart: .*/continue-on-restart: true/' /opt/minecraft/server/plugins/Chunky/config.yml
sudo mc-console chunky reloadAnnuler 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 :
sudo mc-console worldborder center 0 0
sudo mc-console worldborder set 10000Chaque dimension possède sa propre bordure. Passez donc par execute in pour les deux autres :
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 5000Si 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
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/worldVous 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 :
sudo mc-console worldborder set 59999968Pour 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 :
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.serviceCe 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
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 :
sudo systemctl daemon-reload
sudo systemctl restart minecraft.serviceAttendez 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.