Chunky : prégénération de chunks Minecraft
DOG&DEV · 25/01/2025
Containers & Docker
Testing
Chunky : prégénération de chunks Minecraft
Chunky est un plugin (Paper, Spigot) qui prégénère les chunks du monde : au lieu de les générer à la volée quand les joueurs explorent (ce qui cause du lag et des saccades), les chunks sont générés à l’avance en arrière-plan. Ce guide décrit l’installation, les commandes de base (/chunk radius, /chunk continue) et les bonnes pratiques (rayon, priorité).
Prérequis
- Paper ou Spigot (Chunky est optimisé pour Paper)
- Accès au dossier plugins/
- Monde normal, nether ou end à prégénérer
Installation
- Télécharger Chunky depuis Modrinth, Hangar (Paper) ou SpigotMC.
- Placer Chunky.jar dans plugins/.
- Redémarrer le serveur. La config est dans plugins/Chunky/config.yml.
Commandes de base
- /chunk radius <rayon> : définit le rayon de prégénération (en chunks) depuis le point de spawn ou un centre défini.
Ex./chunk radius 500: carré de 1000×1000 chunks (16 000×16 000 blocs environ). - /chunk center [x] [z] : définit le centre (coordonnées en blocs). Sans argument : centre sur le joueur.
- /chunk start : lance la prégénération avec le rayon et le centre actuels.
- /chunk pause : met en pause la tâche.
- /chunk continue : reprend une tâche en pause.
- /chunk cancel : annule la tâche en cours.
- /chunk progress : affiche l’avancement (chunks faits, reste, vitesse, temps estimé).
- /chunk world <monde> : choisit le monde (world, world_nether, world_the_end, ou nom personnalisé).
Exemple de workflow
- Se placer au spawn (ou au centre souhaité).
/chunk center(optionnel si vous êtes au bon endroit)./chunk radius 1000(par ex. pour une map 32 000×32 000 blocs)./chunk world world(si vous avez plusieurs mondes)./chunk start.
La prégénération tourne en arrière-plan. /chunk progress pour suivre. Vous pouvez pause / continue si vous voulez limiter l’impact sur les joueurs.
Configuration (config.yml)
- max-concurrent : nombre de chunks générés en parallèle. Plus = plus rapide, mais plus de CPU/RAM.
- target-ms-per-tick : temps max par tick pour Chunky. Réduire si la prégénération provoque du TPS lag.
- continue-on-restart : si
true, Chunky reprend la tâche après un redémarrage du serveur (très pratique pour les grands rayons).
Exemple (extraits) :
max-concurrent: 2
target-ms-per-tick: 5
continue-on-restart: true
Rayon et priorité
- Rayon 500 : ~16k×16k blocs — déjà lourd ; prévoir plusieurs heures selon le CPU.
- Rayon 1000 et plus : très long. Utiliser continue-on-restart et lancer en période de faible activité.
- Priorité : Chunky limite son impact via target-ms-per-tick ; en cas de lag, réduire max-concurrent ou target-ms-per-tick.
Dépannage
| Symptôme | Cause possible | Correctif |
|---|---|---|
| TPS en baisse pendant la prégénération | max-concurrent trop élevé, target-ms-per-tick trop grand | Réduire max-concurrent ; diminuer target-ms-per-tick ; /chunk pause pendant les heures de pointe |
| Tâche perdue au redémarrage | continue-on-restart: false | Mettre continue-on-restart: true et redémarrer ; la tâche reprend |
| « No chunk task » | Aucune tâche démarrée ou déjà terminée | /chunk start avec radius et center définis |
Bonnes pratiques
- Sauvegarder le monde avant de lancer une grosse prégénération.
- Pour les très grands rayons : lancer la nuit ou en maintenance, avec continue-on-restart: true.
- Combiner avec une limite de vue raisonnable (
view-distance,simulation-distance) : mods-minecraft. Pour les texture packs : texturepack-server.
Ressources
Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.