Chunky Minecraft : comment prégénérer votre map (Guide complet)

La génération de terrain est l'une des tâches les plus gourmandes pour un serveur Minecraft. Chaque fois qu'un joueur explore une zone inconnue, le serveur doit calculer le relief, les biomes, les grottes, les structures et les minerais en temps réel et depuis la 1.18, la hauteur de génération a doublé, ce qui rend l'opération encore plus lourde.

Le chunky mod résout ce problème en prégénérant la map Minecraft avant que les joueurs ne l'explorent. Fini les freezes à chaque nouvelle zone : le terrain est déjà prêt, le serveur n'a qu'à le charger depuis le disque. C'est l'un des mods de performance les plus recommandés pour tout serveur sérieux.

Ce guide complet couvre l'installation, les commandes, les shapes, les tailles recommandées et les techniques d'optimisation pour prégénérer votre map minecraft efficacement avec Chunky.

Qu'est-ce que Chunky et pourquoi prégénérer ?

Quand un joueur se déplace dans une direction inexplorée, Minecraft génère les chunks à la volée. Chaque chunk fait 16×16 blocs sur toute la hauteur du monde (de -64 à 320 depuis la 1.18). Cette génération mobilise le CPU pendant plusieurs centaines de millisecondes par chunk, ce qui provoque des chutes de TPS et des micro-freezes visibles pour tous les joueurs connectés.

Le chunky mod prégénère ces chunks à l'avance, en dehors des heures de jeu ou avant le lancement du serveur. Une fois la zone générée, les chunks sont stockés sur le disque et chargés quasi instantanément. Le résultat : des TPS stables à 20, même quand dix joueurs explorent dans des directions différentes.

La prégénération est particulièrement utile dans trois situations : au lancement d'un nouveau serveur ou d'une nouvelle saison, après un changement de version Minecraft qui modifie la génération du terrain, et sur les serveurs survie ou aventure où l'exploration est au cœur du gameplay.

Chunky mod (prégénération) vs Chunky render (logiciel 3D)

Attention à ne pas confondre les deux projets qui portent le même nom. Le Chunky mod (aussi appelé Chunky plugin) est un mod/plugin Minecraft qui prégénère les chunks côté serveur. C'est celui dont nous parlons dans ce guide. Il s'installe dans le dossier /mods (Fabric/Forge) ou /plugins (Paper/Spigot) et s'utilise via des commandes en jeu.

Chunky render, en revanche, est un logiciel de rendu 3D indépendant qui permet de créer des images photoréalistes de vos mondes Minecraft. C'est un outil de création graphique, pas un outil de performance serveur. Si vous cherchez à générer des renders de vos constructions, c'est un autre projet entièrement.

Dans ce guide, toutes les commandes et instructions concernent exclusivement le Chunky mod de prégénération.

Chunky mod vs Chunk Pregenerator : quel outil choisir ?

Deux outils de prégénération coexistent dans l'écosystème Minecraft, et ils sont souvent confondus. Le Chunky mod fonctionne sur Fabric, Forge, NeoForge, Paper et Spigot. Il se distingue par sa simplicité : quelques commandes suffisent pour lancer une prégénération circulaire ou carrée. Il est léger, asynchrone et gère automatiquement la pause/reprise.

Chunk Pregenerator est un mod exclusivement Forge/NeoForge (et Fabric via un portage) qui offre des fonctionnalités plus avancées : génération par bordure de monde, tâches nommées, syntaxe différente avec /pregen. Il est particulièrement adapté aux serveurs moddés lourds où la compatibilité Forge est indispensable.

En résumé : Chunky est le choix recommandé pour Paper/Spigot et pour la majorité des cas d'usage grâce à sa simplicité. Chunk Pregenerator est préférable sur les serveurs Forge/NeoForge avec des packs de mods, car il s'intègre mieux à l'écosystème moddé. Les deux font le même travail : prégénérer du terrain. La différence est dans la plateforme et les options avancées.

👉 Guide complet Chunk Pregenerator (Forge/NeoForge)

Installer Chunky sur votre serveur

L'installation du chunky mod varie selon votre plateforme. Pour les serveurs Paper ou Spigot, téléchargez le fichier .jar depuis Modrinth et placez-le dans le dossier /plugins. Pour les serveurs Fabric, le fichier va dans le dossier /mods (Fabric API est requis). Pour Forge et NeoForge, même principe dans le dossier /mods.

Sur OuiPanel, la procédure est simple : accédez au Gestionnaire de fichiers, naviguez dans le dossier /plugins ou /mods selon votre type de serveur, uploadez le fichier .jar de Chunky, puis redémarrez le serveur. Le mod est détecté automatiquement au démarrage.

Après le redémarrage, vérifiez que Chunky est bien chargé en tapant /chunky dans la console ou en jeu. Si la commande retourne la liste des sous-commandes, l'installation est réussie. Assurez-vous également que votre version de Java est à jour (Java 17 minimum pour Minecraft 1.18+, Java 21 recommandé pour 1.21+).

Commandes de base

Avant de lancer la prégénération, vous devez définir trois paramètres : le monde cible, le centre de la zone et le rayon. Voici la séquence complète :

/chunky world <nom_du_monde> — Sélectionne le monde à prégénérer. Par défaut, c'est "world" (l'Overworld). Pour le Nether, utilisez "world_nether" ; pour l'End, "world_the_end".

/chunky center <x> <z> — Définit le centre de la zone de prégénération. Pour centrer sur le spawn, utilisez simplement /chunky spawn.

/chunky radius <blocs> — Définit le rayon en blocs autour du centre. Par exemple, /chunky radius 5000 prégénérera une zone de 10 000 blocs de diamètre.

/chunky start — Lance la prégénération avec les paramètres définis. Chunky affiche alors la progression en pourcentage, le nombre de chunks générés et la vitesse de traitement.

Voici un exemple concret pour prégénérer un cercle de 5 000 blocs autour du spawn :

/chunky world world
/chunky spawn
/chunky radius 5000
/chunky shape circle
/chunky start

La prégénération tourne en arrière-plan sans bloquer le serveur. Les joueurs peuvent continuer à jouer pendant le processus, bien que les performances soient légèrement réduites (c'est pourquoi il est préférable de prégénérer avant le lancement ou en heures creuses).

Pour les serveurs avec plusieurs mondes (Overworld, Nether, End), répétez la séquence pour chaque monde en changeant le paramètre de /chunky world. Les dimensions personnalisées ajoutées par des mods (Twilight Forest, Aether…) sont également supportées — utilisez le nom interne de la dimension tel qu'il apparaît dans votre dossier serveur.

Commandes avancées et patterns

Au-delà des commandes de base, Chunky offre des options avancées pour personnaliser la prégénération selon vos besoins.

Shapes disponibles

La commande /chunky shape <forme> permet de choisir la géométrie de la zone à prégénérer. Les formes disponibles sont les suivantes.

circle — La forme par défaut et la plus recommandée. Elle prégénère un cercle autour du centre, ce qui correspond à la façon naturelle dont les joueurs explorent (dans toutes les directions). Un circle de rayon 5 000 blocs couvre environ 78,5 millions de blocs² et consomme moins d'espace disque qu'un carré équivalent.

square — Prégénère un carré. Utile si votre chunk map correspond à une bordure de monde carrée. Un carré de rayon 5 000 couvre 100 millions de blocs² (environ 27 % de plus qu'un cercle de même rayon).

diamond — Prégénère un losange (carré tourné à 45°). Rarement utilisé, mais peut correspondre à certaines configurations de monde.

rectangle et ellipse — Pour des zones non symétriques. La syntaxe nécessite deux rayons : /chunky radius <x> <z>. Par exemple, /chunky radius 5000 3000 pour un rectangle ou une ellipse de 10 000×6 000 blocs.

pentagon, triangle, star — Formes exotiques rarement utiles en pratique, mais disponibles si votre worldborder a une forme particulière.

Pour la plupart des serveurs, circle est le meilleur choix : il couvre la zone utile sans gaspiller d'espace disque dans les coins.

Commandes de gestion

/chunky pause — Met la prégénération en pause et sauvegarde la progression. Indispensable si vous devez libérer des ressources temporairement (par exemple, un pic de joueurs connectés).

/chunky continue — Reprend la prégénération exactement là où elle s'est arrêtée. Aucune donnée n'est perdue.

/chunky cancel — Annule complètement la tâche en cours. Les chunks déjà générés restent sur le disque, mais la progression est réinitialisée.

/chunky progress — Affiche l'avancement : pourcentage, nombre de chunks traités, vitesse (chunks/seconde) et estimation du temps restant.

/chunky silent — Désactive les messages de progression dans la console. Utile si les logs deviennent trop verbeux pendant une longue prégénération.

/chunky pattern <modèle> — Change l'ordre de génération des chunks. Le modèle par défaut "concentric" (du centre vers l'extérieur) est le plus recommandé, car il priorise les zones les plus fréquentées.

Taille de map : combien prégénérer ?

Le choix du rayon de prégénération dépend de votre type de serveur, du nombre de joueurs et de votre espace disque disponible. Plus le rayon est grand, plus la prégénération prend de temps et d'espace.

Rayon de 1 000 blocs — Zone de 2 000×2 000 blocs. Environ 1 Go d'espace disque. Temps estimé : 5-15 minutes. Adapté aux petits serveurs créatifs ou aux spawns de serveurs mini-jeux. RAM minimale : 4 Go.

Rayon de 3 000 blocs — Zone de 6 000×6 000 blocs, soit environ 9 millions de blocs² en carré. Environ 3-5 Go d'espace disque. Temps estimé : 30-60 minutes. C'est le bon compromis pour un serveur survie de 5-10 joueurs. RAM minimale : 4-6 Go.

Rayon de 5 000 blocs — Zone de 10 000×10 000 blocs. Environ 8-12 Go d'espace disque. Temps estimé : 1-3 heures. Recommandé pour les serveurs survie actifs avec 10-20 joueurs. RAM minimale : 6-8 Go.

Rayon de 10 000 blocs — Zone de 20 000×20 000 blocs. Environ 17-25 Go d'espace disque. Temps estimé : 4-12 heures. Pour les gros serveurs communautaires avec 20+ joueurs réguliers. RAM minimale : 8 Go.

Rayon de 15 000 blocs — Zone de 30 000×30 000 blocs. Environ 35-50 Go d'espace disque. Temps estimé : 12-36 heures. Réservé aux serveurs de grande envergure. RAM minimale : 10 Go.

Rayon de 20 000 blocs — Zone de 40 000×40 000 blocs. Plus de 60 Go d'espace disque. Temps estimé : 24-72 heures. Excessif pour la plupart des serveurs, mais pertinent pour les communautés très actives qui explorent massivement.

Ces estimations varient selon la puissance du CPU, la version de Minecraft et les mods installés. Un serveur moddé génère plus lentement qu'un serveur vanilla ou Paper, car chaque mod peut ajouter du contenu aux chunks (structures, minerais, biomes custom).

Notre recommandation : commencez par un rayon de 3 000-5 000 blocs, puis élargissez si nécessaire. Il est toujours possible de relancer une prégénération avec un rayon plus grand — Chunky ne régénère pas les chunks déjà existants.

N'oubliez pas le Nether : si votre worldborder Overworld est de 5 000 blocs, prégénérez le Nether avec un rayon de 625 blocs (le ratio est de 1:8). Pour l'End, un rayon de 1 000-2 000 blocs autour du spawn suffit généralement.

Optimiser la prégénération

La prégénération est une opération lourde qui peut ralentir votre serveur si elle n'est pas gérée correctement. Voici comment maximiser l'efficacité.

Réglages OuiPanel pour maximiser les performances

Avant de lancer une prégénération importante, ajustez votre serveur pour y consacrer le maximum de ressources.

Allouez suffisamment de RAM. La prégénération est gourmande en mémoire, surtout sur les versions 1.18+ avec la génération de monde étendue. Si votre offre le permet, montez temporairement la RAM allouée de 2 Go supplémentaires pendant la prégénération. Sur OuiPanel, modifiez ce paramètre dans les Paramètres du serveur.

Prégénérez serveur vide. L'idéal est de lancer la prégénération quand aucun joueur n'est connecté. Chunky est conçu pour tourner en arrière-plan, mais il sera significativement plus rapide sans la charge des joueurs, des mobs et des plugins actifs.

Vérifiez votre espace disque. Avant de lancer un rayon de 10 000 blocs, assurez-vous d'avoir au moins 25-30 Go libres. Sur OuiPanel, l'espace disque est visible dans le Dashboard. Si vous êtes limité, prégénérez un rayon plus petit ou passez à une offre avec plus de stockage.

Définissez une worldborder. Configurez une bordure de monde qui correspond à votre rayon de prégénération. Commande vanilla : /worldborder set <diamètre>. Cela empêche les joueurs d'explorer au-delà de la zone prégénérée, ce qui rendrait la prégénération inutile.

Prégénérer en plusieurs étapes

Pour les grandes zones (rayon supérieur à 10 000 blocs), la prégénération peut prendre des dizaines d'heures. Plutôt que de tout lancer d'un coup, procédez par étapes.

Étape 1 : le spawn (rayon 1 000). Prégénérez d'abord la zone immédiate du spawn. C'est la zone la plus fréquentée et celle où les freezes sont les plus visibles. Temps : 5-15 minutes.

Étape 2 : la zone de jeu principale (rayon 5 000). Relancez avec un rayon plus grand. Chunky détecte automatiquement les chunks déjà générés et ne les recalcule pas. Seuls les nouveaux chunks sont traités. Temps : 1-2 heures supplémentaires.

Étape 3 : la zone étendue (rayon 10 000+). Si votre communauté explore activement, élargissez progressivement. Vous pouvez lancer cette étape pendant la nuit avec /chunky start et elle se terminera d'elle-même.

Cette approche par étapes a un avantage concret : elle priorise les zones les plus importantes. Si vous devez ouvrir le serveur rapidement, les joueurs ont déjà une zone de spawn fluide pendant que le reste se génère en arrière-plan.

Astuce avancée : si votre serveur redémarre automatiquement (planification OuiPanel), Chunky peut reprendre automatiquement au redémarrage si vous ajoutez auto-continue: true dans le fichier de configuration config.yml. Cela garantit que la prégénération ne s'arrête pas définitivement après un restart planifié.

En cas de problème : si la prégénération semble bloquée ou anormalement lente, vérifiez trois choses. D'abord, que la RAM allouée n'est pas saturée (un serveur en swap prégénère 10 fois plus lentement). Ensuite, que l'espace disque est suffisant (Chunky s'arrête silencieusement si le disque est plein). Enfin, que d'autres plugins lourds ne monopolisent pas le CPU en parallèle — les plugins de génération de structures custom comme Terra ou Iris (le générateur de terrain, pas le shader) peuvent entrer en conflit avec la prégénération.

Quel hébergement pour prégénérer efficacement ?

La vitesse de prégénération dépend directement de la puissance de votre serveur. Trois facteurs comptent : le CPU (fréquence mono-core élevée), la RAM (4 Go minimum, 6-8 Go pour les gros rayons) et le stockage SSD NVMe (les chunks sont écrits sur le disque en continu pendant la prégénération).

Sur un serveur OuiHeberg, les processeurs tournent à haute fréquence et le stockage est exclusivement NVMe, ce qui permet des vitesses de prégénération optimales. Pour un rayon de 5 000 blocs sur Paper 1.21, comptez environ 1-2 heures sur une offre 6 Go.

👉 Découvrir les offres d'hébergement Minecraft chez OuiHeberg

La prégénération avec le chunky mod est l'une des optimisations les plus impactantes pour un serveur Minecraft. En quelques commandes et quelques heures de patience, vous éliminez définitivement les freezes liés à la génération de terrain et offrez une expérience fluide à vos joueurs dès le premier jour.

Commencez par un rayon raisonnable (3 000-5 000 blocs), définissez une worldborder correspondante, et élargissez au fil du temps. Et si votre serveur est sur Forge avec un pack de mods, pensez à vérifier si Chunk Pregenerator ne serait pas plus adapté à votre configuration.